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é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

enum (State)

Uniquement en sortie. État actuel de cette source de conversion. Ils ne peuvent pas être modifiés 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 sur les sources de conversion propres à 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. le modèle d'attribution.

conversionType[]

object (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

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

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. Ne doit pas dépasser 64 caractères.

currencyCode

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.

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

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.

Méthodes

create

crée une source de conversion ;

delete

Permet d'archiver 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.