Method: events.ingest

Faz upload de uma lista de recursos Event do Destination fornecido.

Solicitação HTTP

POST https://datamanager.googleapis.com/v1/events:ingest

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

Corpo da solicitação

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

Representação JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "events": [
    {
      object (Event)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  }
}
Campos
destinations[]

object (Destination)

Obrigatório. A lista de destinos para enviar os eventos.
events[]

object (Event)

Obrigatório. A lista de eventos a serem enviados aos destinos especificados. No máximo, 2.000 recursos Event podem ser enviados em uma única solicitação.
consent

object (Consent)

Opcional. Consentimento no nível da solicitação para aplicar a todos os usuários na solicitação. O consentimento no nível do usuário substitui o consentimento no nível da solicitação e pode ser especificado em cada Event.
validateOnly

boolean

Opcional. Para fins de teste. Se true, a solicitação será validada, mas não executada. Apenas erros são retornados, não resultados.
encoding

enum (Encoding)

Opcional. Obrigatório para uploads de UserData. O tipo de codificação dos identificadores de usuário. Para identificadores de usuário com hash, esse é o tipo de codificação da string com hash. Para identificadores de usuário criptografados com hash, esse é o tipo de codificação da string criptografada externa, mas não necessariamente da string com hash interna. Isso significa que a string com hash interna pode ser codificada de uma maneira diferente da string criptografada externa. Para uploads que não são UserData, esse campo é ignorado.
encryptionInfo

object (EncryptionInfo)

Opcional. Informações de criptografia para uploads do UserData. Se não for definido, será presumido que as informações de identificação enviadas foram criptografadas com hash, mas não criptografadas. Para uploads que não são UserData, esse campo é ignorado.

Corpo da resposta

Resposta do IngestEventsRequest.

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

Representação JSON 
{
  "requestId": string
}
Campos
requestId

string

O ID gerado automaticamente da solicitação.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Evento

Um evento que representa uma interação do usuário com o site ou app de um anunciante.

Representação JSON 
{
  "destinationReferences": [
    string
  ],
  "transactionId": string,
  "eventTimestamp": string,
  "lastUpdatedTimestamp": string,
  "userData": {
    object (UserData)
  },
  "consent": {
    object (Consent)
  },
  "adIdentifiers": {
    object (AdIdentifiers)
  },
  "currency": string,
  "conversionValue": number,
  "eventSource": enum (EventSource),
  "eventDeviceInfo": {
    object (DeviceInfo)
  },
  "cartData": {
    object (CartData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "experimentalFields": [
    {
      object (ExperimentalField)
    }
  ],
  "userProperties": {
    object (UserProperties)
  }
}
Campos
destinationReferences[]

string

Opcional. String de referência usada para determinar o destino. Se estiver vazio, o evento será enviado para todos os destinations na solicitação.
transactionId

string

Opcional. O identificador exclusivo do evento. Obrigatório para conversões que usam várias fontes de dados.
eventTimestamp

string (Timestamp format)

Obrigatório. Hora em que o evento ocorreu

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
lastUpdatedTimestamp

string (Timestamp format)

Opcional. A última vez que o evento foi atualizado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
userData

object (UserData)

Opcional. Partes de dados fornecidos pelo usuário, representando o usuário a que o evento está associado.
consent

object (Consent)

Opcional. Informações sobre se o usuário associado deu diferentes tipos de consentimento.
adIdentifiers

object (AdIdentifiers)

Opcional. Identificadores e outras informações usadas para corresponder o evento de conversão a outras atividades on-line, como cliques em anúncios.
currency

string

Opcional. O código da moeda associado a todos os valores monetários neste evento.
conversionValue

number

Opcional. O valor de conversão associado ao evento, para conversões com base no valor.
eventSource

enum (EventSource)

Opcional. Indicador de onde o evento ocorreu (Web, app, loja física etc.).
eventDeviceInfo

object (DeviceInfo)

Opcional. Informações coletadas sobre o dispositivo usado (se houver) quando o evento ocorreu.
cartData

object (CartData)

Opcional. Informações sobre a transação e os itens associados ao evento.
customVariables[]

object (CustomVariable)

Opcional. Outras informações de par chave/valor a serem enviadas aos contêineres de conversão (ação de conversão ou atividade do FL).
experimentalFields[]

object (ExperimentalField)

Opcional. Uma lista de pares de chave-valor para campos experimentais que podem ser promovidos para fazer parte da API.
userProperties

object (UserProperties)

Opcional. Informações avaliadas pelo anunciante sobre o usuário no momento em que o evento ocorreu.

AdIdentifiers

Identificadores e outras informações usadas para corresponder o evento de conversão a outras atividades on-line, como cliques em anúncios.

Representação JSON 
{
  "sessionAttributes": string,
  "gclid": string,
  "gbraid": string,
  "wbraid": string,
  "landingPageDeviceInfo": {
    object (DeviceInfo)
  }
}
Campos
sessionAttributes

string

Opcional. Atributos de sessão para atribuição e estimativa de eventos.
gclid

string

Opcional. O ID de clique do Google (gclid) associado a esse evento.
gbraid

string

Opcional. O identificador de cliques associados a eventos de app e feitos em dispositivos iOS 14 (ou mais recente).
wbraid

string

Opcional. O identificador de cliques associados a eventos da Web e feitos em dispositivos iOS 14 (ou mais recente).
landingPageDeviceInfo

object (DeviceInfo)

Opcional. Informações coletadas sobre o dispositivo usado (se houver) no momento do acesso ao site do anunciante após a interação com o anúncio.

DeviceInfo

Informações sobre o dispositivo usado (se houver) quando o evento ocorreu.

Representação JSON 
{
  "userAgent": string,
  "ipAddress": string
}
Campos
userAgent

string

Opcional. A string de user agent do dispositivo para o contexto especificado.
ipAddress

string

Opcional. O endereço IP do dispositivo para o contexto especificado.

Observação:o Google Ads não oferece suporte à correspondência de endereços IP para usuários finais no Espaço Econômico Europeu (EEE), no Reino Unido (UK) ou na Suíça (CH). Adicione lógica para excluir condicionalmente o compartilhamento de endereços IP de usuários dessas regiões e forneça informações claras e abrangentes sobre os dados coletados nos seus sites, apps e outras propriedades. Além disso, obtenha consentimento quando exigido por lei ou pelas políticas do Google aplicáveis. Consulte a página Sobre as importações de conversões off-line para mais detalhes.

EventSource

A origem do evento.

Tipos enumerados
EVENT_SOURCE_UNSPECIFIED EventSource não especificado. Nunca deve ser usado.
WEB O evento foi gerado em um navegador da Web.
APP O evento foi gerado por um app.
IN_STORE O evento foi gerado com base em uma transação na loja.
PHONE O evento foi gerado em uma ligação.
OTHER O evento foi gerado de outras fontes.

CartData

Os dados do carrinho associados ao evento.

Representação JSON 
{
  "merchantId": string,
  "merchantFeedLabel": string,
  "merchantFeedLanguageCode": string,
  "transactionDiscount": number,
  "items": [
    {
      object (Item)
    }
  ]
}
Campos
merchantId

string

Opcional. O ID do Merchant Center associado aos itens.
merchantFeedLabel

string

Opcional. O rótulo do feed do Merchant Center associado ao feed dos itens.
merchantFeedLanguageCode

string

Opcional. O código de idioma ISO 639-1 associado ao feed do Merchant Center dos itens.
transactionDiscount

number

Opcional. A soma de todos os descontos associados à transação.
items[]

object (Item)

Opcional. A lista de itens associados ao evento.

Item

Representa um item no carrinho associado ao evento.

Representação JSON 
{
  "merchantProductId": string,
  "quantity": string,
  "unitPrice": number
}
Campos
merchantProductId

string

Opcional. O ID do produto na conta do Merchant Center.
quantity

string (int64 format)

Opcional. O número deste item associado ao evento.
unitPrice

number

Opcional. O preço unitário, excluindo tributos, frete e descontos no nível da transação.

CustomVariable

Variável personalizada para conversões de anúncios.

Representação JSON 
{
  "variable": string,
  "value": string,
  "destinationReferences": [
    string
  ]
}
Campos
variable

string

Opcional. O nome da variável personalizada a ser definida. Se a variável não for encontrada para o destino especificado, ela será ignorada.
value

string

Opcional. O valor a ser armazenado para a variável personalizada.
destinationReferences[]

string

Opcional. String de referência usada para determinar a qual dos Event.destination_references a variável personalizada deve ser enviada. Se estiver vazio, o Event.destination_references será usado.

ExperimentalField

Campo experimental que representa campos não oficiais.

Representação JSON 
{
  "field": string,
  "value": string
}
Campos
field

string

Opcional. O nome do campo a ser usado.
value

string

Opcional. O valor do campo a ser definido.

UserProperties

Informações avaliadas pelo anunciante sobre o usuário no momento em que o evento ocorreu. Consulte https://support.google.com/google-ads/answer/14007601 para mais detalhes.

Representação JSON 
{
  "customerType": enum (CustomerType),
  "customerValueBucket": enum (CustomerValueBucket)
}
Campos
customerType

enum (CustomerType)

Opcional. Tipo do cliente associado ao evento.
customerValueBucket

enum (CustomerValueBucket)

Opcional. O valor do cliente avaliado pelo anunciante.

CustomerType

Tipo do cliente associado ao evento.

Tipos enumerados
CUSTOMER_TYPE_UNSPECIFIED CustomerType não especificado. Nunca deve ser usado.
NEW O cliente é novo para o anunciante.
RETURNING O cliente está retornando ao anunciante.
REENGAGED O cliente interagiu novamente com o anunciante.

CustomerValueBucket

O valor do cliente avaliado pelo anunciante.

Tipos enumerados
CUSTOMER_VALUE_BUCKET_UNSPECIFIED Unspecified CustomerValueBucket. Nunca deve ser usado.
LOW O cliente tem baixo valor.
MEDIUM O cliente é de valor médio.
HIGH O cliente é de alto valor.