Aggiungi nuove conversioni

Chiama il 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 utilizza per segnalare 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 Search Ads 360, consulta ID e Conversioni.

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

Se la richiesta Conversion.insert() specifica più conversioni, Search Ads 360 cerca di caricare ogni conversione secondo il criterio del "best effort" invece di caricando l'intero batch come transazione "tutto o niente". Se alcune conversioni in un il caricamento in gruppo non riesce, altri potrebbero comunque essere caricati correttamente. Il caricamento delle conversioni può non riuscire a causa di una richiesta non valida o di errori di rete temporanei o di sistema. Pertanto, ti consigliamo di leggere la risposta per ogni conversione inserita assicurati che il caricamento sia riuscito.

Quando posso utilizzare i dati caricati?

Se specifichi un parametro conversionTimestamp di oggi o ieri per una conversione, metriche per la conversione verrà visualizzata nell'interfaccia utente di Search Ads 360 entro un'ora dal caricamento. Se specificare un conversionTimestamp risalente a più di ieri, le metriche verranno aggiornate 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 usa l'API Campaign Manager per crearne uno. Non puoi utilizzare l'API per specificare che un'attività Floodlight venga utilizzata principalmente per le conversioni offline, il che è una quando le strategie di offerta utilizzeranno i dati della conversione.

Ti consigliamo di fare ciò dopo aver utilizzato l'API per creare un'immagine , un utente di Search Ads 360 accede a Search Ads 360 e modifica il parametro per indicare che l'origine principale 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 utilizzata per registrare le conversioni offline. Le impostazioni devono indicano che la fonte principale di conversioni è l'attività offline. Consulta le Centro assistenza Search Ads 360 per istruzioni.

  2. Carica le conversioni non appena sono disponibili. Se attribuzione di 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 caricherai 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 un singolo una richiesta di caricamento, va bene se le voci non sono in ordine cronologico. Ma una strategia di offerta può 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 disponibilità.

    Il timestamp della disponibilità deve essere uno dei seguenti:

    • Se hai registrato conversioni nelle ultime 24 ore, ma non le hai caricate ma il timestamp deve corrispondere a il momento in cui è stata caricata l'ultima conversione . Questo indica a Search Ads 360 che potrebbero essersi verificate nelle ultime 24 ore, ma non hai ancora fornito i dati. Strategie di offerta e altri sistemi automatici considerano la cronologia del rendimento solo fino all'ultima conversione caricata.
    • Se non si sono verificate conversioni nelle ultime 24 ore, il timestamp deve essere la data e l'ora correnti. Questo comunica a Search Ads 360 che di conversioni si sono verificate nelle ultime 24 ore. Strategie di offerta e altri strumenti includono le ultime 24 ore (un giorno intero senza conversioni) parte della 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 dal tipo di l'evento o l'elemento a cui attribuisci la conversione. Le seguenti sezioni elencano le informazioni obbligatorie e campi 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 viene indirizzato 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 in Conversion.insert() richiesta:

Campi obbligatori

  • clickId: ID clic sensibile alle maiuscole della visita. Cerca nella log web dell'inserzionista per l'ID clic o per elencare le conversioni e utilizzare un l'ID clic di un'altra conversione. Search Ads 360 attribuirà la conversione a la parola chiave, l'annuncio e altri oggetti Search Ads 360 responsabili che genera la visita.
    Attendi almeno 30 minuti dopo Search Ads 360 genera un ID clic per caricare le conversioni. Se ricevi l'indicazione "ID clic non trovato" attendi quattro ore, quindi carica il conversioni. Tutte le conversioni devono essere caricate entro 90 giorni dalla data in cui l'ID clic generato. 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 e 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 nell'inserzionista. Per le conversioni online, Search Ads 360 copia il dsConversionId o floodlightOrderId in questa proprietà, a seconda delle istruzioni di Floodlight dell'inserzionista.
  • conversionTimestamp: indica la data e l'ora in cui e non è mai avvenuta una conversione. Ad esempio, se la conversione si verifica il ven 05 ago 2016 11:53:22 Ora legale orientale (GMT -4:00), specifica il timestamp in millisecondi di epoca: 1470412402000.
  • segmentationType: specifica il tipo di sistema di conversione che stai caricando in cui eseguire la conversione. Attualmente sono supportate solo le conversioni Floodlight, perciò questo campo è sempre obbligatorio specificare FLOODLIGHT.
  • segmentationName: il nome dell'attività Floodlight di cui è l'inserzionista per registrare la conversione.

    Se l'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 nel campo segmentationId anziché specificare il nome in nel campo segmentationName. Campaign Manager assegna anche un ID all'attività Floodlight, ma è diverso dall'ID Search Ads 360 e non può essere utilizzato per attribuire conversions.) Per visualizzare l'ID Search Ads 360 per un'attività Floodlight, scarica un sulle conversioni (dal UI di Search Ads 360 o i report API). Se almeno una conversione è stata attribuita all'attività Floodlight durante il vedrai l'ID Search Ads 360.

  • type: il tipo di conversione, ovvero ACTION o TRANSACTION. Una conversione ACTION non ha valore monetario, mentre una la conversione TRANSACTION. Esempi: iscrizioni a mailing list (ACTION) e Acquisti e-commerce (TRANSACTION).

    Se specifichi TRANSACTION, devi specificare anche il campo seguente:

    • 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 un valore pari a 1000.
  • currencyCode: la valuta delle entrate di una transazione. Per impostazione predefinita, le entrate sono 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 l'alfabeto ISO 4217 (3 caratteri) formato per specificare la valuta.
    Valido solo per le conversioni TRANSACTION.
  • customMetric e customDimension: carica dati aggiuntivi su un conversione, come il paese in cui viene spedito un articolo acquistato, gli ID prodotto o persino durata di una telefonata. Scopri di più su caricando dati per creare Variabili Floodlight.
  • deviceType: specifica il tipo di dispositivo su cui è avvenuta la conversione. Consulta l'elenco di valori accettati per questo .

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, preoccupati per l'attribuzione agli annunci: puoi omettere la maggior parte dei dati 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 TrackerId agli URL pagina di destinazione. Per informazioni su come ottenere gli ID parola chiave, consulta ID di Search Ads 360 e Conversioni.
  • conversionId: per le conversioni offline, gli inserzionisti forniscono questo ID. Gli inserzionisti possono e 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 nell'inserzionista. Per le conversioni online, Search Ads 360 copia il dsConversionId o floodlightOrderId in questa proprietà, a seconda delle istruzioni di Floodlight dell'inserzionista.
  • conversionTimestamp: indica la data e l'ora in cui e non è mai avvenuta una conversione. Ad esempio, se la conversione si verifica il ven 05 ago 2016 11:53:22 Ora legale orientale (GMT -4:00), specifica il timestamp in millisecondi di epoca: 1470412402000.
  • segmentationType: specifica il tipo di sistema di conversione che stai caricando in cui eseguire la conversione. Attualmente sono supportate solo le conversioni Floodlight, perciò questo campo è sempre obbligatorio specificare FLOODLIGHT.
  • segmentationName: il nome dell'attività Floodlight di cui è l'inserzionista per registrare la conversione.

    Se l'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 nel campo segmentationId anziché specificare il nome in il campo segmentationName. Campaign Manager assegna anche un ID all'attività Floodlight, ma è diverso dall'ID Search Ads 360 e non può essere utilizzato per attribuire conversions.) Per visualizzare l'ID Search Ads 360 per un'attività Floodlight, scarica un sulle conversioni (dal UI di Search Ads 360 o i report API). Se almeno una conversione è stata attribuita all'attività Floodlight durante il vedrai l'ID Search Ads 360.

  • type: il tipo di conversione, ovvero ACTION o TRANSACTION. Una conversione ACTION non ha valore monetario, mentre una la conversione TRANSACTION. Esempi: iscrizioni a mailing list (ACTION) e Acquisti e-commerce (TRANSACTION).

    Se specifichi TRANSACTION, devi specificare anche il campo seguente:

    • 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 un valore pari a 1000.
  • currencyCode: la valuta delle entrate di una transazione. Per impostazione predefinita, le entrate sono 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 l'alfabeto ISO 4217 (3 caratteri) formato per specificare la valuta.
    Applicabile solo per le conversioni TRANSACTION.
  • customMetric e customDimension: carica dati aggiuntivi su un conversione, come il paese in cui viene spedito un articolo acquistato, gli ID prodotto o persino durata di una telefonata. Scopri di più su caricando dati per creare Variabili Floodlight.
  • deviceType: specifica il tipo di dispositivo su cui è avvenuta la conversione. Consulta l'elenco di valori accettati per questo .

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 all'attività in 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 della conversione, un modello di attribuzione lineare attribuisci a ogni clic il 33% del merito di conversione.

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

Prima di iniziare

In Campaign Manager, crea un modello di attribuzione personalizzato e importa il modello in 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 un modello di attribuzione è stato applicato alla dati sulle conversioni che carichi. Impara altro

Campi obbligatori

Per applicare un modello di attribuzione di terze parti a una conversione, specifica quanto segue in la tua richiesta Conversion.insert():

  • clickId: ID clic sensibile alle maiuscole della visita. Cerca nella log web dell'inserzionista per l'ID clic o per elencare le conversioni e utilizzare un l'ID clic di un'altra conversione. Search Ads 360 attribuirà la conversione a la parola chiave, l'annuncio e altri oggetti Search Ads 360 responsabili che genera la visita.
    Attendi almeno 30 minuti dopo Search Ads 360 genera 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 in una conversione, ad esempio il numero di articoli in un carrello degli acquisti acquisto).

  • conversionId: per le conversioni offline, gli inserzionisti forniscono questo ID. Gli inserzionisti possono e 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 nell'inserzionista. Per le conversioni online, Search Ads 360 copia il dsConversionId o floodlightOrderId in questa proprietà, a seconda delle istruzioni di Floodlight dell'inserzionista.
  • conversionTimestamp: indica la data e l'ora in cui e non è mai avvenuta una conversione. Ad esempio, se la conversione si verifica il ven 05 ago 2016 11:53:22 Ora legale orientale (GMT -4:00), specifica il timestamp in millisecondi di epoca: 1470412402000.
  • segmentationType: specifica il tipo di sistema di conversione che stai caricando in cui eseguire la conversione. Attualmente sono supportate solo le conversioni Floodlight, perciò questo campo è sempre obbligatorio specificare FLOODLIGHT.
  • segmentationName: il nome dell'attività Floodlight di cui è l'inserzionista per registrare la conversione.

    Se l'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 nel campo segmentationId anziché specificare il nome in nel campo segmentationName. Campaign Manager assegna anche un ID all'attività Floodlight, ma è diverso dall'ID Search Ads 360 e non può essere utilizzato per attribuire conversions.) Per visualizzare l'ID Search Ads 360 per un'attività Floodlight, scarica un sulle conversioni (dal UI di Search Ads 360 o i report API). Se almeno una conversione è stata attribuita all'attività Floodlight durante il vedrai l'ID Search Ads 360.

  • type: il tipo di conversione, ovvero ACTION o TRANSACTION. Una conversione ACTION non ha valore monetario, mentre una la conversione TRANSACTION. Esempi: iscrizioni a mailing list (ACTION) e Acquisti e-commerce (TRANSACTION).

    Se specifichi TRANSACTION, devi specificare anche il campo seguente:

    • 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 includa Tre clic sugli annunci; a ogni clic verrà attribuito il 33% della conversione. Se la conversione entrate di 100 $, assicurati che il modello distribuisca 33 $di entrate per ogni clic e assicurati 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 un valore pari a 1000.
  • currencyCode: la valuta delle entrate di una transazione. Per impostazione predefinita, le entrate sono 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 l'alfabeto ISO 4217 (3 caratteri) formato per specificare la valuta.
    Valido solo per le conversioni TRANSACTION.
  • customMetric e customDimension: carica dati aggiuntivi su un conversione, come il paese in cui viene spedito un articolo acquistato, gli ID prodotto o persino durata di una telefonata. Scopri di più su caricando dati per creare Variabili Floodlight.
  • deviceType: specifica il tipo di dispositivo su cui è avvenuta la conversione. Consulta l'elenco di valori accettati per questo .

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 in la richiesta è stata convalidata e caricata correttamente.

Se la richiesta ha esito positivo

Se la richiesta ha esito positivo, la risposta include l'intero codice interno di Search Ads 360 per ogni conversione caricata, ad esempio ID campagna, ID gruppo di annunci e 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 che caricato 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: il motivo e l'errore dettagliato. . Il campo del motivo può contenere requestValidation, internalError, transactionFailed o lateStageRequestError.

Errori requestValidation

Gli errori requestValidation indicano problemi relativi ai dati nel caricamento della conversione richiesta (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 nel tuo per identificare gli errori.
  • Una descrizione dell'errore di convalida.

Per ulteriori informazioni, consulta l'elenco dei codici e 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 la presenza di un problema interno nelle 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à caricato, ma proverà a caricare le conversioni rimanenti.

Se continui a riscontrare errori dopo il nuovo invio, consulta la risoluzione dei problemi per informazioni su come procedere.