Package google.shopping.merchant.conversions.v1beta

Index

ConversionSourcesService

Service de gestion des sources de conversion pour 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 la présentation d'OAuth 2.0.
DeleteConversionSource

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)

Permet d'archiver une source de conversion existante. Si la source de conversion est une Destination Merchant Center, vous pourrez la récupérer pendant 30 jours. Si la source de conversion est une association à Google Analytics, elle sera immédiatement supprimée et pourra être restaurée 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 la présentation d'OAuth 2.0.
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 la présentation d'OAuth 2.0.
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 la présentation d'OAuth 2.0.
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 la présentation d'OAuth 2.0.
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 la présentation d'OAuth 2.0.

AttributionSettings

Représente les paramètres d'attribution pour les sources de conversion recevant des données de pré-attribution.

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

Obligatoire. le modèle d'attribution.
conversion_type[]

ConversionType

Immuable. Liste à puces. Liste des différents types de conversions auxquels un événement de conversion peut être classé. Un type "purchase" standard sera 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 que celui fourni par Google Analytics 4, comme décrit dans 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 multicanal.
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 cross-canal.
CROSS_CHANNEL_FIRST_CLICK Modèle "Premier clic multicanal"
CROSS_CHANNEL_LINEAR Modèle linéaire multicanal.
CROSS_CHANNEL_POSITION_BASED Modèle basé sur la position cross-canal.
CROSS_CHANNEL_TIME_DECAY Modèle avec dépréciation dans le temps multicanal.

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 avoir jusqu'à 200 sources de conversion.

Champs
name

string

Uniquement en sortie. Identifiant. Générées par Content API lors de la création d'un ConversionSource. Format: [a-z]{4}:.+ Les quatre caractères placés avant les deux-points représentent le type de source de conversion. Le contenu après les deux-points représente l'ID de la source de conversion dans ce type. L'identifiant 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. Ils ne peuvent pas être modifiés via l'API.
expire_time

Timestamp

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

Controller

Uniquement en sortie. Contrôleur de la source de conversion.
Champ d'union source_data. Obligatoire. Données sur les sources de conversion propres à 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ôlées par le marchand propriétaire de la source de conversion.
YOUTUBE_AFFILIATES Contrôlées 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 pas fonctionnelle pour le moment. peuvent être restaurées à l'aide de la méthode "undelete".
PENDING La création de la source de conversion a commencé, mais n'est pas encore complètement 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 à récupérer. Format: accounts/{account}/conversionsources/{conversion_source}

ListConversionSourcesRequest

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

Champs
parent

string

Obligatoire. Compte marchand qui possède la collection des sources de conversion. Format: accounts/{account}
page_size

int32

Facultatif. Nombre maximal de sources de conversion à afficher 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 forcées en 200. Quelle que soit la pagination, un maximum de 200 sources de conversion est renvoyé au total.
page_token

string

Facultatif. Jeton de la page.
show_deleted

bool

Facultatif. Afficher l'option supprimée (archivée).

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 prochaine page de résultats.

MerchantCenterDestination

Les sources "Destination Merchant Center" peuvent être utilisées pour envoyer les événements de conversion d'une boutique en ligne à l'aide d'une balise Google directement à 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. Ne doit pas dépasser 64 caractères.
currency_code

string

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

UndeleteConversionSourceRequest

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

Champs
name

string

Obligatoire. Nom de la source de conversion dont vous souhaitez annuler la suppression. 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 sur les sources de conversion. Format: accounts/{account}/conversionSources/{conversion_source}
update_mask

FieldMask

Obligatoire. Liste des champs en cours de mise à jour.