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/v15/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 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.

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

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.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la 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 "+" che precede il segno "+", 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: 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 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 di 3 caratteri ISO 4217. Ad esempio: USD, EUR.

CallConversionResult

Informazioni di identificazione per un 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 "+" che precede il segno "+".
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

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