L'ancienne API Search Ads 360 Reporting va disparaître et sera mise hors service le 30 juin 2024. Notez que l'API Search Ads 360 Conversion n'est pas affectée et continuera d'être disponible. Tout nouveau développement de rapports doit utiliser la nouvelle API Search Ads 360 Reporting.

À partir d'avril 2024, une erreur "supportedApiVersion" s'affichera lorsque vous demanderez un rapport. En savoir plus

Par ailleurs, nous vous recommandons vivement de migrer toutes les implémentations Search Ads 360 existantes vers la nouvelle API. Pour en savoir plus, consultez le guide de démarrage et le guide de migration de la nouvelle API Search Ads 360 Reporting.

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

Conversion

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: "`local`": un magasin physique "`online`": une 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. 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 : "`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 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 : "`FLOODLIGHT`"
`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 : "`ACTIVE`" "`DELETED`": (obsolète) "`REMOVED`"	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 : "`ACTION`" "`TRANSACTION`"
`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.