Ajouter des conversions

Appelez la méthode Conversion.insert() pour ajouter une ou plusieurs conversions. Pour que la conversion soit correctement attribuée, votre demande 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 qui a généré la conversion. Pour savoir comment obtenir des ID Search Ads 360, consultez ID Search Ads 360 et conversions.

Pour en savoir plus sur les restrictions concernant l'importation de conversions historiques, 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 comme une transaction tout ou rien. Si certaines conversions d'un lot ne sont pas importées, d'autres peuvent l'être. Les importations de conversions peuvent échouer en raison d'une requête non valide ou d'erreurs réseau ou système temporaires. Nous vous recommandons donc de lire la réponse pour chaque conversion insérée afin de vous assurer que l'importation a réussi.

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 conversionTimestamp d'une conversion, les métriques correspondantes s'affichent dans l'interface utilisateur de Search Ads 360 dans l'heure qui suit l'importation. Si vous spécifiez un conversionTimestamp antérieur à la veille, les métriques seront mises à jour dans plusieurs 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 suivre les conversions hors connexion, vous pouvez utiliser l'API Campaign Manager pour en créer une. Vous ne pouvez pas utiliser l'API pour indiquer qu'une activité Floodlight est principalement utilisée pour les conversions hors connexion. Il s'agit pourtant d'une bonne pratique lorsque les stratégies d'enchères utilisent les données de la conversion.

Nous vous recommandons de créer une activité Floodlight à l'aide de l'API, puis de demander à un utilisateur Search Ads 360 de se connecter à Search Ads 360 et de modifier le paramètre de l'activité pour indiquer que la principale source de 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 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 attendre jusqu'à 24 heures avant que Search Ads 360 puisse reconnaître le clickId.

    Assurez-vous que chaque importation contient les données sur les conversions les plus récentes. Dans une même requête d'importation, il n'est pas grave si les entrées ne sont pas dans l'ordre chronologique. 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 demande 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 requis dans une requête Conversion.insert() dépendent de l'événement ou de l'article 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 informations suivantes dans votre requête Conversion.insert() :

Champs obligatoires

  • clickId : ID de clic de la visite, sensible à la casse. Recherchez l'ID de clic dans les journaux Web de l'annonceur ou listez les conversions et utilisez un ID de clic provenant d'une autre conversion. Search Ads 360 attribuera la conversion au mot clé, à l'annonce et aux autres objets Search Ads 360 qui ont généré 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 le message d'erreur "ID de clic introuvable", patientez 24 heures, puis importez à nouveau les conversions. Toutes les conversions doivent être importées dans les 90 jours suivant la génération de l'ID de clic. Dans le cas contraire, l'API Search Ads 360 risque de ne pas reconnaître la visite.
  • conversionId : pour les conversions hors connexion, les annonceurs fournissent cet ID. Les annonceurs peuvent spécifier l'ID de leur choix. Chaque conversion d'une requête doit spécifier un ID unique. De plus, 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 auxquelles la conversion a eu lieu. Par exemple, si la conversion a lieu 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 vers lequel vous importez la conversion. Actuellement, seules les conversions Floodlight sont acceptées. Ce champ est donc toujours requis pour spécifier FLOODLIGHT.
  • segmentationName : nom de l'activité Floodlight que l'annonceur utilise pour signaler la conversion.

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

    Si vous connaissez l'ID attribué par Search Ads 360 à une activité Floodlight, vous pouvez également l'indiquer dans segmentationId au lieu de spécifier le nom dans le champ segmentationName. (Campaign Manager attribue également un ID à l'activité Floodlight, mais cet ID est différent de celui de 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 (depuis l'UI Search Ads 360 ou l'API Reporting). 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 de type ACTION n'a pas de valeur monétaire, contrairement à une conversion de type TRANSACTION. Par exemple, les inscriptions à une liste de diffusion (ACTION) par rapport aux achats en ligne (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 par e-mail ou la quantité totale d'articles vendus. Si vous ne spécifiez pas ce champ pour les conversions de type 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 spécifiez une autre devise, Search Ads 360 convertit le montant des revenus indiqué dans la devise de l'annonceur. En savoir plus
    Indiquez la devise au format alphabétique ISO 4217 (trois caractères).
    Applicable uniquement aux conversions de type TRANSACTION.
  • customMetric et customDimension : importent des données supplémentaires sur une conversion, comme le pays vers lequel un article acheté est expédié, les ID de produit ou même la durée d'un appel téléphonique. En savoir plus sur l'importation de 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 principal objectif est d'attribuer des conversions à des mots clés (et non à des annonces), vous pouvez omettre la plupart des identifiants Search Ads 360 et ne spécifier 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 des ID de mots clés, consultez ID Search Ads 360 et conversions.
  • conversionId : pour les conversions hors connexion, les annonceurs fournissent cet ID. Les annonceurs peuvent spécifier l'ID de leur choix. Chaque conversion d'une requête doit spécifier un ID unique. De plus, 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 auxquelles la conversion a eu lieu. Par exemple, si la conversion a lieu 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 vers lequel vous importez la conversion. Actuellement, seules les conversions Floodlight sont acceptées. Ce champ est donc toujours requis pour spécifier FLOODLIGHT.
  • segmentationName : nom de l'activité Floodlight que l'annonceur utilise pour signaler la conversion.

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

    Si vous connaissez l'ID attribué par Search Ads 360 à une activité Floodlight, vous pouvez également l'indiquer dans segmentationId au lieu de spécifier le nom dans le champ segmentationName. (Campaign Manager attribue également un ID à l'activité Floodlight, mais cet ID est différent de celui de 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 (depuis l'UI Search Ads 360 ou l'API Reporting). 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 de type ACTION n'a pas de valeur monétaire, contrairement à une conversion de type TRANSACTION. Par exemple, les inscriptions à une liste de diffusion (ACTION) par rapport aux achats en ligne (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 par e-mail ou la quantité totale d'articles vendus. Si vous ne spécifiez pas ce champ pour les conversions de type 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 spécifiez une autre devise, Search Ads 360 convertit le montant des revenus indiqué dans la devise de l'annonceur. En savoir plus
    Indiquez la devise au format alphabétique ISO 4217 (trois caractères).
    Applicable uniquement aux conversions de type TRANSACTION.
  • customMetric et customDimension : importent des données supplémentaires sur une conversion, comme le pays vers lequel un article acheté est expédié, les ID de produit ou même la durée d'un appel téléphonique. En savoir plus sur l'importation de 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 de la visite, sensible à la casse. Recherchez l'ID de clic dans les journaux Web de l'annonceur ou listez les conversions et utilisez un ID de clic provenant d'une autre conversion. Search Ads 360 attribuera la conversion au mot clé, à l'annonce et aux autres objets Search Ads 360 qui ont généré 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. Dans le cas contraire, 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. Applicable uniquement si la requête inclut également le champ attributionModel.

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

  • conversionId : pour les conversions hors connexion, les annonceurs fournissent cet ID. Les annonceurs peuvent spécifier l'ID de leur choix. Chaque conversion d'une requête doit spécifier un ID unique. De plus, 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 auxquelles la conversion a eu lieu. Par exemple, si la conversion a lieu 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 vers lequel vous importez la conversion. Actuellement, seules les conversions Floodlight sont acceptées. Ce champ est donc toujours requis pour spécifier FLOODLIGHT.
  • segmentationName : nom de l'activité Floodlight que l'annonceur utilise pour signaler la conversion.

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

    Si vous connaissez l'ID attribué par Search Ads 360 à une activité Floodlight, vous pouvez également l'indiquer dans segmentationId au lieu de spécifier le nom dans le champ segmentationName. (Campaign Manager attribue également un ID à l'activité Floodlight, mais cet ID est différent de celui de 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 (depuis l'UI Search Ads 360 ou l'API Reporting). 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 de type ACTION n'a pas de valeur monétaire, contrairement à une conversion de type TRANSACTION. Par exemple, les inscriptions à une liste de diffusion (ACTION) par rapport aux achats en ligne (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 revenueMicros, vérifiez également que chaque clic ne reçoit que 33 $de revenus.

Champs facultatifs

  • quantityMillis : nombre d'articles dans cette conversion. Par exemple, le nombre de personnes qui se sont inscrites à une newsletter par e-mail ou la quantité totale d'articles vendus. Si vous ne spécifiez pas ce champ pour les conversions de type 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 spécifiez une autre devise, Search Ads 360 convertit le montant des revenus indiqué dans la devise de l'annonceur. En savoir plus
    Indiquez la devise au format alphabétique ISO 4217 (trois caractères).
    Applicable uniquement aux conversions de type TRANSACTION.
  • customMetric et customDimension : importent des données supplémentaires sur une conversion, comme le pays vers lequel un article acheté est expédié, les ID de produit ou même la durée d'un appel téléphonique. En savoir plus sur l'importation de 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 demande 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 campagne, l'ID de groupe d'annonces et l'ID de 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 demande n'aboutit pas

Si une ou plusieurs conversions ne sont pas validées ou importées, la réponse inclut des messages pour chaque importation de conversion ayant échoué. La réponse ne contient pas de messages concernant les conversions importées.

Voici un exemple de réponse à une requête qui n'a pas abouti :

{
 "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 requestValidation

Les erreurs requestValidation indiquent des problèmes de données dans la demande d'importation de conversions (par exemple, la conversion a déjà été importée ou le clickId 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 pour les erreurs d'importation de conversions.

Autres types de problèmes

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

Répondre à une erreur

Si la requête échoue, réessayez d'envoyer l'intégralité de l'appel de requête ultérieurement. Search Ads 360 signalera les erreurs requestValidation pour les conversions déjà importées, mais tentera d'importer les conversions restantes.

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