- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- ClickConversion
- ExternalAttributionData
- CartData
- Item
- ConversionEnvironment
- ClickConversionResult
- Faça um teste
Processa as conversões de clique especificadas.
Lista de erros gerados: AuthenticationError AuthorizationError ConversionUploadError HeaderError InternalError PartialFailureError QuotaError RequestError
Solicitação HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadClickConversions
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. |
debugEnabled |
Se verdadeiro, a API vai realizar todas as verificações de upload e retornar erros se algum for encontrado. Se for falso, ele vai realizar apenas uma validação básica de entrada, pular as verificações de upload subsequentes e retornar sucesso, mesmo que nenhum clique seja encontrado para o Essa configuração afeta apenas as conversões otimizadas para uploads de leads que usam O padrão é false |
jobId |
Opcional. Entrada opcional para definir o ID do job. Precisa ser um número não negativo menor que 2^31, se fornecido. Se este campo não for fornecido, a API gerará um ID de trabalho no intervalo [2^31, (2^63)-1]. A API vai retornar o valor dessa solicitação no campo |
Corpo da resposta
Mensagem de resposta para ConversionUploadService.UploadClickConversions
.
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. |
jobId |
ID da tarefa para o lote de upload. |
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.
ClickConversion
Uma conversão de clique.
Representação JSON |
---|
{ "gbraid": string, "wbraid": string, "externalAttributionData": { object ( |
Campos | |
---|---|
gbraid |
É o identificador de cliques associados a conversões de app e originados de dispositivos iOS a partir do iOS 14. |
wbraid |
É o identificador de cliques associados a conversões na Web e originados de dispositivos iOS a partir do iOS 14. |
externalAttributionData |
Dados adicionais sobre conversões atribuídas externamente. Esse campo é obrigatório para conversões com uma ação atribuída externamente, mas não pode ser definido de outra forma. |
customVariables[] |
As variáveis personalizadas associadas a essa conversão. |
cartData |
Dados do carrinho associados a essa conversão. |
userIdentifiers[] |
Os identificadores do usuário associados a essa conversão. Os uploads de conversões só são compatíveis com hashedEmail e hashedPhoneNumber. O número máximo de identificadores de usuários para cada conversão é cinco. |
conversionEnvironment |
O ambiente em que essa conversão foi registrada, por exemplo, app ou Web. |
consent |
A configuração de consentimento do evento. |
gclid |
O ID de clique do Google (gclid) associado a essa conversão. |
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 do clique. É 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. |
orderId |
O ID do pedido associado à conversão. Um código do pedido só pode ser usado para uma conversão por ação de conversão. |
ExternalAttributionData
Contém informações adicionais sobre conversões atribuídas externamente.
Representação JSON |
---|
{ "externalAttributionCredit": number, "externalAttributionModel": string } |
Campos | |
---|---|
externalAttributionCredit |
Representa a fração da conversão atribuída ao clique do Google Ads. |
externalAttributionModel |
Especifica o nome do modelo de atribuição. |
CartData
Contém informações adicionais sobre os dados do carrinho.
Representação JSON |
---|
{
"merchantId": string,
"feedCountryCode": string,
"feedLanguageCode": string,
"localTransactionCost": number,
"items": [
{
object ( |
Campos | |
---|---|
merchantId |
O ID no Merchant Center com que os itens são enviados. |
feedCountryCode |
O código do país associado ao feed em que os itens são enviados. |
feedLanguageCode |
O código do idioma associado ao feed em que os itens são enviados. |
localTransactionCost |
Soma de todos os descontos no nível da transação, como frete grátis e descontos de cupons para todo o carrinho. O código da moeda é o mesmo da mensagem ClickConversion. |
items[] |
Dados dos itens comprados. |
Item
Contém dados dos itens comprados.
Representação JSON |
---|
{ "productId": string, "quantity": integer, "unitPrice": number } |
Campos | |
---|---|
productId |
ID de compra do item. Precisa ser igual ao identificador de produto do Merchant Center. |
quantity |
Quantidade de itens vendidos. |
unitPrice |
Preço unitário, excluindo tributos, frete e todos os descontos no nível da transação. O código da moeda é o mesmo da mensagem ClickConversion. |
ConversionEnvironment
Ambiente de conversão da conversão enviada.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão. |
APP |
A conversão foi registrada em um app. |
WEB |
A conversão foi registrada em um site. |
ClickConversionResult
Informações de identificação para um ClickConversion processado.
Representação JSON |
---|
{
"gbraid": string,
"wbraid": string,
"userIdentifiers": [
{
object ( |
Campos | |
---|---|
gbraid |
É o identificador de cliques associados a conversões de app e originados de dispositivos iOS a partir do iOS 14. |
wbraid |
É o identificador de cliques associados a conversões na Web e originados de dispositivos iOS a partir do iOS 14. |
userIdentifiers[] |
Os identificadores do usuário associados a essa conversão. Os uploads de conversões só são compatíveis com hashedEmail e hashedPhoneNumber. O número máximo de identificadores de usuários para cada conversão é cinco. |
gclid |
O ID de clique do Google (gclid) associado a essa conversão. |
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". |