- 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 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 |
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 ( |
Campos | |
---|---|
conversions[] |
Obrigatório. As conversões que estão sendo enviadas. |
partialFailure |
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 |
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 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 originou a chamada. O identificador de chamadas precisa estar no formato E.164 com o sinal "+" no início, por exemplo, "+16502531234". |
callStartDateTime |
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 |
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 |
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. 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 |
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 |
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 |
Nome do recurso da ação de conversão associada a esta 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". |