Aggiungi nuove conversioni

Chiama il metodo Conversion.insert() per aggiungere una o più conversioni. Per attribuire correttamente la conversione, la richiesta deve specificare il nome di un'attività Floodlight che l'inserzionista utilizza per generare report sulle conversioni offline, insieme all'ID della parola chiave, dell'annuncio e, possibilmente, del clic che ha generato la conversione. Per informazioni su come ottenere gli ID Search Ads 360, consulta ID Search Ads 360 e conversioni.

Puoi trovare informazioni relative alle limitazioni al caricamento delle conversioni storiche nel Centro assistenza Search Ads 360.

Se la richiesta Conversion.insert() specifica più conversioni, Search Ads 360 tenta di caricare ogni conversione in base al migliore tentativo anziché caricare l'intero batch come transazione tutto o niente. Se il caricamento di alcune conversioni in un batch non riesce, altre potrebbero comunque essere caricate correttamente. I caricamenti delle conversioni possono non riuscire a causa di una richiesta non valida o di errori temporanei di rete o di sistema. Pertanto, ti consigliamo di leggere la risposta per ogni conversione inserita per assicurarti che il caricamento vada a buon fine.

Quando posso utilizzare i dati caricati?

Se specifichi un conversionTimestamp di oggi o ieri per una conversione, le metriche per la conversione verranno visualizzate nella UI di Search Ads 360 entro un'ora dal caricamento. Se specifichi un conversionTimestamp risalente a una data antecedente a ieri, le metriche verranno aggiornate entro diverse ore.

Converti tutti i timestamp delle conversioni in ora Unix (nota anche come ora del periodo).

Posso creare attività Floodlight dall'API?

Se l'inserzionista non ha ancora creato un'attività Floodlight per il monitoraggio delle conversioni offline, puoi utilizzare l'API Campaign Manager per crearne una. Non puoi utilizzare l'API per specificare che un'attività Floodlight viene utilizzata principalmente per le conversioni offline, il che è una best practice quando le strategie di offerta utilizzeranno i dati della conversione.

Ti consigliamo di utilizzare l'API per creare un'attività Floodlight, quindi un utente di Search Ads 360 deve accedere a Search Ads 360 e modificare l'impostazione dell'attività per indicare che l'attività offline è la fonte principale delle conversioni.

Best practice per l'aggiunta di conversioni

Consigliamo le seguenti best practice per l'aggiunta di conversioni:

  1. Chiedi a un utente Search Ads 360 di accedere a Search Ads 360 e modificare le impostazioni per ogni attività Floodlight che utilizzi per generare report sulle conversioni offline. Le impostazioni devono indicare che la sorgente principale delle conversioni è l'attività offline. Consulta il Centro assistenza Search Ads 360 per istruzioni.

  2. Carica le conversioni non appena sono disponibili. Se attribuisci le conversioni a determinate visite, attendi almeno 6 ore dopo la visita prima di caricare la conversione. Search Ads 360 potrebbe non riconoscere l'ID clic della visita se carichi prima di 6 ore dopo la visita. In rari casi, potresti dover attendere fino a 24 ore prima che Search Ads 360 possa riconoscere l'ID clic.

    Assicurati che ogni caricamento contenga le conversioni più recenti. All'interno di una singola richiesta di caricamento, è accettabile che le voci non siano in ordine cronologico. Tuttavia, una strategia di offerta potrebbe non essere in grado di prendere in considerazione le conversioni più datate caricate in un momento successivo nel corso di un'altra richiesta.

Inviare una richiesta di inserimento

Puoi inviare una richiesta Conversion.insert() per eseguire una delle seguenti operazioni:

  • Attribuire una conversione a una visita specifica
  • Attribuire una conversione solo a una parola chiave

I campi obbligatori in una richiesta Conversion.insert() dipendono dall'evento o dall'articolo a cui stai attribuendo la conversione. Le sezioni seguenti elencano i campi obbligatori e facoltativi per ogni evento o elemento a cui puoi attribuire una conversione.

Attribuire una conversione a una visita specifica

Quando un cliente fa clic su uno o più annunci e arriva al sito di un inserzionista, Search Ads 360 considera la sessione utente sul sito dell'inserzionista come una visita. Per attribuire una conversione a una visita, specifica quanto segue nella richiesta Conversion.insert():

Campi obbligatori

  • clickId: l'ID clic della visita, sensibile alle maiuscole. Cerca l'ID clic nei log web dell'inserzionista o elenca le conversioni e utilizza un ID clic di un'altra conversione. Search Ads 360 attribuirà la conversione alla parola chiave, all'annuncio e ad altri oggetti Search Ads 360 che hanno generato la visita.
    Attendi almeno 6 ore dopo che Search Ads 360 genera un ID clic per caricare le conversioni. Se ricevi l'errore "ID clic non trovato", attendi 24 ore e poi carica di nuovo le conversioni. Tutte le conversioni devono essere caricate entro 90 giorni dalla generazione dell'ID clic. In caso contrario, l'API Search Ads 360 potrebbe non riconoscere la visita.
  • conversionId: per le conversioni offline, questo ID viene fornito dagli inserzionisti. Gli inserzionisti possono specificare qualsiasi ID significativo per loro. Ogni conversione in una richiesta deve specificare un ID univoco e la combinazione di ID e timestamp deve essere univoca per tutte le conversioni all'interno dell'inserzionista. Per le conversioni online, Search Ads 360 copia dsConversionId o floodlightOrderId in questa proprietà a seconda delle istruzioni Floodlight dell'inserzionista.
  • conversionTimestamp: indica la data e l'ora in cui si è verificata la conversione. Ad esempio, se la conversione avviene venerdì 5 agosto 2016 alle 11:53:22 ora legale della costa orientale (GMT -4:00), specifica il timestamp in millisecondi Epoch: 1470412402000.
  • segmentationType: specifica il tipo di sistema di conversione a cui stai caricando la conversione. Al momento sono supportate solo le conversioni Floodlight, pertanto questo campo è sempre obbligatorio per specificare FLOODLIGHT.
  • segmentationName: il nome dell'attività Floodlight che l'inserzionista utilizza per generare report sulla conversione.

    Se il tuo inserzionista contiene attività con lo stesso nome (ciò può accadere se le attività appartengono a gruppi Floodlight diversi), l'azione consigliata è rinominare una delle attività.

    In alternativa, se conosci l'ID assegnato da Search Ads 360 a un'attività Floodlight, puoi specificare l'ID in segmentationId anziché specificare il nome nel campo segmentationName. Campaign Manager assegna anche un ID all'attività Floodlight, ma l'ID Campaign Manager è diverso dall'ID Search Ads 360 e non può essere utilizzato per attribuire le conversioni. Per visualizzare l'ID Search Ads 360 di un'attività Floodlight, scarica un report sulle conversioni (dall'interfaccia utente di Search Ads 360 o dall'API Reporting). Se almeno una conversione è stata attribuita all'attività Floodlight durante il periodo di tempo del report, vedrai l'ID Search Ads 360 nel report.

  • type: il tipo di conversione, ovvero ACTION o TRANSACTION. Una conversione AZIONE non ha valore monetario, mentre una conversione TRANSAZIONE sì. Ad esempio, le registrazioni alla mailing list (AZIONE) rispetto agli acquisti e-commerce (TRANSAZIONE).

    Se specifichi TRANSACTION, devi specificare anche il seguente campo:

    • revenueMicros: il valore monetario della conversione.

Campi facoltativi

  • quantityMillis: il numero di elementi in questa conversione. Ad esempio, il numero di persone che si sono iscritte a una newsletter via email o la quantità totale di articoli venduti. Se non specifichi questo campo per le conversioni ACTION, Search Ads 360 inserisce automaticamente un valore di 1000.
  • currencyCode: la valuta delle entrate di una transazione. Per impostazione predefinita, si presume che le entrate siano espresse nella valuta dell'inserzionista. Se specifichi una valuta diversa, Search Ads 360 converte l'importo delle entrate specificato nella valuta dell'inserzionista. Scopri di più
    Utilizza il formato alfabetico ISO 4217 (3 caratteri) per specificare la valuta.
    Valido solo per le conversioni TRANSAZIONE.
  • customMetric e customDimension: carica dati aggiuntivi su una conversione, ad esempio il paese a cui viene spedito un articolo acquistato, gli ID prodotto o persino la durata di una chiamata telefonica. Scopri di più sul caricamento dei dati per le variabili Floodlight personalizzate.
  • deviceType: specifica il tipo di dispositivo su cui è avvenuta la conversione. Consulta l'elenco dei valori accettati per questo campo.

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())

Attribuire una conversione solo a una parola chiave

Se la tua preoccupazione principale è attribuire le conversioni alle parole chiave e non agli annunci, puoi omettere la maggior parte degli identificatori Search Ads 360 e specificare solo l'identificatore della parola chiave insieme ad alcuni altri campi:

Campi obbligatori

  • criterionId: questo è l'identificatore della parola chiave. Puoi ottenere l'criterionId aggiungendo la macro TrackerId agli URL pagina di destinazione. Per informazioni su come ottenere gli ID parola chiave, consulta ID e conversioni di Search Ads 360.
  • conversionId: per le conversioni offline, questo ID viene fornito dagli inserzionisti. Gli inserzionisti possono specificare qualsiasi ID significativo per loro. Ogni conversione in una richiesta deve specificare un ID univoco e la combinazione di ID e timestamp deve essere univoca per tutte le conversioni all'interno dell'inserzionista. Per le conversioni online, Search Ads 360 copia dsConversionId o floodlightOrderId in questa proprietà a seconda delle istruzioni Floodlight dell'inserzionista.
  • conversionTimestamp: indica la data e l'ora in cui si è verificata la conversione. Ad esempio, se la conversione avviene venerdì 5 agosto 2016 alle 11:53:22 ora legale della costa orientale (GMT -4:00), specifica il timestamp in millisecondi Epoch: 1470412402000.
  • segmentationType: specifica il tipo di sistema di conversione a cui stai caricando la conversione. Al momento sono supportate solo le conversioni Floodlight, pertanto questo campo è sempre obbligatorio per specificare FLOODLIGHT.
  • segmentationName: il nome dell'attività Floodlight che l'inserzionista utilizza per generare report sulla conversione.

    Se il tuo inserzionista contiene attività con lo stesso nome (ciò può accadere se le attività appartengono a gruppi Floodlight diversi), l'azione consigliata è rinominare una delle attività.

    In alternativa, se conosci l'ID assegnato da Search Ads 360 a un'attività Floodlight, puoi specificare l'ID in segmentationId anziché specificare il nome nel campo segmentationName. Campaign Manager assegna anche un ID all'attività Floodlight, ma l'ID Campaign Manager è diverso dall'ID Search Ads 360 e non può essere utilizzato per attribuire le conversioni. Per visualizzare l'ID Search Ads 360 di un'attività Floodlight, scarica un report sulle conversioni (dall'interfaccia utente di Search Ads 360 o dall'API Reporting). Se almeno una conversione è stata attribuita all'attività Floodlight durante il periodo di tempo del report, vedrai l'ID Search Ads 360 nel report.

  • type: il tipo di conversione, ovvero ACTION o TRANSACTION. Una conversione AZIONE non ha valore monetario, mentre una conversione TRANSAZIONE sì. Ad esempio, le registrazioni alla mailing list (AZIONE) rispetto agli acquisti e-commerce (TRANSAZIONE).

    Se specifichi TRANSACTION, devi specificare anche il seguente campo:

    • revenueMicros: il valore monetario della conversione.

Campi facoltativi

  • quantityMillis: il numero di elementi in questa conversione. Ad esempio, il numero di persone che si sono iscritte a una newsletter via email o la quantità totale di articoli venduti. Se non specifichi questo campo per le conversioni ACTION, Search Ads 360 inserisce automaticamente un valore di 1000.
  • currencyCode: la valuta delle entrate di una transazione. Per impostazione predefinita, si presume che le entrate siano espresse nella valuta dell'inserzionista. Se specifichi una valuta diversa, Search Ads 360 converte l'importo delle entrate specificato nella valuta dell'inserzionista. Scopri di più
    Utilizza il formato alfabetico ISO 4217 (3 caratteri) per specificare la valuta.
    Valido solo per le conversioni TRANSAZIONE.
  • customMetric e customDimension: carica dati aggiuntivi su una conversione, ad esempio il paese a cui viene spedito un articolo acquistato, gli ID prodotto o persino la durata di una chiamata telefonica. Scopri di più sul caricamento dei dati per le variabili Floodlight personalizzate.
  • deviceType: specifica il tipo di dispositivo su cui è avvenuta la conversione. Consulta l'elenco dei valori accettati per questo campo.

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())

Caricare i dati da un modello di attribuzione di terze parti

Un modello di attribuzione distribuisce il merito di una conversione tra tutte le attività di un percorso di conversione. Ad esempio, se un consumatore fa clic su un annuncio della rete di ricerca a pagamento, un annuncio display e un altro annuncio della rete di ricerca a pagamento prima di effettuare la conversione, un modello di attribuzione lineare attribuisce a ciascun clic il 33% del merito di conversione.

Sebbene Search Ads 360 fornisca modelli di attribuzione, se utilizzi un servizio di terze parti o un servizio che hai sviluppato per distribuire il merito ai clic, puoi caricare i dati di attribuzione di terze parti in Search Ads 360 e utilizzarli nei report e nelle strategie di offerta di Search Ads 360.

Prima di iniziare

In Campaign Manager, crea un modello di attribuzione personalizzato e importalo in Search Ads 360. Assicurati di assegnare al modello il nome External Attribution Model. Ciò consente alle funzionalità di Search Ads 360 di riconoscere che è stato applicato un modello di attribuzione ai dati sulle conversioni che carichi. Scopri di più

Campi obbligatori

Per applicare un modello di attribuzione di terze parti a una conversione, specifica tutti i seguenti elementi nella richiesta Conversion.insert():

  • clickId: l'ID clic della visita, sensibile alle maiuscole. Cerca l'ID clic nei log web dell'inserzionista o elenca le conversioni e utilizza un ID clic di un'altra conversione. Search Ads 360 attribuirà la conversione alla parola chiave, all'annuncio e ad altri oggetti Search Ads 360 che hanno generato la visita.
    Attendi almeno 30 minuti dopo che Search Ads 360 genera un ID clic prima di caricare una conversione con l'ID. In caso contrario, l'API Search Ads 360 potrebbe non riconoscere la visita.
  • attributionModel: imposta su Modello di attribuzione esterno. Scopri di più
  • countMillis: l'importo del merito di conversione da distribuire a questo clic. Applicabile solo se la richiesta include anche il campo attributionModel.

    Non confondere questo campo con quantityMillis, un campo facoltativo che specifica il numero di elementi di una conversione (ad esempio il numero di articoli in un acquisto nel carrello).

  • conversionId: per le conversioni offline, questo ID viene fornito dagli inserzionisti. Gli inserzionisti possono specificare qualsiasi ID significativo per loro. Ogni conversione in una richiesta deve specificare un ID univoco e la combinazione di ID e timestamp deve essere univoca per tutte le conversioni all'interno dell'inserzionista. Per le conversioni online, Search Ads 360 copia dsConversionId o floodlightOrderId in questa proprietà a seconda delle istruzioni Floodlight dell'inserzionista.
  • conversionTimestamp: indica la data e l'ora in cui si è verificata la conversione. Ad esempio, se la conversione avviene venerdì 5 agosto 2016 alle 11:53:22 ora legale della costa orientale (GMT -4:00), specifica il timestamp in millisecondi Epoch: 1470412402000.
  • segmentationType: specifica il tipo di sistema di conversione a cui stai caricando la conversione. Al momento sono supportate solo le conversioni Floodlight, pertanto questo campo è sempre obbligatorio per specificare FLOODLIGHT.
  • segmentationName: il nome dell'attività Floodlight che l'inserzionista utilizza per generare report sulla conversione.

    Se il tuo inserzionista contiene attività con lo stesso nome (ciò può accadere se le attività appartengono a gruppi Floodlight diversi), l'azione consigliata è rinominare una delle attività.

    In alternativa, se conosci l'ID assegnato da Search Ads 360 a un'attività Floodlight, puoi specificare l'ID in segmentationId anziché specificare il nome nel campo segmentationName. Campaign Manager assegna anche un ID all'attività Floodlight, ma l'ID Campaign Manager è diverso dall'ID Search Ads 360 e non può essere utilizzato per attribuire le conversioni. Per visualizzare l'ID Search Ads 360 di un'attività Floodlight, scarica un report sulle conversioni (dall'interfaccia utente di Search Ads 360 o dall'API Reporting). Se almeno una conversione è stata attribuita all'attività Floodlight durante il periodo di tempo del report, vedrai l'ID Search Ads 360 nel report.

  • type: il tipo di conversione, ovvero ACTION o TRANSACTION. Una conversione AZIONE non ha valore monetario, mentre una conversione TRANSAZIONE sì. Ad esempio, le registrazioni alla mailing list (AZIONE) rispetto agli acquisti e-commerce (TRANSAZIONE).

    Se specifichi TRANSACTION, devi specificare anche il seguente campo:

    • revenueMicros: il valore monetario della conversione.

Se effettui il monitoraggio delle entrate conversione, assicurati che il modello distribuisca le entrate tra tutti i punti di contatto presenti in un percorso di conversione. Ad esempio, se il tuo modello utilizza un approccio lineare (distribuendo equamente le entrate tra tutti i punti di contatto), in un percorso di conversione che include 3 clic sugli annunci, a ciascun clic verrà attribuito il 33% della conversione. Se la conversione ha generato entrate pari a $100, assicurati che il tuo modello distribuisca $33 di entrate a ogni clic e che revenueMicros specifichi solo $33 di entrate per ogni clic.

Campi facoltativi

  • quantityMillis: il numero di elementi in questa conversione. Ad esempio, il numero di persone che si sono iscritte a una newsletter via email o la quantità totale di articoli venduti. Se non specifichi questo campo per le conversioni ACTION, Search Ads 360 inserisce automaticamente un valore di 1000.
  • currencyCode: la valuta delle entrate di una transazione. Per impostazione predefinita, si presume che le entrate siano espresse nella valuta dell'inserzionista. Se specifichi una valuta diversa, Search Ads 360 converte l'importo delle entrate specificato nella valuta dell'inserzionista. Scopri di più
    Utilizza il formato alfabetico ISO 4217 (3 caratteri) per specificare la valuta.
    Valido solo per le conversioni TRANSAZIONE.
  • customMetric e customDimension: carica dati aggiuntivi su una conversione, ad esempio il paese a cui viene spedito un articolo acquistato, gli ID prodotto o persino la durata di una chiamata telefonica. Scopri di più sul caricamento dei dati per le variabili Floodlight personalizzate.
  • deviceType: specifica il tipo di dispositivo su cui è avvenuta la conversione. Consulta l'elenco dei valori accettati per questo campo.

Esempio

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"
  }]
}

Gestire le risposte di Search Ads 360

La risposta di Search Ads 360 indica l'esito positivo solo se tutte le conversioni nella richiesta sono state convalidate e caricate correttamente.

Se la richiesta ha esito positivo

Se la richiesta va a buon fine, la risposta include la rappresentazione interna completa di Search Ads 360 per ogni conversione caricata, ad esempio ID campagna, ID gruppo di annunci e ID parola chiave (criterio).

{
 "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"
  },
  ...
 ]
}

Se la richiesta non va a buon fine

Se una o più conversioni non vengono convalidate o caricate, la risposta include messaggi per ogni caricamento di conversione non riuscito. La risposta non contiene messaggi sulle conversioni caricate correttamente.

Ecco un esempio di risposta a una richiesta che non va a buon fine:

{
 "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 ..."
       }
    ]
  }
}

Ogni messaggio di errore contiene due campi importanti: un motivo e un messaggio di errore dettagliato. Il campo Motivo può contenere requestValidation, internalError, transactionFailed o lateStageRequestError.

requestValidation errors

Gli errori requestValidation indicano problemi con i dati nella richiesta di caricamento delle conversioni (ad es. la conversione è già stata caricata o clickId non è stato trovato). In questo tipo di errore, i dettagli del messaggio contengono due elementi:

  • Un codice esadecimale che identifica il tipo di errore. Puoi utilizzare il codice nei tuoi script per identificare gli errori.
  • Una descrizione dell'errore di convalida.

Per ulteriori informazioni, consulta l'elenco dei codici e delle descrizioni che Search Ads 360 può restituire per gli errori di caricamento delle conversioni.

Altri tipi di errori

Tutti gli altri tipi di errori (internalError, transactionFailed o lateStageRequestError) indicano che si è verificato un problema interno in Search Ads 360.

Rispondere a un errore

Se la richiesta non va a buon fine, prova a inviare di nuovo l'intera chiamata di richiesta in un secondo momento. Search Ads 360 segnalerà errori requestValidation per le conversioni già caricate, ma tenterà di caricare le conversioni rimanenti.

Se continui a visualizzare errori dopo l'invio, consulta la sezione Risoluzione dei problemi per informazioni su come procedere.