Aggiungi nuove conversioni

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

Per informazioni sulle limitazioni relative al caricamento delle conversioni storiche, consulta il Centro assistenza Search Ads 360.

Se la richiesta Conversion.insert() specifica più conversioni, Search Ads 360 tenta di caricare ogni conversione secondo il criterio del "best effort" anziché caricare l'intero batch come una 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 sia riuscito.

Quando posso utilizzare i dati caricati?

Se specifichi per una conversione un valore conversionTimestamp relativo alla data odierna o al giorno precedente, le metriche relative alla conversione verranno visualizzate nell'interfaccia utente di Search Ads 360 entro un'ora dal caricamento. Se specifichi un valore conversionTimestamp risalente a più di ieri, le metriche verranno aggiornate tra diverse ore.

Converti tutti i timestamp delle conversioni in ora dell'epoca (nota anche come ora Unix).

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: questa è una best practice se le strategie di offerta utilizzeranno i dati della conversione.

È consigliabile che dopo aver utilizzato l'API per creare un'attività Floodlight, un utente di Search Ads 360 acceda a Search Ads 360 e modifichi l'impostazione dell'attività in modo da indicare che la fonte principale delle conversioni è un'attività offline.

Best practice per l'aggiunta di conversioni

Per aggiungere conversioni, consigliamo di attenerti alle seguenti best practice:

  1. Chiedi a un utente di 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 l'origine principale delle conversioni è l'attività offline. Per istruzioni, consulta il Centro assistenza Search Ads 360.

  2. Carica le conversioni non appena sono disponibili. Se attribuisci le conversioni a visite specifiche, attendi almeno 30 minuti dopo la visita prima di caricare la conversione. Search Ads 360 potrebbe non riconoscere l'ID clic della visita se carichi prima di 30 minuti dopo la visita. In rari casi, potrebbe essere necessario attendere fino a 4 ore prima che Search Ads 360 possa riconoscere clickId.

    Assicurati che ogni caricamento contenga le conversioni più recenti. All'interno di una singola richiesta di caricamento, le voci non sono in ordine cronologico. Tuttavia, una strategia di offerta potrebbe non essere in grado di prendere in considerazione le conversioni meno recenti caricate in un secondo momento in un'altra richiesta.

  3. Se attendi più di 24 ore prima di caricare le conversioni per un'attività Floodlight, invia un timestamp delle disponibilità.

    Il timestamp della disponibilità deve essere uno dei seguenti:

    • Se hai registrato conversioni nelle ultime 24 ore, ma non le hai ancora caricate, il timestamp deve corrispondere all'ora in cui si è verificata l'ultima conversione caricata. Questo indica a Search Ads 360 che le conversioni potrebbero essersi verificate nelle ultime 24 ore, ma non hai ancora fornito i dati. Le strategie di offerta e altri sistemi automatici prenderanno in considerazione la cronologia del rendimento solo fino all'ultima conversione caricata.
    • Se non si sono verificate conversioni nelle ultime 24 ore, il timestamp deve corrispondere all'ora e alla data correnti. Questo indica a Search Ads 360 che non è stata eseguita alcuna conversione nelle ultime 24 ore. Le strategie di offerta e altri sistemi automatici includeranno le ultime 24 ore, un giorno intero senza conversioni, nella cronologia del rendimento.

Invia una richiesta di inserimento

Puoi inviare una richiesta Conversion.insert() per effettuare 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'elemento a cui attribuisci la conversione. Le seguenti sezioni 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: ID clic sensibile alle maiuscole della visita. Cerca nei log web dell'inserzionista l'ID clic o elenca le conversioni e utilizza l'ID clic di un'altra conversione. Search Ads 360 attribuirà la conversione alla parola chiave, all'annuncio e ad altri oggetti Search Ads 360 responsabili della generazione della visita.
    Attendi almeno 30 minuti dopo che Search Ads 360 ha generato un ID clic per caricare le conversioni. Se ricevi un errore "ID clic non trovato", attendi quattro ore prima di caricare 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, gli inserzionisti forniscono questo ID. Gli inserzionisti possono specificare qualsiasi ID per loro significativo. Ogni conversione in una richiesta deve specificare un ID univoco e la combinazione di ID e timestamp deve essere univoca tra 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 il venerdì 5 agosto 2016 alle 11:53:22 ora legale orientale USA (GMT -4:00), specifica il timestamp in millisecondi di epoca: 1470412402000.
  • segmentationType: specifica il tipo di sistema di conversione in cui stai caricando la conversione. Attualmente sono supportate solo le conversioni Floodlight, perciò questo campo deve sempre specificare FLOODLIGHT.
  • segmentationName: il nome dell'attività Floodlight che l'inserzionista utilizza per registrare la conversione.

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

    In alternativa, se conosci l'ID che Search Ads 360 ha assegnato a un'attività Floodlight, puoi specificare l'ID in segmentationId anziché specificare il nome nel campo segmentationName. Anche Campaign Manager assegna 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 per un'attività Floodlight, scarica un report sulle conversioni (dall'interfaccia utente di Search Ads 360 o dall'API di reporting). Se almeno una conversione è stata attribuita all'attività Floodlight durante il periodo di tempo del report, visualizzerai l'ID Search Ads 360 nel report.

  • type: il tipo di conversione, ovvero ACTION o TRANSACTION. Una conversione ACTION non ha un valore monetario, mentre una conversione TRANSACTION sì. Alcuni esempi sono le registrazioni alla mailing list (ACTION) e gli acquisti e-commerce (TRANSACTION).

    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 AZIONE, Search Ads 360 inserisce automaticamente il valore 1000.
  • currencyCode: la valuta delle entrate di una transazione. Per impostazione predefinita, si presume che le entrate siano nella valuta dell'inserzionista. Se specifichi una valuta diversa, Search Ads 360 converte l'importo specificato delle entrate nella valuta dell'inserzionista. Scopri di più
    Utilizza il formato alfabetico ISO 4217 a 3 caratteri per specificare la valuta.
    Applicabile solo per le conversioni TRANSACTION.
  • customMetric e customDimension: carica dati aggiuntivi su una conversione, ad esempio il paese in cui viene spedito un articolo acquistato, gli ID prodotto o persino la durata di una telefonata. 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 di 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 riguarda l'attribuzione delle conversioni alle parole chiave e non ti ti preoccupa l'attribuzione agli annunci, puoi omettere la maggior parte degli identificatori di Search Ads 360 e specificare solo l'identificatore della parola chiave insieme ad alcuni altri campi:

Campi obbligatori

  • criterionId: l'identificatore della parola chiave. Puoi ottenere 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, gli inserzionisti forniscono questo ID. Gli inserzionisti possono specificare qualsiasi ID per loro significativo. Ogni conversione in una richiesta deve specificare un ID univoco e la combinazione di ID e timestamp deve essere univoca tra 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 il venerdì 5 agosto 2016 alle 11:53:22 ora legale orientale USA (GMT -4:00), specifica il timestamp in millisecondi di epoca: 1470412402000.
  • segmentationType: specifica il tipo di sistema di conversione in cui stai caricando la conversione. Attualmente sono supportate solo le conversioni Floodlight, perciò questo campo deve sempre specificare FLOODLIGHT.
  • segmentationName: il nome dell'attività Floodlight che l'inserzionista utilizza per registrare la conversione.

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

    In alternativa, se conosci l'ID che Search Ads 360 ha assegnato a un'attività Floodlight, puoi specificare l'ID in segmentationId anziché specificare il nome nel campo segmentationName. Anche Campaign Manager assegna 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 per un'attività Floodlight, scarica un report sulle conversioni (dall'interfaccia utente di Search Ads 360 o dall'API di reporting). Se almeno una conversione è stata attribuita all'attività Floodlight durante il periodo di tempo del report, visualizzerai l'ID Search Ads 360 nel report.

  • type: il tipo di conversione, ovvero ACTION o TRANSACTION. Una conversione ACTION non ha un valore monetario, mentre una conversione TRANSACTION sì. Alcuni esempi sono le registrazioni alla mailing list (ACTION) e gli acquisti e-commerce (TRANSACTION).

    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 AZIONE, Search Ads 360 inserisce automaticamente il valore 1000.
  • currencyCode: la valuta delle entrate di una transazione. Per impostazione predefinita, si presume che le entrate siano nella valuta dell'inserzionista. Se specifichi una valuta diversa, Search Ads 360 converte l'importo specificato delle entrate nella valuta dell'inserzionista. Scopri di più
    Utilizza il formato alfabetico ISO 4217 a 3 caratteri per specificare la valuta.
    Applicabile solo per le conversioni TRANSACTION.
  • customMetric e customDimension: carica dati aggiuntivi su una conversione, ad esempio il paese in cui viene spedito un articolo acquistato, gli ID prodotto o persino la durata di una telefonata. 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 di 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 dati da un modello di attribuzione di terze parti

Un modello di attribuzione distribuisce il credito per una conversione tra tutte le attività in un percorso di conversione. Ad esempio, se un consumatore fa clic su un annuncio della rete di ricerca a pagamento, su un annuncio display e su un altro annuncio della rete di ricerca a pagamento prima di effettuare la conversione, un modello di attribuzione lineare attribuirà a ogni 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 sviluppato in proprio 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 importa il modello in Search Ads 360. Assicurati di assegnare al modello il nome External Attribution Model (Modello di attribuzione esterno). In questo modo, le funzionalità di Search Ads 360 possono riconoscere che è stato applicato un modello di attribuzione ai dati sulle conversioni caricati. Scopri di più

Campi obbligatori

Per applicare un modello di attribuzione di terze parti a una conversione, specifica tutte le seguenti informazioni nella richiesta Conversion.insert():

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

    Da non confondere con quantityMillis, un campo facoltativo che specifica il numero di articoli inclusi in una conversione (ad es. il numero di articoli acquistati in un carrello degli acquisti).

  • conversionId: per le conversioni offline, gli inserzionisti forniscono questo ID. Gli inserzionisti possono specificare qualsiasi ID per loro significativo. Ogni conversione in una richiesta deve specificare un ID univoco e la combinazione di ID e timestamp deve essere univoca tra 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 il venerdì 5 agosto 2016 alle 11:53:22 ora legale orientale USA (GMT -4:00), specifica il timestamp in millisecondi di epoca: 1470412402000.
  • segmentationType: specifica il tipo di sistema di conversione in cui stai caricando la conversione. Attualmente sono supportate solo le conversioni Floodlight, perciò questo campo deve sempre specificare FLOODLIGHT.
  • segmentationName: il nome dell'attività Floodlight che l'inserzionista utilizza per registrare la conversione.

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

    In alternativa, se conosci l'ID che Search Ads 360 ha assegnato a un'attività Floodlight, puoi specificare l'ID in segmentationId anziché specificare il nome nel campo segmentationName. Anche Campaign Manager assegna 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 per un'attività Floodlight, scarica un report sulle conversioni (dall'interfaccia utente di Search Ads 360 o dall'API di reporting). Se almeno una conversione è stata attribuita all'attività Floodlight durante il periodo di tempo del report, visualizzerai l'ID Search Ads 360 nel report.

  • type: il tipo di conversione, ovvero ACTION o TRANSACTION. Una conversione ACTION non ha un valore monetario, mentre una conversione TRANSACTION sì. Alcuni esempi sono le registrazioni alla mailing list (ACTION) e gli acquisti e-commerce (TRANSACTION).

    Se specifichi TRANSACTION, devi specificare anche il seguente campo:

    • revenueMicros: il valore monetario della conversione.

Se monitori le entrate conversioni, assicurati che il modello distribuisca le entrate tra ogni punto di contatto in un percorso di conversione.Ad esempio, se il modello utilizza un approccio lineare (distribuendo equamente le entrate tra tutti i touchpoint), in un percorso di conversione che include tre clic sull'annuncio, a ogni clic verrà attribuito il 33% della conversione. Se la conversione ha generato entrate per 100 $, assicurati che il modello distribuisca 33 $di entrate per ogni clic e verifica 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 AZIONE, Search Ads 360 inserisce automaticamente il valore 1000.
  • currencyCode: la valuta delle entrate di una transazione. Per impostazione predefinita, si presume che le entrate siano nella valuta dell'inserzionista. Se specifichi una valuta diversa, Search Ads 360 converte l'importo specificato delle entrate nella valuta dell'inserzionista. Scopri di più
    Utilizza il formato alfabetico ISO 4217 a 3 caratteri per specificare la valuta.
    Applicabile solo per le conversioni TRANSACTION.
  • customMetric e customDimension: carica dati aggiuntivi su una conversione, ad esempio il paese in cui viene spedito un articolo acquistato, gli ID prodotto o persino la durata di una telefonata. 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 di 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 ha esito positivo, 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 ha esito positivo

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

Di seguito è riportato un esempio di risposta a una richiesta che non è stata completata correttamente:

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

Errori requestValidation

Gli errori requestValidation indicano problemi relativi ai dati nella richiesta di caricamento delle conversioni (ad es. la conversione è già stata caricata o il clickId non è stato trovato). In questo tipo di errore, il messaggio details contiene 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 in caso di errori di caricamento delle conversioni.

Altri tipi di errori

Tutti gli altri tipi di errori (internalError, transactionFailed o lateStageRequestError) indicano la presenza di un problema interno in Search Ads 360.

Rispondere a un errore

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

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