Ajouter des conversions

Appelez la méthode Conversion.insert() pour ajouter une ou plusieurs conversions. Pour attribuer correctement la conversion, votre requête doit spécifier le nom d'une activité Floodlight que l'annonceur utilise pour enregistrer les conversions hors connexion, ainsi que l'ID du mot clé, de l'annonce et éventuellement du clic ayant entraîné la conversion. Pour savoir comment obtenir des ID Search Ads 360, consultez ID et conversions Search Ads 360.

Pour en savoir plus sur les restrictions concernant l'importation de l'historique des conversions, consultez le Centre d'aide Search Ads 360.

Si votre requête Conversion.insert() spécifie plusieurs conversions, Search Ads 360 tente d'importer chaque conversion de la manière la plus précise possible au lieu d'importer l'ensemble du lot en tant que transaction tout ou rien. Si l'importation de certaines conversions d'un lot échoue, il est possible que d'autres soient importées. Les importations de conversions peuvent échouer en raison d'une requête non valide ou de défaillances réseau ou système temporaires. Par conséquent, nous vous recommandons de lire la réponse pour chaque conversion insérée afin de vous assurer que l'importation est réussie.

Combien de temps dois-je attendre avant de pouvoir utiliser les données importées ?

Si vous indiquez la date du jour ou la journée précédente comme code temporel d'une conversion, les métriques correspondantes s'affichent dans l'interface utilisateur de Search Ads 360 dans l'heure qui suit l'importation. conversionTimestamp Si vous spécifiez un conversionTimestamp antérieur à la veille, les métriques seront mises à jour dans quelques heures.

Convertissez tous les codes temporels des conversions en heure epoch (également appelée heure Unix).

Puis-je créer des activités Floodlight à partir de l'API ?

Si l'annonceur n'a pas encore créé d'activité Floodlight pour le suivi des conversions hors connexion, vous pouvez en créer une à l'aide de l'API Campaign Manager. Vous ne pouvez pas utiliser l'API pour spécifier qu'une activité Floodlight est principalement utilisée pour les conversions hors connexion, ce qui est une bonne pratique lorsque les stratégies d'enchères utilisent les données de la conversion.

Nous vous recommandons qu'après avoir utilisé l'API pour créer une activité Floodlight, un utilisateur de Search Ads 360 se connecte à Search Ads 360 et modifie le paramètre de l'activité pour indiquer que la source principale des conversions est l'activité hors connexion.

Bonnes pratiques pour ajouter des conversions

Nous vous recommandons de suivre les bonnes pratiques suivantes pour ajouter des conversions:

  1. Demandez à un utilisateur Search Ads 360 de se connecter à Search Ads 360 et de modifier les paramètres de chaque activité Floodlight que vous utilisez pour générer des rapports sur les conversions hors connexion. Les paramètres doivent indiquer que la source principale des conversions est l'activité hors connexion. Pour obtenir des instructions, consultez le Centre d'aide Search Ads 360.

  2. Importez les conversions dès qu'elles sont disponibles. Si vous attribuez des conversions à des visites spécifiques, attendez au moins six heures après la visite avant d'importer les données sur la conversion. Si vous les importez moins de six heures après la visite, Search Ads 360 risque de ne pas reconnaître l'ID de clic de la visite. Dans de rares cas, vous devrez peut-être patienter jusqu'à 24 heures avant que Search Ads 360 ne reconnaisse l'ID de clic.

    Assurez-vous que chaque importation contient les conversions les plus récentes. Dans une seule requête d'importation, les entrées peuvent être dans le désordre. Toutefois, il se peut qu'une stratégie d'enchères ne prenne pas en compte des conversions plus anciennes que vous importez plus tard dans une autre demande.

Envoyer une requête d'insertion

Vous pouvez envoyer une requête Conversion.insert() pour effectuer l'une des opérations suivantes:

  • Attribuer une conversion à une visite spécifique
  • Attribuer une conversion à un mot clé uniquement

Les champs obligatoires dans une requête Conversion.insert() dépendent de l'événement ou de l'élément auquel vous attribuez la conversion. Les sections suivantes listent les champs obligatoires et facultatifs pour chaque événement ou élément auquel vous pouvez attribuer une conversion.

Attribuer une conversion à une visite spécifique

Lorsqu'un client clique sur une ou plusieurs annonces et accède au site d'un annonceur, Search Ads 360 considère la session utilisateur sur le site de l'annonceur comme une visite. Pour attribuer une conversion à une visite, spécifiez les éléments suivants dans votre requête Conversion.insert():

Champs obligatoires

  • clickId: ID de clic sensible à la casse de la visite. Recherchez l'ID de clic dans les journaux Web de l'annonceur ou listez les conversions et utilisez un ID de clic d'une autre conversion. Search Ads 360 attribue la conversion au mot clé, à l'annonce et aux autres objets Search Ads 360 à l'origine de la visite.
    Attendez au moins six heures après que Search Ads 360 a généré un ID de clic pour importer les conversions. Si vous recevez un message d'erreur "ID de clic introuvable", patientez 24 heures, puis réimportez les conversions. Toutes les conversions doivent être importées dans les 90 jours suivant la génération de l'ID de clic. Sinon, l'API Search Ads 360 risque de ne pas reconnaître la visite.
  • conversionId: 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 parmi toutes les conversions de l'annonceur. Pour les conversions en ligne, Search Ads 360 copie dsConversionId ou floodlightOrderId dans cette propriété en fonction des instructions Floodlight de l'annonceur.
  • conversionTimestamp: indique la date et l'heure de la conversion. Par exemple, si la conversion se produit le vendredi 5 août 2016 à 11h53:22 (heure d'été de l'Est, GMT -4:00), spécifiez le code temporel en millisecondes Epoch : 1470412402000.
  • segmentationType: spécifie le type de système de conversion dans lequel vous importez la conversion. Actuellement, seules les conversions Floodlight sont acceptées. Par conséquent, ce champ est toujours obligatoire pour spécifier FLOODLIGHT.
  • segmentationName: nom de l'activité Floodlight utilisée par l'annonceur pour enregistrer la conversion.

    Si votre annonceur contient des activités portant le même nom (cela peut se produire si les activités appartiennent à différents groupes Floodlight), nous vous recommandons de renommer l'une des activités.

    Si vous connaissez l'ID attribué par Search Ads 360 à une activité Floodlight, vous pouvez également le spécifier dans segmentationId au lieu d'indiquer le nom dans le champ segmentationName. (Campaign Manager attribue également un ID à l'activité Floodlight, mais l'ID Campaign Manager est différent de l'ID Search Ads 360 et ne peut pas être utilisé pour attribuer des conversions.) Pour afficher l'ID Search Ads 360 d'une activité Floodlight, téléchargez un rapport sur les conversions (à partir de l'interface utilisateur de Search Ads 360 ou de l'API de création de rapports). Si au moins une conversion a été attribuée à l'activité Floodlight au cours de la période du rapport, l'ID Search Ads 360 s'affichera dans le rapport.

  • type: type de conversion, à savoir ACTION ou TRANSACTION. Une conversion ACTION n'a aucune valeur monétaire, contrairement à une conversion TRANSACTION. Par exemple, les inscriptions à une liste de diffusion (ACTION) par rapport aux achats d'e-commerce (TRANSACTION).

    Si vous spécifiez TRANSACTION, vous devez également spécifier le champ suivant:

    • revenueMicros: valeur monétaire de la conversion.

Champs facultatifs

  • quantityMillis: nombre d'articles dans cette conversion. Par exemple, le nombre de personnes qui se sont inscrites à une newsletter ou la quantité totale d'articles vendus. Si vous ne spécifiez pas ce champ pour les conversions ACTION, Search Ads 360 insère automatiquement la valeur 1000.
  • currencyCode: devise des revenus d'une transaction. Par défaut, les revenus sont supposés être exprimés dans la devise de l'annonceur. Si vous indiquez une autre devise, Search Ads 360 convertit le montant des revenus spécifié dans la devise de l'annonceur. En savoir plus
    Utilisez le format alphabétique ISO 4217 (trois caractères) pour spécifier la devise.
    Applicable uniquement aux conversions de TRANSACTION.
  • customMetric et customDimension: permet d'importer des données supplémentaires sur une conversion, telles que le pays dans lequel un article acheté est expédié, les ID de produit ou même la durée d'un appel téléphonique. Découvrez comment importer des données pour les variables Floodlight personnalisées.
  • deviceType: spécifie le type d'appareil sur lequel la conversion a eu lieu. Consultez la liste des valeurs acceptées pour ce champ.

JSON

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
    "conversionId" : "test_20130906_04",
    "conversionTimestamp" : "1378710000000",
    "segmentationType" : "FLOODLIGHT",
    "segmentationName" : "Test",
    "type": "TRANSACTION",
    "revenueMicros": "10000000", // 10 million revenueMicros is equivalent to $10 of revenue
    "currencyCode": "USD"
  }]
}

Java

  /**
   * Instantiate the Doubleclicksearch service, create conversions, and upload them.
   */
  public static void main(String[] args) throws Exception {

    Doubleclicksearch service = getService(); // See Set Up Your Application.

    // Set up a List to keep track of each conversion you create.
    List<Conversion> conversions = new Vector<Conversion>();

    // Add a conversion to the List.
    addTransactionConversionForVisit(conversions, "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
        "test_" + System.currentTimeMillis(), 10000000L, 1378710000000L);

    // Upload the List and handle the response.
    uploadConversions(conversions, service);
  }


  /**
   * Create a TRANSACTION conversion and add it to a List<Conversion>. This sample hard-codes
   * the segmentation name and currency. You probably wouldn't want your production code to be so brittle.
   */
  private static List<Conversion> addTransactionConversionForVisit(List<Conversion> conversions,
      String clickId, String conversionId, Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion().setClickId(clickId)
        .setConversionId(conversionId)
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType("TRANSACTION")
        .setRevenueMicros(revenue)
        .setCurrencyCode("USD")
        .setConversionTimestamp(BigInteger.valueOf(timeStamp));

    conversions.add(conversion);
    return conversions;
  }


  /**
   * Convert the List of conversions to a DS ConversionList, send an insert request to DS,
   * and output the response to a file.
   */
  private static void uploadConversions(List<Conversion> conversions, Doubleclicksearch service)
      throws IOException {

    FileOutputStream outputStream =
        new FileOutputStream(new File("./", "InsertConversionsResponse.txt"));
    final PrintStream printStream = new PrintStream(outputStream);

    try {
      // Convert the List to a ConversionList.
      ConversionList conversionList = new ConversionList().setConversion(conversions);

      // Insert an upload request and download the response to a file.
      service.conversion().insert(conversionList).executeAndDownloadTo(printStream);
      printStream.close();
    } catch (GoogleJsonResponseException e) {
      System.err.println("Get request was rejected.");
      for (ErrorInfo error : e.getDetails().getErrors()) {
        System.err.println(error.getMessage());
      }
      System.exit(e.getStatusCode());
    }
  }

Python

def insert_conversion(service):
  """Create and upload a TRANSACTION conversion that is attributed to a visit.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().insert(
      body=
      {
          'conversion': [{
              'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with a click ID from your site
              'conversionId': 'test_20140206_00',
              'conversionTimestamp': '1378710000000',
              'segmentationType': 'FLOODLIGHT',
              'segmentationName': 'Test',
              'type': 'TRANSACTION',
              'revenueMicros': '10000000', // 10 million revenueMicros is equivalent to $10 of revenue
              'currencyCode': 'USD'
              }]
      }
  )

  pprint.pprint(request.execute())

Attribuer une conversion à un mot clé uniquement

Si votre objectif principal est d'attribuer des conversions aux mots clés et que vous ne vous souciez pas de l'attribution aux annonces, vous pouvez omettre la plupart des identifiants Search Ads 360 et n'indiquer que l'identifiant du mot clé, ainsi que quelques autres champs:

Champs obligatoires

  • criterionId: identifiant du mot clé. Vous pouvez obtenir l'criterionId en ajoutant la macro TrackerId à vos URL de page de destination. Pour savoir comment obtenir les ID de mot clé, consultez la section ID et conversions Search Ads 360.
  • conversionId: pour les conversions hors connexion, cet identifiant est fourni par les annonceurs. Les annonceurs peuvent spécifier n'importe quel identifiant qui leur est propre. 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 parmi toutes les conversions de l'annonceur. Pour les conversions en ligne, Search Ads 360 copie dsConversionId ou floodlightOrderId dans cette propriété en fonction des instructions Floodlight de l'annonceur.
  • conversionTimestamp: indique la date et l'heure de la conversion. Par exemple, si la conversion se produit le vendredi 5 août 2016 à 11h53:22 (heure d'été de l'Est, GMT -4:00), spécifiez le code temporel en millisecondes Epoch : 1470412402000.
  • segmentationType: spécifie le type de système de conversion dans lequel vous importez la conversion. Actuellement, seules les conversions Floodlight sont acceptées. Par conséquent, ce champ est toujours obligatoire pour spécifier FLOODLIGHT.
  • segmentationName: nom de l'activité Floodlight utilisée par l'annonceur pour enregistrer la conversion.

    Si votre annonceur contient des activités portant le même nom (cela peut se produire si les activités appartiennent à différents groupes Floodlight), nous vous recommandons de renommer l'une des activités.

    Si vous connaissez l'ID attribué par Search Ads 360 à une activité Floodlight, vous pouvez également le spécifier dans segmentationId au lieu d'indiquer le nom dans le champ segmentationName. (Campaign Manager attribue également un ID à l'activité Floodlight, mais l'ID Campaign Manager est différent de l'ID Search Ads 360 et ne peut pas être utilisé pour attribuer des conversions.) Pour afficher l'ID Search Ads 360 d'une activité Floodlight, téléchargez un rapport sur les conversions (à partir de l'interface utilisateur de Search Ads 360 ou de l'API de création de rapports). Si au moins une conversion a été attribuée à l'activité Floodlight au cours de la période du rapport, l'ID Search Ads 360 s'affichera dans le rapport.

  • type: type de conversion, à savoir ACTION ou TRANSACTION. Une conversion ACTION n'a aucune valeur monétaire, contrairement à une conversion TRANSACTION. Par exemple, les inscriptions à une liste de diffusion (ACTION) par rapport aux achats d'e-commerce (TRANSACTION).

    Si vous spécifiez TRANSACTION, vous devez également spécifier le champ suivant:

    • revenueMicros: valeur monétaire de la conversion.

Champs facultatifs

  • quantityMillis: nombre d'articles dans cette conversion. Par exemple, le nombre de personnes qui se sont inscrites à une newsletter ou la quantité totale d'articles vendus. Si vous ne spécifiez pas ce champ pour les conversions ACTION, Search Ads 360 insère automatiquement la valeur 1000.
  • currencyCode: devise des revenus d'une transaction. Par défaut, les revenus sont supposés être exprimés dans la devise de l'annonceur. Si vous indiquez une autre devise, Search Ads 360 convertit le montant des revenus spécifié dans la devise de l'annonceur. En savoir plus
    Utilisez le format alphabétique ISO 4217 (trois caractères) pour spécifier la devise.
    Applicable uniquement aux conversions de TRANSACTION.
  • customMetric et customDimension: permet d'importer des données supplémentaires sur une conversion, telles que le pays dans lequel un article acheté est expédié, les ID de produit ou même la durée d'un appel téléphonique. Découvrez comment importer des données pour les variables Floodlight personnalisées.
  • deviceType: spécifie le type d'appareil sur lequel la conversion a eu lieu. Consultez la liste des valeurs acceptées pour ce champ.

JSON

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "criterionId": "43700003491981017", // Replace with your ID
    "conversionId": "customerTransaction73126",
    "conversionTimestamp": "1351196386000",
    "segmentationType": "FLOODLIGHT",
    "segmentationName": "Offline Purchase",
    "type": "TRANSACTION",
    "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue
    "currencyCode": "USD"
  }]
}

Java

  /**
   * Creates a TRANSACTION conversion, attributes it to a keyword only, and adds it to a List<Conversion>.
   * The example in the preceding section contains the uploadConversions method,
   * which can submit the list as an insert() request.
   */
  private static List<Conversion> addTransactionConversionForKeyword(List<Conversion> conversions,
      Long criterionId, String conversionId, Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion()
        .setCriterionId(criterionId)
        .setConversionId(conversionId)
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType("TRANSACTION")
        .setRevenueMicros(revenue)
        .setCurrencyCode("USD")
        .setConversionTimestamp(BigInteger.valueOf(timeStamp));

    conversions.add(conversion);
    return conversions;
  }

Python

def insert_conversion(service):
  """Create and upload a TRANSACTION conversion that is attributed to a keyword only.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().insert(
      body=
      {
          'conversion': [{
              'criterionId': '43700004289911004', // Replace with your ID
              'conversionId': 'test_1378710000000',
              'conversionTimestamp': '1378710000000',
              'segmentationType': 'FLOODLIGHT',
              'segmentationName': 'Test',
              'type': 'TRANSACTION',
              'revenueMicros': '20000000', // 20 million revenueMicros is equivalent to $20 of revenue
              'currencyCode': 'USD'
              }]
      }
  )

  pprint.pprint(request.execute())

Importer des données à partir d'un modèle d'attribution tiers

Un modèle d'attribution répartit le crédit d'une conversion entre toutes les activités du chemin de conversion. Supposons qu'un internaute clique sur une annonce associée à un lien commercial, puis sur une annonce display, et ensuite sur une autre annonce associée à un lien commercial avant d'effectuer une conversion. Avec un modèle d'attribution linéaire, chaque clic recevrait 33% du crédit de la conversion.

Search Ads 360 propose différents modèles d'attribution. Vous pouvez cependant utiliser un service tiers ou un service que vous avez vous-même développé pour répartir le crédit entre les clics. Dans ce cas, vous avez la possibilité d'importer les données d'attribution tierces dans Search Ads 360, et de les utiliser dans les rapports et les stratégies d'enchères Search Ads 360.

Avant de commencer

Dans Campaign Manager, créez un modèle d'attribution personnalisé, puis importez-le dans Search Ads 360. Vous lui attribuerez le nom Modèle d'attribution externe. Les fonctionnalités Search Ads 360 peuvent ainsi reconnaître qu'un modèle d'attribution a été appliqué aux données de conversion que vous importez. En savoir plus

Champs obligatoires

Pour appliquer un modèle d'attribution tiers à une conversion, spécifiez tous les éléments suivants dans votre requête Conversion.insert():

  • clickId: ID de clic sensible à la casse de la visite. Recherchez l'ID de clic dans les journaux Web de l'annonceur ou listez les conversions et utilisez un ID de clic d'une autre conversion. Search Ads 360 attribue la conversion au mot clé, à l'annonce et aux autres objets Search Ads 360 à l'origine de la visite.
    Attendez au moins 30 minutes après que Search Ads 360 a généré un ID de clic avant d'importer une conversion avec cet ID. Sinon, l'API Search Ads 360 risque de ne pas reconnaître la visite.
  • attributionModel: définissez la valeur sur Modèle d'attribution externe. En savoir plus
  • countMillis: montant du crédit de conversion à distribuer à ce clic. Ne s'applique que si la requête inclut également le champ attributionModel.

    Ne confondez pas ce champ avec quantityMillis, un champ facultatif qui spécifie le nombre d'articles dans une conversion (par exemple, le nombre d'articles dans un achat via un panier).

  • conversionId: pour les conversions hors connexion, cet identifiant est fourni par les annonceurs. Les annonceurs peuvent spécifier n'importe quel identifiant qui leur est propre. 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 parmi toutes les conversions de l'annonceur. Pour les conversions en ligne, Search Ads 360 copie dsConversionId ou floodlightOrderId dans cette propriété en fonction des instructions Floodlight de l'annonceur.
  • conversionTimestamp: indique la date et l'heure de la conversion. Par exemple, si la conversion se produit le vendredi 5 août 2016 à 11h53:22 (heure d'été de l'Est, GMT -4:00), spécifiez le code temporel en millisecondes Epoch : 1470412402000.
  • segmentationType: spécifie le type de système de conversion dans lequel vous importez la conversion. Actuellement, seules les conversions Floodlight sont acceptées. Par conséquent, ce champ est toujours obligatoire pour spécifier FLOODLIGHT.
  • segmentationName: nom de l'activité Floodlight utilisée par l'annonceur pour enregistrer la conversion.

    Si votre annonceur contient des activités portant le même nom (cela peut se produire si les activités appartiennent à différents groupes Floodlight), nous vous recommandons de renommer l'une des activités.

    Si vous connaissez l'ID attribué par Search Ads 360 à une activité Floodlight, vous pouvez également le spécifier dans segmentationId au lieu d'indiquer le nom dans le champ segmentationName. (Campaign Manager attribue également un ID à l'activité Floodlight, mais l'ID Campaign Manager est différent de l'ID Search Ads 360 et ne peut pas être utilisé pour attribuer des conversions.) Pour afficher l'ID Search Ads 360 d'une activité Floodlight, téléchargez un rapport sur les conversions (à partir de l'interface utilisateur de Search Ads 360 ou de l'API de création de rapports). Si au moins une conversion a été attribuée à l'activité Floodlight au cours de la période du rapport, l'ID Search Ads 360 s'affichera dans le rapport.

  • type: type de conversion, à savoir ACTION ou TRANSACTION. Une conversion ACTION n'a aucune valeur monétaire, contrairement à une conversion TRANSACTION. Par exemple, les inscriptions à une liste de diffusion (ACTION) par rapport aux achats d'e-commerce (TRANSACTION).

    Si vous spécifiez TRANSACTION, vous devez également spécifier le champ suivant:

    • revenueMicros: valeur monétaire de la conversion.

Si vous effectuez le suivi des revenus issus des conversions, assurez-vous que votre modèle répartit les revenus entre chaque point de contact d'un chemin de conversion. Par exemple, si votre modèle utilise une approche linéaire (et répartit de manière égale les revenus entre chaque point de contact) avec un chemin de conversion comprenant trois clics sur des annonces, chaque clic recevra 33% du crédit de la conversion. Si la conversion génère 100 $de revenus, assurez-vous que le modèle attribue 33 $de revenus à chaque clic. Dans les données importées, vérifiez également que chaque clic ne reçoit que 33 $de revenus.revenueMicros

Champs facultatifs

  • quantityMillis: nombre d'articles dans cette conversion. Par exemple, le nombre de personnes qui se sont inscrites à une newsletter ou la quantité totale d'articles vendus. Si vous ne spécifiez pas ce champ pour les conversions ACTION, Search Ads 360 insère automatiquement la valeur 1000.
  • currencyCode: devise des revenus d'une transaction. Par défaut, les revenus sont supposés être exprimés dans la devise de l'annonceur. Si vous indiquez une autre devise, Search Ads 360 convertit le montant des revenus spécifié dans la devise de l'annonceur. En savoir plus
    Utilisez le format alphabétique ISO 4217 (trois caractères) pour spécifier la devise.
    Applicable uniquement aux conversions de TRANSACTION.
  • customMetric et customDimension: permet d'importer des données supplémentaires sur une conversion, telles que le pays dans lequel un article acheté est expédié, les ID de produit ou même la durée d'un appel téléphonique. Découvrez comment importer des données pour les variables Floodlight personnalisées.
  • deviceType: spécifie le type d'appareil sur lequel la conversion a eu lieu. Consultez la liste des valeurs acceptées pour ce champ.

Exemple

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "clickId" : "PP5K8iI6ul7Vw09JZZDEp", // Replace with a click ID from your site
    "conversionId" : "test_20130906_04",
    "conversionTimestamp" : "1378710000000",
    "segmentationType" : "FLOODLIGHT",
    "segmentationName" : "Test",
    "type": "TRANSACTION",
    "attributionModel": "External Attribution Model",
    "countMillis": "330",
    "revenueMicros": "33000000", // 33 million revenueMicros is equivalent to $33 of revenue
    "currencyCode": "USD"
  }]
}

Gérer les réponses Search Ads 360

La réponse de Search Ads 360 n'indique la réussite que si toutes les conversions de la requête ont été validées et importées.

Si la requête aboutit

Si la requête aboutit, la réponse inclut la représentation interne complète de Search Ads 360 pour chaque conversion importée, comme l'ID de la campagne, l'ID du groupe d'annonces et l'ID du mot clé (critère).

{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "agencyId": "12300000000000456",
   "advertiserId": "45600000000010291",
   "engineAccountId": "700000000042441",
   "campaignId": "71700000002044839",
   "adGroupId": "58700000032026064",
   "criterionId": "43700004289911004",
   "adId": "0",
   "dsConversionId": "48719131694768384",
   "conversionId": "test_1383157331951",
   "state": "ACTIVE",
   "type": "TRANSACTION",
   "revenueMicros": "20000000",
   "currencyCode": "USD",
   "segmentationType": "FLOODLIGHT",
   "segmentationId": "25700000001464141",
   "segmentationName": "Test",
   "conversionTimestamp": "1378710000000",
   "conversionModifiedTimestamp": "1383157332368"
  },
  ...
 ]
}

Si la requête échoue

Si la validation ou l'importation d'une ou de plusieurs conversions échoue, la réponse inclut des messages pour chaque importation de conversion ayant échoué. La réponse ne contient pas de messages sur les conversions importées avec succès.

Voici un exemple de réponse à une requête qui n'aboutit pas complètement:

{
 "error": {
    "errors": [
       {
          "reason": "requestValidation",
          "message": "The request was not valid. Details: [0x0000011F: Advertiser conversion ID ..."
       },
       {
          "reason": "requestValidation",
          "message": "The request was not valid. Details:  [0x00000101: Click ID ..."
       }
    ]
  }
}

Chaque message d'échec contient deux champs importants: une raison et un message d'erreur détaillé. Le champ "Reason" peut contenir requestValidation, internalError, transactionFailed ou lateStageRequestError.

erreurs de validation de requête

Les erreurs requestValidation indiquent des problèmes de données dans la requête d'importation des conversions (par exemple, la conversion a déjà été importée ou l'identifiant de clic est introuvable). Dans ce type d'erreur, les détails du message contiennent deux éléments:

  • Code hexadécimal qui identifie le type d'erreur. Vous pouvez utiliser le code dans vos propres scripts pour identifier les erreurs.
  • Description de l'erreur de validation.

Pour en savoir plus, consultez la liste des codes et des descriptions que Search Ads 360 peut renvoyer en cas d'erreur d'importation de conversions.

Autres types de problèmes

Tous les autres types d'erreurs (internalError, transactionFailed ou lateStageRequestError) indiquent qu'un problème interne est survenu dans Search Ads 360.

Répondre à une erreur

Si la demande échoue, réessayez de renvoyer l'ensemble de l'appel de demande ultérieurement. Search Ads 360 signalera des erreurs requestValidation pour toutes les conversions déjà importées, mais tentera d'importer les conversions restantes.

Si des erreurs persistent après l'envoi, consultez la section Dépannage pour savoir comment procéder.