Method: customers.uploadCallConversions

Elabora le conversioni di chiamata specificate.

Elenco degli errori generati: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

Richiesta HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadCallConversions

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

object (CallConversion)

obbligatorio. Le conversioni che vengono caricate.
partialFailure

boolean

obbligatorio. Se il valore è true, le operazioni andate a buon fine vengono eseguite e le operazioni non valide restituiranno errori. Se il valore è false, tutte le operazioni verranno eseguite in una sola transazione se e solo se sono tutte valide. Deve essere sempre impostato su true. Vedi https://developers.google.com/google-ads/api/docs/best-practices/partial-failures per saperne di più sull'errore parziale.
validateOnly

boolean

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

Corpo della risposta

Messaggio di risposta per ConversionUploadService.UploadCallConversions.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (CallConversionResult)
    }
  ]
}
Campi
partialFailureError

object (Status)

Errori relativi agli errori di conversione in modalità di errore parziale. Restituito quando si verificano tutti gli errori all'interno delle conversioni. Se si verificano errori che non riguardano le conversioni, ad esempio errori di autenticazione, viene restituito un errore a livello di RPC. Vedi https://developers.google.com/google-ads/api/docs/best-practices/partial-failures per saperne di più sull'errore parziale.
results[]

object (CallConversionResult)

Restituito per le conversioni elaborate correttamente. Il protocollo sarà vuoto per le righe che hanno ricevuto un errore. I risultati non vengono restituiti quando validationOnly è true.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/adwords

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.

CallConversion

Una conversione di chiamata.

Rappresentazione JSON 
{
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "consent": {
    object (Consent)
  },
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string
}
Campi
customVariables[]

object (CustomVariable)

Le variabili personalizzate associate a questa conversione.
consent

object (Consent)

L'impostazione del consenso per l'evento.
callerId

string

L'ID chiamante da cui è stata effettuata la chiamata. L'ID chiamante deve essere nel formato E.164 con il segno "+" precedente, ad esempio "+16502531234".
callStartDateTime

string

La data e l'ora in cui è avvenuta la chiamata. È 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".
conversionAction

string

Nome della risorsa dell'azione di conversione associata a questa conversione. Nota: sebbene questo nome risorsa sia composto 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

L'ora in cui si è verificata la conversione. Deve essere successiva all'ora della chiamata. È 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 ISO 4217 di tre caratteri. Ad esempio: USD, EUR.

CallConversionResult

Informazioni identificative per un caricamento CallConversionUpload elaborato correttamente.

Rappresentazione JSON 
{
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string
}
Campi
callerId

string

L'ID chiamante da cui è stata effettuata la chiamata. L'ID chiamante deve essere nel formato E.164 con il segno "+" precedente.
callStartDateTime

string

La data e l'ora in cui è avvenuta la chiamata. Il formato è "aaaa-mm-gg hh:mm:ss+|-hh:mm", ad esempio "2019-01-01 12:32:45-08:00".
conversionAction

string

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

string

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