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.