Method: customers.uploadClickConversions

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/v14/customers/{customerId}:uploadClickConversions

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

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 (ClickConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "debugEnabled": boolean
}
Campi
conversions[]

object (ClickConversion)

Obbligatorio. Le conversioni che vengono caricate.
partialFailure

boolean

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

boolean

Se il valore è true, la richiesta viene convalidata ma non eseguita. Vengono restituiti solo gli errori, non i risultati.
debugEnabled

boolean

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 userIdentifiers fornito.

Questa impostazione influisce solo sulle conversioni avanzate per i caricamenti di lead che utilizzano userIdentifiers anziché GCLID, GBRAID o WBRAID. Quando carichi le conversioni avanzate per i lead, devi caricare tutti gli eventi di conversione nell'API, inclusi quelli che potrebbero non provenire dalle campagne Google Ads. Il caricamento di un evento che non appartiene a una campagna Google Ads comporterà un errore CLICK_NOT_FOUND se questo campo viene impostato su true. Poiché questi errori sono previsti per questi eventi, imposta questo campo su false in modo da poter verificare che i caricamenti siano formattati correttamente, ma ignorare CLICK_NOT_FOUND errori relativi a tutte le conversioni che non provengono da una campagna Google Ads. In questo modo, potrai concentrarti solo sugli errori che puoi risolvere.

Il valore predefinito è false.

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 (Status)
  },
  "results": [
    {
      object (ClickConversionResult)
    }
  ],
  "jobId": string
}
Campi
partialFailureError

object (Status)

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[]

object (ClickConversionResult)

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

string (int64 format)

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 (ExternalAttributionData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "cartData": {
    object (CartData)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "conversionEnvironment": enum (ConversionEnvironment),
  "gclid": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string,
  "orderId": string
}
Campi
gbraid

string

L'identificatore di clic per i clic associati alle conversioni di app e provenienti da dispositivi iOS a partire da iOS14.
wbraid

string

L'identificatore di clic per i clic associati alle conversioni web e provenienti da dispositivi iOS a partire da iOS14.
externalAttributionData

object (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[]

object (CustomVariable)

Le variabili personalizzate associate a questa conversione.
cartData

object (CartData)

I dati del carrello associati a questa conversione.
userIdentifiers[]

object (UserIdentifier)

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

enum (ConversionEnvironment)

L'ambiente su cui è stata registrata questa conversione, ad esempio App o Web.
gclid

string

L'ID clic Google (gclid) associato a questa conversione.
conversionAction

string

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

string

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

number

Il valore della conversione per l'inserzionista.
currencyCode

string

Valuta associata al valore di conversione. Si tratta del codice valuta di 3 caratteri ISO 4217. Ad esempio: USD, EUR.
orderId

string

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

number

Rappresenta la frazione della conversione attribuita al clic di Google Ads.
externalAttributionModel

string

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 (Item)
    }
  ]
}
Campi
merchantId

string (int64 format)

L'ID Merchant Center nel quale vengono caricati gli articoli.
feedCountryCode

string

Il codice paese associato al feed nel quale vengono caricati gli articoli.
feedLanguageCode

string

Il codice lingua associato al feed nel quale vengono caricati gli articoli.
localTransactionCost

number

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[]

object (Item)

I dati degli articoli acquistati.

Articolo

Contiene i dati degli articoli acquistati.

Rappresentazione JSON 
{
  "productId": string,
  "quantity": integer,
  "unitPrice": number
}
Campi
productId

string

L'ID Shopping dell'articolo. Deve essere uguale all'ID prodotto di Merchant Center.
quantity

integer

Numero di articoli venduti.
unitPrice

number

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 (UserIdentifier)
    }
  ],
  "gclid": string,
  "conversionAction": string,
  "conversionDateTime": string
}
Campi
gbraid

string

L'identificatore di clic per i clic associati alle conversioni di app e provenienti da dispositivi iOS a partire da iOS14.
wbraid

string

L'identificatore di clic per i clic associati alle conversioni web e provenienti da dispositivi iOS a partire da iOS14.
userIdentifiers[]

object (UserIdentifier)

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

string

L'ID clic Google (gclid) associato a questa conversione.
conversionAction

string

Nome della risorsa dell'azione di conversione associata a questa conversione.
conversionDateTime

string

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