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:
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.
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.
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 ildsConversionId
ofloodlightOrderId
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 specificareFLOODLIGHT
.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 camposegmentationName
. 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, ovveroACTION
oTRANSACTION
. 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 a1000
.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
ecustomDimension
: 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 ottenerecriterionId
aggiungendoTrackerId
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 ildsConversionId
ofloodlightOrderId
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 specificareFLOODLIGHT
.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 camposegmentationName
. 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, ovveroACTION
oTRANSACTION
. 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 a1000
.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
ecustomDimension
: 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 campoattributionModel
.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 ildsConversionId
ofloodlightOrderId
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 specificareFLOODLIGHT
.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 camposegmentationName
. 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, ovveroACTION
oTRANSACTION
. 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 a1000
.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
ecustomDimension
: 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.