Ajouter des conversions

Appelez la méthode Conversion.insert(). pour ajouter une ou plusieurs conversions. Pour attribuer correctement la conversion, votre demande doit spécifier le nom d'une activité Floodlight que l'annonceur utilise pour générer des rapports des conversions hors connexion, ainsi que l'ID du mot clé, de l'annonce et éventuellement du clic à l'origine de la conversion. Pour pour obtenir des informations sur l'obtention des ID Search Ads 360, reportez-vous à la section ID et ID Search Ads 360 Conversions :

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

Si votre demande Conversion.insert() spécifie plusieurs conversions, Search Ads 360 tente d'importer chaque conversion de la manière la plus optimale possible, plutôt que en important l'intégralité du lot en tant que transaction de type tout ou rien. Si certaines conversions d'une l'importation groupée, d'autres peuvent toujours réussir. L'importation des conversions peut échouer en raison d'une requête non valide ou de défaillances temporaires du réseau ou du système. Par conséquent, nous nous vous recommandons de lire la réponse pour chaque conversion insérée 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 spécifiez un élément conversionTimestamp du jour ou de la veille pour une conversion, des statistiques la conversion apparaît 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 au format epoch (également appelé "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 utiliser l'API Campaign Manager pour en créer un. 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 constitue lorsque les stratégies d'enchères utiliseront les données des conversions.

Nous vous recommandons après avoir utilisé l'API pour créer un tag Floodlight , un utilisateur Search Ads 360 se connecte à Search Ads 360 et modifie pour indiquer que la source principale correspond à une 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, puis de modifier les paramètres. pour chaque activité Floodlight que vous utilisez pour générer des rapports sur les conversions hors connexion. Les paramètres doivent indiquent que la principale source de conversions est l'activité hors connexion. Consultez le Centre d'aide Search Ads 360 pour obtenir des instructions.

  2. Importez les conversions dès qu'elles sont disponibles. Si vous utilisez en attribuant des conversions à des visites spécifiques, patientez au moins 30 minutes la visite avant d'importer la conversion. Il est possible que Search Ads 360 ne reconnaisse pas l'ID de clic de la visite si moins de 30 minutes après votre visite. Dans de rares cas, vous devrez peut-être attendre jusqu'à quatre heures avant que Search Ads 360 reconnaisse l'ID de clic.

    Assurez-vous que chaque importation contient les conversions les plus récentes. Au sein d'un même d'importation, les entrées ne sont pas dans l'ordre chronologique. Mais une stratégie d'enchères peut vous ne pourrez pas prendre en compte les conversions plus anciennes que vous importerez plus tard dans une autre demande.

  3. Si vous attendez plus de 24 heures avant d'importer des conversions pour une activité Floodlight, envoyer une horodatage de disponibilité.

    Le code temporel de disponibilité doit correspondre à l'un des éléments suivants:

    • Si vous avez enregistré des conversions au cours des dernières 24 heures, mais que vous ne les avez pas importées Toutefois, le code temporel doit correspondre à l'heure à laquelle la dernière conversion importée s'est produit. Vous indiquez ainsi à Search Ads 360 que des conversions ont pu se produire. au cours des dernières 24 heures, mais vous n'avez pas encore fourni les données. Les stratégies d'enchères et Les autres systèmes automatisés ne prennent en compte l'historique des performances que jusqu'au que vous avez importée.
    • Si aucune conversion n'a été effectuée au cours des dernières 24 heures, le code temporel doit être le suivant : la date et l'heure actuelles. Vous indiquez ainsi à Search Ads 360 conversions ont eu lieu au cours des dernières 24 heures. Les stratégies d'enchères et autres systèmes prennent en compte les dernières 24 heures (une journée complète sans conversion) comme de l'historique des performances.

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 du l'événement ou l'élément auquel vous attribuez la conversion. Les sections suivantes répertorient les et des champs 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 est redirigé vers le site d'un annonceur, Search Ads 360 considère que la session utilisateur sur le site de l'annonceur est une visite. Pour attribuer une conversion à une visite, indiquez les éléments suivants dans votre Conversion.insert() requête:

Champs obligatoires

  • clickId: ID de clic sensible à la casse de la visite Consultez le les journaux Web de l'annonceur pour l'ID de clic ou répertorier les conversions, et utilisez une ID de clic d'une autre conversion. Search Ads 360 attribuera la conversion à le mot clé, l'annonce et les autres objets Search Ads 360 responsables de à l'origine de la visite.
    Attendez au moins 30 minutes après Search Ads 360 génère un ID de clic pour importer les conversions. Si le message "ID de clic introuvable" s'affiche s'affiche, patientez quatre heures, puis importez le fichier des conversions. Toutes les conversions doivent être importées dans les 90 jours suivant la date à laquelle le l'ID de clic est généré. Sinon, 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 n'importe quel ID qui l'intéresse. Chaque conversion d'une demande doit spécifier un identifiant unique, 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 l'élément 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 s'est produite. Par exemple, si le la conversion a lieu le ven. 5 août 2016 à 11:53: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 que vous importez. la conversion. Actuellement, seules les conversions Floodlight sont acceptées. Ce champ est toujours obligatoire pour spécifier FLOODLIGHT.
  • segmentationName: nom de l'activité Floodlight dont est 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 à des groupes Floodlight différents), nous vous recommandons renommer l'une des activités.

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

  • type: type de la conversion, c'est-à-dire ACTION ou TRANSACTION. Une conversion de type ACTION n'a aucune valeur monétaire, tandis qu'une TRANSACTION pour la conversion. Exemples : inscriptions à une liste de diffusion (ACTION) et 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'éléments dans cette conversion. Par exemple, le nombre de personnes qui se sont abonnées à une newsletter par e-mail 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 un la valeur de 1000.
  • currencyCode: devise des revenus d'une transaction. Par défaut, les revenus sont est censée être dans la devise de l'annonceur. Si vous spécifiez une autre devise, Search Ads 360 convertit les revenus spécifiés dans la devise de l'annonceur. En savoir plus
    Utilisez des caractères ISO 4217 (3 caractères) format pour spécifier la devise.
    Applicable uniquement aux conversions de type TRANSACTION.
  • customMetric et customDimension: importe des données supplémentaires sur un comme le pays de livraison d'un article acheté, les ID produit ou même le la durée d'un appel téléphonique ; En savoir plus sur l'importation de données pour des Variables Floodlight.
  • deviceType: spécifie le type d'appareil sur lequel la conversion a eu lieu. Voir la liste des valeurs acceptées pour cet .

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 principale préoccupation est d'attribuer des conversions à des mots clés alors que l'attribution à des annonces, vous pouvez omettre la plupart des et ne spécifiez que l'identifiant du mot clé et quelques autres champs:

Champs obligatoires

  • criterionId: identifiant du mot clé. Vous pouvez obtenir le criterionId en ajoutant TrackerId à vos URL de page de destination. Pour savoir comment obtenir les identifiants des mots clés, consultez les identifiants Search Ads 360 et Conversions.
  • conversionId: pour les conversions hors connexion, les annonceurs fournissent cet ID. Les annonceurs peuvent n'importe quel ID qui l'intéresse. Chaque conversion d'une demande doit spécifier un identifiant unique, 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 l'élément 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 s'est produite. Par exemple, si le la conversion a lieu le ven. 5 août 2016 à 11:53: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 que vous importez. la conversion. Actuellement, seules les conversions Floodlight sont acceptées. Ce champ est toujours obligatoire pour spécifier FLOODLIGHT.
  • segmentationName: nom de l'activité Floodlight dont est 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 à des groupes Floodlight différents), nous vous recommandons renommer l'une des activités.

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

  • type: type de la conversion, c'est-à-dire ACTION ou TRANSACTION. Une conversion de type ACTION n'a aucune valeur monétaire, tandis qu'une TRANSACTION pour la conversion. Exemples : inscriptions à une liste de diffusion (ACTION) et 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'éléments dans cette conversion. Par exemple, le nombre de personnes qui se sont abonnées à une newsletter par e-mail 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 un la valeur de 1000.
  • currencyCode: devise des revenus d'une transaction. Par défaut, les revenus sont est censée être dans la devise de l'annonceur. Si vous spécifiez une autre devise, Search Ads 360 convertit les revenus spécifiés dans la devise de l'annonceur. En savoir plus
    Utilisez des caractères ISO 4217 (3 caractères) format pour spécifier la devise.
    Applicable uniquement aux conversions de type TRANSACTION.
  • customMetric et customDimension: importe des données supplémentaires sur un comme le pays de livraison d'un article acheté, les ID produit ou même le la durée d'un appel téléphonique ; En savoir plus sur l'importation de données pour des Variables Floodlight.
  • deviceType: spécifie le type d'appareil sur lequel la conversion a eu lieu. Voir la liste des valeurs acceptées pour cet .

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 l'ensemble des l'activité d'un chemin de conversion. Par exemple, si un consommateur clique sur une annonce associée à un lien commercial, une annonce display et une autre annonce associée à un lien commercial avant une conversion, un modèle d'attribution linéaire attribuer à chaque clic 33% du crédit de la conversion.

Bien que Search Ads 360 fournit modèles d'attribution, si vous utilisez un service tiers ou un service développé pour répartir le crédit aux clics, vous pouvez importer les données d'attribution tierces Search Ads 360, puis utilisez les données dans les rapports et les stratégies d'enchères Search Ads 360.

Avant de commencer

Créez un modèle d'attribution personnalisé dans Campaign Manager, 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 détecter qu'un modèle d'attribution a été appliqué à la campagne les données de conversion que vous importez. En savoir plus 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 Consultez le les journaux Web de l'annonceur pour l'ID de clic ou répertorier les conversions, et utilisez une ID de clic d'une autre conversion. Search Ads 360 attribuera la conversion à le mot clé, l'annonce et les autres objets Search Ads 360 responsables de à l'origine de la visite.
    Attendez au moins 30 minutes après Search Ads 360 génère 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éfini sur External Attribution Model. En savoir plus
  • countMillis: montant du crédit de la conversion à répartir pour ce clic. Applicable uniquement si la requête inclut également le champ attributionModel.

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

  • conversionId: pour les conversions hors connexion, les annonceurs fournissent cet ID. Les annonceurs peuvent n'importe quel ID qui l'intéresse. Chaque conversion d'une demande doit spécifier un identifiant unique, 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 l'élément 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 s'est produite. Par exemple, si le la conversion a lieu le ven. 5 août 2016 à 11:53: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 que vous importez. la conversion. Actuellement, seules les conversions Floodlight sont acceptées. Ce champ est toujours obligatoire pour spécifier FLOODLIGHT.
  • segmentationName: nom de l'activité Floodlight dont est 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 à des groupes Floodlight différents), nous vous recommandons renommer l'une des activités.

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

  • type: type de la conversion, c'est-à-dire ACTION ou TRANSACTION. Une conversion de type ACTION n'a aucune valeur monétaire, tandis qu'une TRANSACTION pour la conversion. Exemples : inscriptions à une liste de diffusion (ACTION) et 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 suivez les 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 (répartis équitablement les revenus entre chaque point de contact), dans un chemin de conversion qui inclut trois clics sur une annonce, chaque clic se verra attribuer 33% de la conversion. Si la conversion a généré 100 € de revenus, assurez-vous que le modèle répartit 33 € de revenus pour chaque clic. et assurez-vous que revenueMicros n'indique que 33 $de revenus par clic.

Champs facultatifs

  • quantityMillis: nombre d'éléments dans cette conversion. Par exemple, le nombre de personnes qui se sont abonnées à une newsletter par e-mail 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 un la valeur de 1000.
  • currencyCode: devise des revenus d'une transaction. Par défaut, les revenus sont est censée être dans la devise de l'annonceur. Si vous spécifiez une autre devise, Search Ads 360 convertit les revenus spécifiés dans la devise de l'annonceur. En savoir plus
    Utilisez des caractères ISO 4217 (3 caractères) format pour spécifier la devise.
    Applicable uniquement aux conversions de type TRANSACTION.
  • customMetric et customDimension: importe des données supplémentaires sur un comme le pays de livraison d'un article acheté, les ID produit ou même le la durée d'un appel téléphonique ; En savoir plus sur l'importation de données pour des Variables Floodlight.
  • deviceType: spécifie le type d'appareil sur lequel la conversion a eu lieu. Voir la liste des valeurs acceptées pour cet .

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 indique une réussite uniquement si toutes les conversions dans la demande a bien été validée et importée.

Si la requête aboutit

Si la demande aboutit, la réponse inclut l'intégralité des ressources internes de Search Ads 360 représentation de chaque conversion importée (par exemple, l'ID de la campagne, l'ID du groupe d'annonces et le 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 n'aboutit pas,

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

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

{
 "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: un motif et une erreur détaillée. . Le champ "reason" peut contenir requestValidation, internalError, transactionFailed ou lateStageRequestError.

Erreurs requestValidation

Les erreurs requestValidation indiquent des problèmes de données au niveau de l'importation des conversions. (par exemple, la conversion a déjà été importée ou l'ID de clic est introuvable). Dans ce d'erreur, le message details contient deux éléments:

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

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

Autres types de problèmes

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

Répondre à une erreur

Si la requête échoue, essayez de renvoyer la totalité de l'appel de requête ultérieurement. Search Ads 360 signale les erreurs requestValidation pour toutes les conversions qui ont été déjà importé, mais il tentera d'importer les conversions restantes.

Si des erreurs s'affichent toujours après le renvoi, consultez le dépannage pour savoir comment procéder.