- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- CallConversion
- CallConversionResult
- Faça um teste
Processa as conversões de chamada informadas.
Lista de erros gerados: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
Solicitação HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadCallConversions
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
customerId |
Obrigatório. O ID do cliente que está executando o upload. |
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Representação JSON |
---|
{
"conversions": [
{
object ( |
Campos | |
---|---|
conversions[] |
Obrigatório. As conversões que estão sendo enviadas. |
partialFailure |
Obrigatório. Se verdadeiro, as operações bem-sucedidas serão realizadas 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. Sempre deve ser definido como verdadeiro. Consulte https://developers.google.com/google-ads/api/docs/best-practices/partial-failures (link em inglês) para mais informações sobre falhas parciais. |
validateOnly |
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 ( |
Campos | |
---|---|
partialFailureError |
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 (link em inglês) para mais informações sobre falhas parciais. |
results[] |
É 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 ( |
Campos | |
---|---|
customVariables[] |
As variáveis personalizadas associadas a essa conversão. |
consent |
A configuração de consentimento do evento. |
callerId |
O identificador de chamadas que fez a chamada. O identificador de chamadas precisa estar no formato E.164 com o sinal "+" no início, por exemplo, "+16502531234". |
callStartDateTime |
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 |
Nome do recurso da ação de conversão associada a essa conversão. Observação: embora esse nome de recurso consista em um ID de cliente e um ID de ação de conversão, a validação vai ignorar o ID do cliente e usar o ID da ação de conversão como o único identificador da ação de conversão. |
conversionDateTime |
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 |
O valor da conversão para o anunciante. |
currencyCode |
Moeda associada ao valor da conversão. Este é o código de moeda ISO 4217 com três caracteres. Por exemplo: USD, EUR. |
CallConversionResult
Informações de identificação para um CallConversionUpload processado.
Representação JSON |
---|
{ "callerId": string, "callStartDateTime": string, "conversionAction": string, "conversionDateTime": string } |
Campos | |
---|---|
callerId |
O identificador de chamadas que fez a chamada. O identificador de chamadas precisa estar no formato E.164 com o sinal "+" no início. |
callStartDateTime |
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 |
Nome do recurso da ação de conversão associada a essa conversão. |
conversionDateTime |
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". |