Aggiungi nuove conversioni

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 .

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

  /**
   * 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());
    }
  }
            

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 .

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

  /**
   * 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;
  }        

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

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

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.