- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- ClickConversion
- ExternalAttributionData
- CartData
- Elemento
- ConversionEnvironment
- ClickConversionResult
- Prova!
Elabora le conversioni dei clic specificate.
Elenco degli errori generati: AuthenticationError AuthorizationError ConversionUploadError HeaderError InternalError PartialFailureError QuotaError RequestError
Richiesta HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadClickConversions
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
customerId |
Obbligatorio. L'ID del cliente che esegue il caricamento. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"conversions": [
{
object ( |
Campi | |
---|---|
conversions[] |
Obbligatorio. Le conversioni che vengono caricate. |
partialFailure |
Obbligatorio. Se il valore è true, le operazioni riuscite verranno eseguite e quelle non valide restituiranno errori. Se impostato su false, tutte le operazioni verranno eseguite in un'unica transazione solo se sono tutte valide. Deve essere sempre impostato su true. Per ulteriori informazioni sull'errore parziale, consulta la pagina https://developers.google.com/google-ads/api/docs/best-practices/partial-failures. |
validateOnly |
Se il valore è true, la richiesta viene convalidata ma non eseguita. Vengono restituiti solo gli errori, non i risultati. |
debugEnabled |
Se il valore è true, l'API eseguirà tutti i controlli di caricamento e restituirà eventuali errori. Se il valore è false, verrà eseguita solo la convalida dell'input di base, verranno ignorati i controlli di caricamento successivi e verrà restituito l'esito positivo anche se non è stato trovato alcun clic per l'elemento Questa impostazione influisce solo sulle conversioni avanzate per i caricamenti di lead che utilizzano Il valore predefinito è false. |
jobId |
Campo facoltativo. Input facoltativo per impostare l'ID job. Deve essere un numero non negativo inferiore a 2^31, se fornito. Se questo campo non viene fornito, l'API genererà un ID job compreso nell'intervallo [2^31, (2^63)-1]. L'API restituirà il valore per questa richiesta nel campo |
Corpo della risposta
Messaggio di risposta per ConversionUploadService.UploadClickConversions
.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "partialFailureError": { object ( |
Campi | |
---|---|
partialFailureError |
Errori relativi a errori di conversione in modalità di errore parziale. Errore restituito quando si verificano tutti gli errori all'interno delle conversioni. Se si verificano errori al di fuori delle conversioni, ad esempio errori di autenticazione, verrà restituito un errore a livello di RPC. Per ulteriori informazioni sull'errore parziale, consulta la pagina https://developers.google.com/google-ads/api/docs/best-practices/partial-failures. |
results[] |
Restituito per le conversioni elaborate correttamente. Il protocollo sarà vuoto per le righe che hanno ricevuto un errore. I risultati non vengono restituiti se convalidareOnly è true. |
jobId |
ID job per il batch di caricamento. |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/adwords
Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.
ClickConversion
Una conversione di clic.
Rappresentazione JSON |
---|
{ "gbraid": string, "wbraid": string, "externalAttributionData": { object ( |
Campi | |
---|---|
gbraid |
L'identificatore di clic per i clic associati alle conversioni di app e provenienti da dispositivi iOS a partire da iOS14. |
wbraid |
L'identificatore di clic per i clic associati alle conversioni web e provenienti da dispositivi iOS a partire da iOS14. |
externalAttributionData |
Dati aggiuntivi sulle conversioni attribuite esternamente. Questo campo è obbligatorio per le conversioni con un'azione di conversione attribuita esternamente, ma non deve essere impostato in altro modo. |
customVariables[] |
Le variabili personalizzate associate a questa conversione. |
cartData |
I dati del carrello associati a questa conversione. |
userIdentifiers[] |
Gli identificatori utente associati a questa conversione. Per i caricamenti delle conversioni sono supportati solo hashedEmail e hashedPhoneNumber. Il numero massimo di identificatori utente per ogni conversione è 5. |
conversionEnvironment |
L'ambiente su cui è stata registrata questa conversione, ad esempio App o Web. |
consent |
L'impostazione del consenso per l'evento. |
gclid |
L'ID clic Google (gclid) associato a questa conversione. |
conversionAction |
Nome della risorsa dell'azione di conversione associata a questa conversione. Nota: anche se questo nome risorsa è costituito da un ID cliente e da un ID azione di conversione, la convalida ignorerà l'ID cliente e utilizzerà l'ID azione di conversione come unico identificatore dell'azione di conversione. |
conversionDateTime |
La data e l'ora in cui si è verificata la conversione. Deve essere successiva all'ora del clic. È necessario specificare il fuso orario. Il formato è "aaaa-mm-gg hh:mm:ss+|-hh:mm", ad esempio "2019-01-01 12:32:45-08:00". |
conversionValue |
Il valore della conversione per l'inserzionista. |
currencyCode |
Valuta associata al valore di conversione. Si tratta del codice valuta di 3 caratteri ISO 4217. Ad esempio: USD, EUR. |
orderId |
L'ID ordine associato alla conversione. Un ID ordine può essere utilizzato per una sola conversione per azione di conversione. |
ExternalAttributionData
Contiene informazioni aggiuntive sulle conversioni attribuite esternamente.
Rappresentazione JSON |
---|
{ "externalAttributionCredit": number, "externalAttributionModel": string } |
Campi | |
---|---|
externalAttributionCredit |
Rappresenta la frazione della conversione attribuita al clic di Google Ads. |
externalAttributionModel |
Specifica il nome del modello di attribuzione. |
CartData
Contiene informazioni aggiuntive sui dati del carrello.
Rappresentazione JSON |
---|
{
"merchantId": string,
"feedCountryCode": string,
"feedLanguageCode": string,
"localTransactionCost": number,
"items": [
{
object ( |
Campi | |
---|---|
merchantId |
L'ID Merchant Center nel quale vengono caricati gli articoli. |
feedCountryCode |
Il codice paese associato al feed nel quale vengono caricati gli articoli. |
feedLanguageCode |
Il codice lingua associato al feed nel quale vengono caricati gli articoli. |
localTransactionCost |
Somma di tutti gli sconti a livello di transazione, come la spedizione gratuita e gli sconti di coupon per l'intero carrello. Il codice valuta è uguale a quello indicato nel messaggio ClickConversion. |
items[] |
I dati degli articoli acquistati. |
Articolo
Contiene i dati degli articoli acquistati.
Rappresentazione JSON |
---|
{ "productId": string, "quantity": integer, "unitPrice": number } |
Campi | |
---|---|
productId |
L'ID Shopping dell'articolo. Deve essere uguale all'ID prodotto di Merchant Center. |
quantity |
Numero di articoli venduti. |
unitPrice |
Prezzo unitario escluse tasse, spese di spedizione ed eventuali sconti a livello di transazione. Il codice valuta è uguale a quello indicato nel messaggio ClickConversion. |
ConversionEnvironment
Ambiente della conversione caricata.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
APP |
La conversione è stata registrata su un'app. |
WEB |
La conversione è stata registrata su un sito web. |
ClickConversionResult
Informazioni di identificazione per una conversione ClickConversion elaborata correttamente.
Rappresentazione JSON |
---|
{
"gbraid": string,
"wbraid": string,
"userIdentifiers": [
{
object ( |
Campi | |
---|---|
gbraid |
L'identificatore di clic per i clic associati alle conversioni di app e provenienti da dispositivi iOS a partire da iOS14. |
wbraid |
L'identificatore di clic per i clic associati alle conversioni web e provenienti da dispositivi iOS a partire da iOS14. |
userIdentifiers[] |
Gli identificatori utente associati a questa conversione. Per i caricamenti delle conversioni sono supportati solo hashedEmail e hashedPhoneNumber. Il numero massimo di identificatori utente per ogni conversione è 5. |
gclid |
L'ID clic Google (gclid) associato a questa conversione. |
conversionAction |
Nome della risorsa dell'azione di conversione associata a questa conversione. |
conversionDateTime |
La data e l'ora in cui si è verificata la conversione. Il formato è "aaaa-mm-gg hh:mm:ss+|-hh:mm", ad esempio "2019-01-01 12:32:45-08:00". |