UserData

Dados do usuário que contêm identificadores e atributos.

Representação JSON 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  }
}
Campos
userIdentifiers[]

object (UserIdentifier)

Informações de identificação do usuário. Obrigatório.
transactionAttribute

object (TransactionAttribute)

Transações/atributos adicionais associados ao usuário. Obrigatório ao atualizar os dados de vendas na loja.
userAttribute

object (UserAttribute)

Outros atributos associados ao usuário. Obrigatório ao atualizar atributos da Segmentação por lista de clientes. Eles têm uma validade de 540 dias.

TransactionAttribute

Atributo da transação de vendas na loja.

Representação JSON 
{
  "storeAttribute": {
    object (StoreAttribute)
  },
  "itemAttribute": {
    object (ItemAttribute)
  },
  "transactionDateTime": string,
  "transactionAmountMicros": number,
  "currencyCode": string,
  "conversionAction": string,
  "orderId": string,
  "customValue": string
}
Campos
storeAttribute

object (StoreAttribute)

Armazena os atributos da transação. Acessível apenas para clientes na lista de permissões.
itemAttribute

object (ItemAttribute)

Atributos do item da transação.
transactionDateTime

string

Carimbo de data/hora de quando a transação ocorreu. Obrigatório. O formato é "AAAA-MM-DD HH:MM:SS[+/-HH:MM]", em que [+/-HH:MM] é uma diferença de fuso horário opcional do UTC. Se ele não for informado, a API usará o fuso horário da conta como padrão. Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30+03:00"
transactionAmountMicros

number

Valor da transação em micros. Obrigatório. O valor da transação em micros precisa ser maior que 1.000. Se os Atributos do item forem fornecidos, eles representarão o valor total dos itens após a multiplicação do preço unitário por item pela quantidade fornecida em ItemAttributes.
currencyCode

string

Código da moeda da transação. O código ISO 4217 de três letras é usado. Obrigatório.
conversionAction

string

O nome do recurso da ação de conversão que vai receber as conversões. Obrigatório.
orderId

string

ID do pedido da transação. Acessível apenas para clientes na lista de permissões.
customValue

string

Valor da variável personalizada de cada transação. Acessível apenas para clientes na lista de permissões.

StoreAttribute

Armazena os atributos da transação.

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

string

Código da loja de https://support.google.com/business/answer/3370250#storecode

ItemAttribute

Atributos do item da transação.

Representação JSON 
{
  "itemId": string,
  "countryCode": string,
  "languageCode": string,
  "quantity": string,
  "merchantId": string
}
Campos
itemId

string

Identificador exclusivo de um produto. Pode ser o ID do item do Merchant Center ou o GTIN (Número global do item comercial).
countryCode

string

Código de território comum do repositório de dados de localidade (CLDR, na sigla em inglês) do país associado ao feed em que seus itens são enviados. Consulte https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes para mais informações.
languageCode

string

Código ISO 639-1 do idioma associado ao feed em que seus itens são enviados.
quantity

string (int64 format)

Número de itens vendidos. O padrão é 1, caso não esteja definido.
merchantId

string (int64 format)

ID da conta do Merchant Center.

UserAttribute

O atributo do usuário só pode ser usado com o tipo de job CUSTOMER_MATCH_WITH_ATTRIBUTES.

Representação JSON 
{
  "lastPurchaseDateTime": string,
  "averagePurchaseCount": integer,
  "averagePurchaseValueMicros": string,
  "acquisitionDateTime": string,
  "lifecycleStage": string,
  "firstPurchaseDateTime": string,
  "eventAttribute": [
    {
      object (EventAttribute)
    }
  ],
  "lifetimeValueMicros": string,
  "lifetimeValueBucket": integer,
  "shoppingLoyalty": {
    object (ShoppingLoyalty)
  }
}
Campos
lastPurchaseDateTime

string

Carimbo de data/hora da última compra feita pelo usuário. O formato é AAAA-MM-DD HH:MM:SS[+/-HH:MM], em que [+/-HH:MM] é uma diferença de fuso horário opcional em relação ao UTC. Se ele não for informado, a API usará o fuso horário da conta como padrão.
averagePurchaseCount

integer

Número médio de compras definido pelo anunciante feitas pelo usuário em um período de 30 dias.
averagePurchaseValueMicros

string (int64 format)

O anunciante definiu o valor médio de compra em micros para o usuário.
acquisitionDateTime

string

Carimbo de data/hora em que o usuário foi adquirido. O formato é AAAA-MM-DD HH:MM:SS[+/-HH:MM], em que [+/-HH:MM] é uma diferença de fuso horário opcional em relação ao UTC. Se ele não for informado, a API usará o fuso horário da conta como padrão.
lifecycleStage

string

Opcional. Fase do ciclo de vida definida pelo anunciante para o usuário. Os valores aceitos são "Lead", "Ativo" e "Desligado".
firstPurchaseDateTime

string

Opcional. Carimbo de data/hora da primeira compra feita pelo usuário. O formato é AAAA-MM-DD HH:MM:SS[+/-HH:MM], em que [+/-HH:MM] é uma diferença de fuso horário opcional em relação ao UTC. Se ele não for informado, a API usará o fuso horário da conta como padrão.
eventAttribute[]

object (EventAttribute)

Opcional. Eventos definidos pelo anunciante e os atributos deles Todos os valores nos campos aninhados são obrigatórios. No momento, este campo está na versão Beta.
lifetimeValueMicros

string (int64 format)

Valor da vida útil definido pelo anunciante para o usuário.
lifetimeValueBucket

integer

Intervalo de valor da vida útil definido pelo anunciante para o usuário. O intervalo válido para um bucket de valor da vida útil é de 1 (baixo) a 10 (alto), exceto para operação de remoção, em que 0 também será aceito.
shoppingLoyalty

object (ShoppingLoyalty)

Os dados relacionados ao programa de fidelidade de compra. O Shopping utiliza esses dados para oferecer uma experiência melhor aos usuários. Acessível apenas a comerciantes na lista de permissões com o consentimento do usuário.

ShoppingLoyalty

Os dados relacionados ao programa de fidelidade de compra. O Shopping utiliza esses dados para oferecer uma experiência melhor aos usuários. Acessível apenas a comerciantes na lista de permissões.

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

string

O nível da assinatura. É uma string de formato livre, porque cada comerciante pode ter o próprio sistema de fidelidade. Por exemplo, pode ser um número de 1 a 10, uma string como "Ouro" ou "Prata", ou até mesmo uma string vazia "".

EventAttribute

Eventos definidos pelo anunciante e os atributos deles Todos os valores nos campos aninhados são obrigatórios.

Representação JSON 
{
  "event": string,
  "eventDateTime": string,
  "itemAttribute": [
    {
      object (EventItemAttribute)
    }
  ]
}
Campos
event

string

Obrigatório. Evento definido pelo anunciante que será usado para remarketing. Os valores aceitos são "Visualizado", "Carrinho", "Comprado" e "Recomendado".
eventDateTime

string

Obrigatório. Carimbo de data/hora em que o evento aconteceu. O formato é AAAA-MM-DD HH:MM:SS[+/-HH:MM], em que [+/-HH:MM] é uma diferença de fuso horário opcional em relação ao UTC. Se ele não for informado, a API usará o fuso horário da conta como padrão.
itemAttribute[]

object (EventItemAttribute)

Obrigatório. Atributos do item do evento.

EventItemAttribute

Atributos do item de evento da Segmentação por lista de clientes.

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

string

Opcional. Identificador exclusivo de um produto. Pode ser o ID do item do Merchant Center ou o GTIN (Número global do item comercial).