REST Resource: accounts.conversionSources

Ressource: ConversionSource

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

Représentation JSON
{
  "name": string,
  "state": enum (State),
  "expireTime": string,
  "controller": enum (Controller),

  // Union field source_data can be only one of the following:
  "googleAnalyticsLink": {
    object (GoogleAnalyticsLink)
  },
  "merchantCenterDestination": {
    object (MerchantCenterDestination)
  }
  // End of list of possible types for union field source_data.
}
Champs
name

string

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

enum (State)

Uniquement en sortie. État actuel de cette source de conversion. Ce paramètre ne peut pas être modifié via l'API.

expireTime

string (Timestamp format)

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

controller

enum (Controller)

Uniquement en sortie. Contrôleur de la source de conversion.

Champ d'union source_data. Obligatoire. Données de source de conversion spécifiques à chaque type de source. source_data ne peut être qu'un des éléments suivants :
merchantCenterDestination

object (MerchantCenterDestination)

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

AttributionSettings

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

Représentation JSON
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
Champs
attributionLookbackWindowDays

integer

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

attributionModel

enum (AttributionModel)

Obligatoire. Modèle d'attribution.

conversionType[]

object (ConversionType)

Immuable. Liste à puces. Liste des différents types de conversion selon lesquels un événement de conversion peut être classé. Un "achat" standard est créé automatiquement 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 proposé par Google Analytics 4, comme décrit sur cette 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 cross-canal basé sur les données.
CROSS_CHANNEL_FIRST_CLICK Modèle basé sur le premier clic cross-canal.
CROSS_CHANNEL_LINEAR Modèle "Linéaire multicanal".
CROSS_CHANNEL_POSITION_BASED Modèle cross-canal basé sur la position.
CROSS_CHANNEL_TIME_DECAY Modèle de dépréciation dans le temps cross-canal.

ConversionType

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

Représentation JSON
{
  "name": string,
  "report": boolean
}
Champs
name

string

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

report

boolean

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

MerchantCenterDestination

"Destination Merchant Center" Les sources permettent d'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.

Représentation JSON
{
  "destination": string,
  "attributionSettings": {
    object (AttributionSettings)
  },
  "displayName": string,
  "currencyCode": string
}
Champs
destination

string

Uniquement en sortie. ID de destination Merchant Center.

attributionSettings

object (AttributionSettings)

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

displayName

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'UI Merchant Center. 64 caractères maximum.

currencyCode

string

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

É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 fonctionnelle. Il peut être restauré à l'aide de la méthode d'annulation de la suppression.
PENDING La création de la source de conversion a commencé, mais n'est pas encore complètement terminée.

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 YT.

Méthodes

create

Crée une source de conversion.

delete

Permet d'archiver une source de conversion existante.

get

Extrait une source de conversion.

list

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

patch

Met à jour les informations d'une source de conversion existante.

undelete

Réactive une source de conversion archivée.