L'ancienne API Search Ads 360 Reporting est en cours de suppression. Vous pouvez désormais créer vos rapports à l'aide de la nouvelle API Search Ads 360 Reporting.

Notez que l'API de conversion Search Ads 360 n'est pas concernée et continuera d'être prise en charge.

Cette page a été traduite par l'API Cloud Translation.

Conversion

La ressource Conversion comporte des méthodes qui permettent 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`	l'identifiant de l'annonce DS.
`conversion[].adUserDataConsent`	`string`	Représente le consentement pour les préférences des services de plate-forme essentiels (CPS) dans les paramètres. Aucune valeur par défaut. Les valeurs acceptables sont les suivantes : "GRANTED" (ACCORDÉ) : l'état du consentement souhaité doit être accordé. Lisez les préférences CPS dans les paramètres GTE. "DENIED" (REFUSÉ) : l'état du consentement souhaité est "deny". La liste 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. Valeurs acceptées: "`local`" : magasin physique "`online`" : boutique en ligne
`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. Chaque conversion d'une demande doit spécifier un identifiant unique, et la combinaison de cet identifiant et de code temporel doit être unique parmi toutes les conversions de l'annonceur. Pour les conversions en ligne, DS copie `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 (epoch).
`conversion[].conversionTimestamp`	`unsigned long`	Heure à laquelle la conversion s'est produite, en 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 de la conversion. Il 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 servir à 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 possibles sont les suivantes: <ph type="x-smartling-placeholder"> </ph> "`DESKTOP`" "`HIGH_END_MOBILE`" "`OTHER_DEVICE`" "`TABLET`"
`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 généré et utilisé par DS 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. Pour spécifier un pays, utilisez un code ISO 3166.
`conversion[].productGroupId`	`long`	ID du groupe de produits DS.
`conversion[].productId`	`string`	L'identifiant du 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é associée à cette conversion, en millisecondes.	accessible en écriture
`conversion[].revenueMicros`	`long`	Montant des revenus de cette conversion `TRANSACTION`, en micro-unités (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 requête.	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 d'activité Floodlight DoubleClick Search).
`conversion[].segmentationType`	`string`	Type de segmentation de cette conversion (par exemple, `FLOODLIGHT`). Les valeurs possibles sont les suivantes: <ph type="x-smartling-placeholder"> </ph> "`FLOODLIGHT`"
`conversion[].state`	`string`	État de la conversion (`ACTIVE` ou `REMOVED`). Remarque: L'état DELETED est obsolète. Les valeurs possibles sont les suivantes: <ph type="x-smartling-placeholder"> </ph> "`ACTIVE`" "`DELETED`" : (obsolète) "`REMOVED`"	accessible en écriture
`conversion[].storeId`	`string`	Identifiant du magasin physique pour lequel le produit a été promu. Applicable uniquement 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 monétaire quantifiable, tandis qu'une conversion `TRANSACTION` est une action ayant une valeur monétaire quantifiable. Il peut s'agir, par exemple, d'inscriptions à une liste de diffusion (`ACTION`) ou d'achats en ligne (`TRANSACTION`). Valeurs acceptées: <ph type="x-smartling-placeholder"> </ph> "`ACTION`" "`TRANSACTION`"
`kind`	`string`	Identifie l'élément 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 associé à un moteur DoubleClick Search.
getByCustomerId: Récupère une liste de conversions à partir d'un compte associé à un moteur DoubleClick Search à l'aide d'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.