REST Resource: accounts.conversionSources

Ressource: ConversionSource

Représente une source de conversion appartenant à un compte marchand. Un compte marchand peut comporter 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 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

enum (State)

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

expireTime

string (Timestamp format)

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

controller

enum (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 :
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 qui reçoivent des données d'attribution préalable.

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 non ordonnée. Liste des différents types de conversion auxquels un événement de conversion peut être classé. Un type d'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

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

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.

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

currencyCode

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.

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

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

Méthodes

create

Crée une source de conversion.

delete

Archive une source de conversion existante.

get

Récupère 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.