La ressource de conversion dispose de méthodes permettant aux utilisateurs de créer, de modifier et de récupérer des conversions Floodlight de manière groupée.
La liste des méthodes associées à cette ressource est présentée au bas de la page.
Représentations de la ressource
Liste des conversions.
{
"kind": "doubleclicksearch#conversionList",
"conversion": [
{
"agencyId": long,
"advertiserId": long,
"engineAccountId": long,
"campaignId": long,
"customerId": string,
"adGroupId": long,
"criterionId": long,
"adId": long,
"clickId": string,
"dsConversionId": long,
"conversionId": string,
"state": string,
"type": string,
"revenueMicros": long,
"currencyCode": string,
"quantityMillis": long,
"segmentationType": string,
"segmentationId": long,
"segmentationName": string,
"conversionTimestamp": unsigned long,
"conversionModifiedTimestamp": unsigned long,
"floodlightOrderId": string,
"customMetric": [
{
"name": string,
"value": double
}
],
"customDimension": [
{
"name": string,
"value": string
}
],
"countMillis": long,
"attributionModel": string,
"productGroupId": long,
"inventoryAccountId": long,
"productId": string,
"productCountry": string,
"productLanguage": string,
"channel": string,
"storeId": string,
"deviceType": string,
"adUserDataConsent": string,
"sessionAttributesEncoded": bytes
}
]
}| Nom de propriété | Valeur | Description | Remarques |
|---|---|---|---|
conversion[] |
list |
Les conversions demandées. | |
conversion[].adGroupId |
long |
ID du groupe d'annonces DS. | |
conversion[].adId |
long |
ID de l'annonce DS. | |
conversion[].adUserDataConsent |
string |
Représente le consentement des utilisateurs pour les préférences concernant les services de plate-forme essentiels dans les paramètres. Aucune valeur par défaut. Les valeurs acceptées sont les suivantes: GRANTED: cet état indique que l'utilisateur souhaite donner son consentement. Lire les préférences CPS à partir des paramètres GTE REFUSÉ: l'état de consentement souhaité est "refuser" ; la liste des services de plate-forme essentiels est vide.
Les valeurs acceptées sont les suivantes :
|
|
conversion[].advertiserId |
long |
Référence annonceur DS. | |
conversion[].agencyId |
long |
ID de l'agence DS. | |
conversion[].attributionModel |
string |
Disponible uniquement pour les annonceurs après avoir contacté le service client DoubleClick Search. | |
conversion[].campaignId |
long |
ID de la campagne DS. | |
conversion[].channel |
string |
Canal de vente du produit. Les valeurs acceptées sont les suivantes:
|
|
conversion[].clickId |
string |
ID de clic DS de la conversion. | |
conversion[].conversionId |
string |
Pour les conversions hors connexion, cet identifiant est fourni par les annonceurs. Les annonceurs peuvent spécifier n'importe quel identifiant qui leur convient. Chaque conversion d'une requête doit spécifier un ID unique, et la combinaison de l'ID et du code temporel doit être unique pour toutes les conversions de l'annonceur. Pour les conversions en ligne, DS copie le dsConversionId ou le floodlightOrderId dans cette propriété en fonction des instructions Floodlight de l'annonceur. |
|
conversion[].conversionModifiedTimestamp |
unsigned long |
Heure à laquelle la conversion a été modifiée pour la dernière fois, exprimée en millisecondes d'epoch UTC. | |
conversion[].conversionTimestamp |
unsigned long |
Heure à laquelle la conversion a eu lieu, en millisecondes d'epoch UTC. | |
conversion[].countMillis |
long |
Disponible uniquement pour les annonceurs après avoir contacté le service client DoubleClick Search. | |
conversion[].criterionId |
long |
ID du critère (mot clé) DS. | |
conversion[].currencyCode |
string |
Code de devise correspondant aux revenus de la conversion. Doit être au format alphabétique ISO 4217 (trois caractères). | accessible en écriture |
conversion[].customDimension[] |
list |
Dimensions personnalisées pour la conversion, qui peuvent être utilisées pour filtrer les données d'un rapport. | |
conversion[].customDimension[].name |
string |
Nom de la dimension personnalisée. | |
conversion[].customDimension[].value |
string |
Valeur de la dimension personnalisée. | |
conversion[].customMetric[] |
list |
Métriques personnalisées pour la conversion. | |
conversion[].customMetric[].name |
string |
Nom de la métrique personnalisée. | |
conversion[].customMetric[].value |
double |
Valeur numérique de la métrique personnalisée. | |
conversion[].customerId |
string |
Nouveau numéro client Search Ads 360. Doit obligatoirement être un compte client. Lorsque ce champ est défini, tous les autres champs d'ID doivent être définis sur de nouveaux ID Search Ads 360. | |
conversion[].deviceType |
string |
Type d'appareil sur lequel la conversion a eu lieu.
Les valeurs acceptées sont les suivantes :
|
|
conversion[].dsConversionId |
long |
ID généré par DoubleClick Search pour chaque conversion. | |
conversion[].engineAccountId |
long |
ID du compte du moteur DS. | |
conversion[].floodlightOrderId |
string |
ID de commande Floodlight fourni par l'annonceur pour la conversion. | |
conversion[].inventoryAccountId |
long |
ID généré et utilisé par DS pour identifier de manière unique le compte d'inventaire contenant le produit. | |
conversion[].productCountry |
string |
Pays enregistré pour le flux Merchant Center contenant le produit. Indiquez un code pays ISO 3166. | |
conversion[].productGroupId |
long |
ID de groupe de produits DS. | |
conversion[].productId |
string |
Code produit (SKU). | |
conversion[].productLanguage |
string |
Langue enregistrée pour le flux Merchant Center contenant le produit. Utilisez un code ISO 639 pour spécifier une langue. | |
conversion[].quantityMillis |
long |
Quantité de cette conversion, en millisecondes. | accessible en écriture |
conversion[].revenueMicros |
long |
Montant des revenus générés par cette conversion TRANSACTION, en micros (valeur multipliée par 1 000 000, sans décimale). Par exemple, pour spécifier une valeur de revenus de "10", saisissez "10000000" (10 millions) dans votre requête. |
accessible en écriture |
conversion[].segmentationId |
long |
Identifiant de segmentation numérique (par exemple, l'ID de l'activité Floodlight DoubleClick Search). | |
conversion[].segmentationName |
string |
Identifiant de segmentation convivial (par exemple, nom de l'activité Floodlight DoubleClick Search). | |
conversion[].segmentationType |
string |
Type de segmentation de cette conversion (par exemple, FLOODLIGHT).
Valeurs acceptées :
|
|
conversion[].sessionAttributesEncoded |
bytes |
Attributs de session de l'événement, représentés sous la forme d'une chaîne JSON encodée en base64. Le contenu doit être généré par la bibliothèque fournie par Google. | |
conversion[].state |
string |
État de la conversion (ACTIVE ou REMOVED). Remarque: L'état DELETED est obsolète.
Les valeurs acceptées sont les suivantes :
|
accessible en écriture |
conversion[].storeId |
string |
ID du magasin local pour lequel le produit a été annoncé. Ne s'applique que lorsque le canal est "local". |
|
conversion[].type |
string |
Type de la conversion (ACTION ou TRANSACTION). Une conversion ACTION est une action de l'utilisateur qui n'a pas de valeur quantifiable en termes monétaires, tandis qu'une conversion TRANSACTION est une action qui a une valeur quantifiable en termes monétaires. Par exemple, les inscriptions à une liste de diffusion (ACTION) par rapport aux achats d'e-commerce (TRANSACTION).
Valeurs acceptées :
|
|
kind |
string |
Indique qu'il s'agit d'une ressource ConversionList. Valeur: chaîne fixe doubleclicksearch#conversionList. |
Méthodes
- get
- Récupère la liste des conversions d'un compte de moteur DoubleClick Search.
- getByCustomerId
- Récupère une liste de conversions à partir d'un compte de moteur DoubleClick Search à l'aide d'un nouvel ID client Search Ads 360.
- insérer
- Insère un lot de nouvelles conversions dans DoubleClick Search.
- update
- Met à jour un lot de conversions dans DoubleClick Search.
- updateAvailability
- Met à jour les disponibilités d'un lot d'activités Floodlight dans DoubleClick Search.