Method: customers.uploadCallConversions

Processa as conversões de chamada fornecidas.

Lista de erros gerados: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. O ID do cliente que está realizando o upload.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "conversions": [
    {
      object (CallConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Campos
conversions[]

object (CallConversion)

Obrigatório. As conversões que estão sendo enviadas.
partialFailure

boolean

Obrigatório. Se verdadeiro, as operações bem-sucedidas serão executadas e as operações inválidas retornarão erros. Se for falso, todas as operações serão realizadas em uma transação apenas se todas forem válidas. Ele sempre deve ser definido como verdadeiro. Consulte https://developers.google.com/google-ads/api/docs/best-practices/partial-failures para mais informações sobre falhas parciais.
validateOnly

boolean

Se verdadeiro, a solicitação é validada, mas não executada. Somente erros são retornados, não resultados.

Corpo da resposta

Mensagem de resposta para ConversionUploadService.UploadCallConversions.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (CallConversionResult)
    }
  ]
}
Campos
partialFailureError

object (Status)

Erros relacionados a falhas de conversão no modo de falha parcial. Retornado quando todos os erros ocorrem nas conversões. Se ocorrer algum erro fora das conversões (por exemplo, erros de autenticação), vamos retornar um erro no nível da RPC. Consulte https://developers.google.com/google-ads/api/docs/best-practices/partial-failures para mais informações sobre falhas parciais.
results[]

object (CallConversionResult)

Retornado para conversões processadas. O Proto vai estar vazio nas linhas que receberam um erro. Os resultados não são retornados quando validateOnly é verdadeiro.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

CallConversion

Uma conversão de chamada.

Representação JSON 
{
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "consent": {
    object (Consent)
  },
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string
}
Campos
customVariables[]

object (CustomVariable)

As variáveis personalizadas associadas a essa conversão.
consent

object (Consent)

A configuração de consentimento do evento.
callerId

string

O identificador de chamadas que originou a chamada. O identificador de chamadas precisa estar no formato E.164 com o sinal "+" no início, por exemplo, "+16502531234".
callStartDateTime

string

A data e hora em que a chamada ocorreu. É necessário especificar o fuso horário. O formato é "aaaa-mm-dd hh:mm:ss+|-hh:mm", por exemplo, "2019-01-01 12:32:45-08:00".
conversionAction

string

Nome do recurso da ação de conversão associada a esta conversão. Observação: embora esse nome de recurso seja composto por um ID de cliente e um ID de ação de conversão, a validação vai ignorar o ID de cliente e usar o ID da ação de conversão como o único identificador da ação de conversão.
conversionDateTime

string

A data e a hora em que a conversão ocorreu. Precisa ser depois do horário da ligação. É necessário especificar o fuso horário. O formato é "aaaa-mm-dd hh:mm:ss+|-hh:mm", por exemplo, "2019-01-01 12:32:45-08:00".
conversionValue

number

O valor da conversão para o anunciante.
currencyCode

string

Moeda associada ao valor da conversão. Código ISO 4217 de três caracteres para a moeda. Por exemplo: USD, EUR.

CallConversionResult

Informações de identificação para um CallConversionUpload processado com sucesso.

Representação JSON 
{
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string
}
Campos
callerId

string

O identificador de chamadas que originou a chamada. O identificador de chamadas precisa estar no formato E.164 com o sinal "+" no início.
callStartDateTime

string

A data e hora em que a chamada ocorreu. O formato é "aaaa-mm-dd hh:mm:ss+|-hh:mm", por exemplo, "2019-01-01 12:32:45-08:00".
conversionAction

string

Nome do recurso da ação de conversão associada a esta conversão.
conversionDateTime

string

A data e a hora em que a conversão ocorreu. O formato é "aaaa-mm-dd hh:mm:ss+|-hh:mm", por exemplo, "2019-01-01 12:32:45-08:00".