Package google.shopping.merchant.conversions.v1beta

Index

ConversionSourcesService

Service permettant de gérer les sources de conversion d'un compte marchand.

CreateConversionSource

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

Crée une source de conversion.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez OAuth 2.0 Overview.
DeleteConversionSource

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)

Archive une source de conversion existante. Si la source de conversion est une destination Merchant Center, elle pourra être récupérée pendant 30 jours. Si la source de conversion est une association Google Analytics, elle sera supprimée immédiatement et pourra être restaurée en en créant une autre.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez OAuth 2.0 Overview.
GetConversionSource

rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource)

Récupère une source de conversion.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez OAuth 2.0 Overview.
ListConversionSources

rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)

Récupère la liste des sources de conversion auxquelles l'appelant a accès.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez OAuth 2.0 Overview.
UndeleteConversionSource

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

Réactive une source de conversion archivée. Disponible uniquement pour les sources de conversion de destination Merchant Center.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez OAuth 2.0 Overview.
UpdateConversionSource

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

Met à jour les informations d'une source de conversion existante. Disponible uniquement pour les sources de conversion de destination Merchant Center.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez OAuth 2.0 Overview.

AttributionSettings

Représente les paramètres d'attribution pour les sources de conversion qui reçoivent des données d'attribution préalable.

Champs
attribution_lookback_window_days

int32

Obligatoire. Périodes d'analyse (en jours) utilisées pour l'attribution dans cette source. Les valeurs acceptées sont : 7, 30 et 40.
attribution_model

AttributionModel
conversion_type[]

ConversionType

Immuable. Liste non ordonnée. Liste des différents types de conversion auxquels un événement de conversion peut être classé. Un type "purchase" (Achat) standard est automatiquement créé si cette liste est vide au moment de la création.

AttributionModel

Modèle d'attribution utilisé pour cette source. Nous acceptons le même ensemble de modèles proposés par Google Analytics 4, comme décrit sur la page https://support.google.com/analytics/answer/10596866.

Enums
ATTRIBUTION_MODEL_UNSPECIFIED Modèle non spécifié.
CROSS_CHANNEL_LAST_CLICK Modèle basé sur le dernier clic cross-canal
ADS_PREFERRED_LAST_CLICK Modèle basé sur le dernier clic Ads de préférence
CROSS_CHANNEL_DATA_DRIVEN Modèle basé sur les données multicanaux
CROSS_CHANNEL_FIRST_CLICK Modèle multicanal basé sur le premier clic
CROSS_CHANNEL_LINEAR Modèle linéaire multicanal
CROSS_CHANNEL_POSITION_BASED Modèle multicanal basé sur la position
CROSS_CHANNEL_TIME_DECAY Modèle multicanal avec dépréciation dans le temps

ConversionType

Message représentant un type d'événement de conversion

Champs
name

string

Uniquement en sortie. Nom de l'événement de conversion, tel qu'il sera indiqué par le client.
report

bool

Uniquement en sortie. Option indiquant si le type doit être inclus dans les rapports Merchant Center.

ConversionSource

Représente une source de conversion appartenant à un compte marchand. Un compte marchand peut comporter jusqu'à 200 sources de conversion.

Champs
name

string

Uniquement en sortie. Identifiant. Généré par l'API Content lors de la création d'un ConversionSource. Format: [a-z]{4}:.+ Les quatre caractères avant le deux-points représentent le type de source de conversion. Le contenu qui suit le signe deux-points représente l'ID de la source de conversion de ce type. L'ID de deux sources de conversion différentes peut être le même pour différents types. Les préfixes de type suivants sont acceptés: - galk: pour les sources GoogleAnalyticsLink. - mcdn: pour les sources MerchantCenterDestination.
state

State

Uniquement en sortie. État actuel de cette source de conversion. Ne peut pas être modifié via l'API.
expire_time

Timestamp

Uniquement en sortie. Date à laquelle une source de conversion archivée est définitivement supprimée et ne peut plus être rétablie.
controller

Controller

Uniquement en sortie. Contrôleur de la source de conversion.
Champ d'union source_data. Obligatoire. Données sur la source de conversion spécifiques à chaque type de source. source_data ne peut être qu'un des éléments suivants :
merchant_center_destination

MerchantCenterDestination

Source de conversion de type "Destination de la balise Merchant Center".

Contrôleur

Entité contrôlant la source de conversion.

Enums
CONTROLLER_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
MERCHANT Contrôle par le marchand propriétaire de la source de conversion.
YOUTUBE_AFFILIATES Contrôle par le programme d'affiliation YouTube

État

Représente l'état de la source de conversion.

Enums
STATE_UNSPECIFIED L'état de la source de conversion n'est pas spécifié.
ACTIVE La source de conversion est entièrement fonctionnelle.
ARCHIVED La source de conversion a été archivée au cours des 30 derniers jours et n'est actuellement pas opérationnelle. Peut être restauré à l'aide de la méthode de restauration.
PENDING La création de la source de conversion a commencé, mais n'est pas encore terminée.

CreateConversionSourceRequest

Message de requête pour la méthode CreateConversionSource.

Champs
parent

string

Obligatoire. Compte marchand qui sera propriétaire de la nouvelle source de conversion. Format: accounts/{account}
conversion_source

ConversionSource

Obligatoire. Description de la source de conversion. Un nouvel ID lui sera automatiquement attribué lors de sa création.

DeleteConversionSourceRequest

Message de requête pour la méthode DeleteConversionSource.

Champs
name

string

Obligatoire. Nom de la source de conversion à supprimer. Format: accounts/{account}/conversionSources/{conversion_source}

GetConversionSourceRequest

Message de requête pour la méthode GetConversionSource.

Champs
name

string

Obligatoire. Nom de la source de conversion à extraire. Format: accounts/{account}/conversionSources/{conversion_source}

ListConversionSourcesRequest

Message de requête pour la méthode ListConversionSources.

Champs
parent

string

Obligatoire. Compte marchand propriétaire de la collection de sources de conversion. Format: accounts/{account}
page_size

int32

Facultatif. Nombre maximal de sources de conversion à renvoyer sur une page. Si aucun page_size n'est spécifié, 100 est utilisé comme valeur par défaut. La valeur maximale est 200. Les valeurs supérieures à 200 seront réduites à 200. Quelle que soit la pagination, un maximum de 200 sources de conversion sont renvoyées au total.
page_token

string

Facultatif. Jeton de la page.
show_deleted

bool

Facultatif. Afficher l'option "Supprimés (archivés)".

ListConversionSourcesResponse

Message de réponse pour la méthode ListConversionSources.

Champs
conversion_sources[]

ConversionSource

Liste des sources de conversion.
next_page_token

string

Jeton à utiliser pour extraire la page de résultats suivante.

MerchantCenterDestination

Les sources "Destination Merchant Center" permettent d'envoyer des événements de conversion d'une boutique en ligne à l'aide d'une balise Google directement vers un compte Merchant Center dans lequel la source est créée.

Champs
destination

string

Uniquement en sortie. ID de destination Merchant Center.
attribution_settings

AttributionSettings

Obligatoire. Paramètres d'attribution utilisés pour la destination Merchant Center.
display_name

string

Obligatoire. Nom à afficher spécifié par le marchand pour la destination. Il s'agit du nom qui identifie la source de conversion dans l'interface utilisateur de Merchant Center. 64 caractères maximum.
currency_code

string

Obligatoire. Code de devise à trois lettres (ISO 4217). Le code de devise définit la devise dans laquelle les conversions envoyées à cette destination seront enregistrées dans Merchant Center.

UndeleteConversionSourceRequest

Message de requête pour la méthode UndeleteConversionSource.

Champs
name

string

Obligatoire. Nom de la source de conversion à restaurer. Format: accounts/{account}/conversionSources/{conversion_source}

UpdateConversionSourceRequest

Message de requête pour la méthode UpdateConversionSource.

Champs
conversion_source

ConversionSource

Obligatoire. Nouvelle version des données de la source de conversion. Format: accounts/{account}/conversionSources/{conversion_source}
update_mask

FieldMask

Facultatif. Liste des champs mis à jour.