La ressource de conversion comporte des méthodes permettant aux utilisateurs de créer, modifier et 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 de 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 } ] }
Nom de propriété | Valeur | Description | Remarques |
---|---|---|---|
conversion[] |
list |
Conversions demandées. | |
conversion[].adGroupId |
long |
ID du groupe d'annonces DS. | |
conversion[].adId |
long |
ID d'annonce DS. | |
conversion[].adUserDataConsent |
string |
Représente le consentement pour les préférences des services de plates-formes principaux (CPS) dans les paramètres. Aucune valeur par défaut. Valeurs acceptées : "GRANTED" (ACCORDÉ) : l'état de consentement souhaité est "accord". Lire les préférences CPS à partir des paramètres GTE "DENIED" (REFUSÉ) : l'état de consentement souhaité est "deny". La liste des CPS est vide. | |
conversion[].advertiserId |
long |
Référence annonceur DS. | |
conversion[].agencyId |
long |
ID d'agence DS. | |
conversion[].attributionModel |
string |
Disponible pour les annonceurs uniquement après avoir contacté le service client DoubleClick Search. | |
conversion[].campaignId |
long |
ID de campagne DS. | |
conversion[].channel |
string |
Canal de vente du produit. Les valeurs acceptées sont:
|
|
conversion[].clickId |
string |
ID de clic DS pour la conversion. | |
conversion[].conversionId |
string |
Pour les conversions hors connexion, les annonceurs fournissent cet ID. Les annonceurs peuvent spécifier n'importe quel ID qui les intéresse. Dans une demande, chaque conversion doit comporter un identifiant unique. La combinaison de cet identifiant et de cet horodatage doit être unique parmi toutes les conversions de l'annonceur. Pour les conversions en ligne, DS copie l'élément dsConversionId ou 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, en millisecondes UTC. | |
conversion[].conversionTimestamp |
unsigned long |
Heure à laquelle la conversion a eu lieu, en epoch (millisecondes UTC). | |
conversion[].countMillis |
long |
Disponible pour les annonceurs uniquement 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 des revenus associés à 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. Il doit s'agir d'un compte client. Lorsque ce champ est défini, tous les autres champs d'ID doivent être définis sur les ID de la nouvelle interface 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 de compte de moteur DS. | |
conversion[].floodlightOrderId |
string |
ID de commande Floodlight fourni par l'annonceur pour la conversion. | |
conversion[].inventoryAccountId |
long |
ID que DS génère et utilise pour identifier de façon unique le compte d'inventaire qui contient le produit. | |
conversion[].productCountry |
string |
Pays enregistré pour le flux Merchant Center contenant le produit. Utilisez un code ISO 3166 pour spécifier un pays. | |
conversion[].productGroupId |
long |
ID du groupe de produits DS. | |
conversion[].productId |
string |
ID 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 millièmes. | accessible en écriture |
conversion[].revenueMicros |
long |
Montant des revenus de cette conversion TRANSACTION , en micros (valeur multipliée par 1 000 000, sans décimale). Par exemple, pour spécifier une valeur de revenu de "10", saisissez "10000000" (10 millions) dans votre demande. |
accessible en écriture |
conversion[].segmentationId |
long |
Identifiant de segmentation numérique (par exemple, ID d'activité Floodlight DoubleClick Search). | |
conversion[].segmentationName |
string |
Identifiant de segmentation convivial (par exemple, le nom de l'activité Floodlight DoubleClick Search). | |
conversion[].segmentationType |
string |
Type de segmentation de cette conversion (par exemple, FLOODLIGHT ).
Les valeurs acceptées sont les suivantes :
|
|
conversion[].state |
string |
État de la conversion, à savoir ACTIVE ou REMOVED . Remarque: L'état DELETED est obsolète.
Les valeurs acceptées sont les suivantes :
|
accessible en écriture |
conversion[].storeId |
string |
Identifiant du magasin pour lequel le produit a fait l'objet d'une promotion. Applicable uniquement si la chaîne est "local ". |
|
conversion[].type |
string |
Type de la conversion, à savoir ACTION ou TRANSACTION . Une conversion ACTION est une action de l'utilisateur qui n'a pas de valeur monétaire quantifiable, tandis qu'une conversion TRANSACTION est une action qui a une valeur monétaire quantifiable. Il peut s'agir, par exemple, d'inscriptions à une liste de diffusion (ACTION ) ou d'achats en ligne (TRANSACTION ).
Les valeurs acceptées sont les suivantes :
|
|
kind |
string |
Identifie cela en tant que ressource ConversionList. Valeur: chaîne fixe doubleclicksearch#conversionList . |
Méthodes
- get
- Récupère une liste de conversions à partir d'un compte de moteur DoubleClick Search.
- getByCustomerId
- Récupère une liste de conversions à partir d'un compte de moteur DoubleClick Search en utilisant un nouveau numéro client Search Ads 360.
- insérer
- Insère un lot de nouvelles conversions dans DoubleClick Search.
- mise à jour
- 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.