UserData

Datos del usuario que incluyen identificadores y atributos del usuario.

Representación JSON 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  }
}
Campos
userIdentifiers[]

object (UserIdentifier)

La información de identificación del usuario es obligatoria.
transactionAttribute

object (TransactionAttribute)

Transacciones o atributos adicionales asociados con el usuario Es obligatorio cuando se actualizan los datos de las ventas en la tienda.
userAttribute

object (UserAttribute)

Atributos adicionales asociados con el usuario. Es obligatorio cuando se actualizan los atributos de Segmentación por clientes. Vencen 540 días.

TransactionAttribute

Es el atributo de la transacción de ventas en la tienda.

Representación JSON 
{
  "storeAttribute": {
    object (StoreAttribute)
  },
  "itemAttribute": {
    object (ItemAttribute)
  },
  "transactionDateTime": string,
  "transactionAmountMicros": number,
  "currencyCode": string,
  "conversionAction": string,
  "orderId": string,
  "customValue": string
}
Campos
storeAttribute

object (StoreAttribute)

Almacena los atributos de la transacción. Accesible solo a clientes incluidos en la lista de entidades permitidas.
itemAttribute

object (ItemAttribute)

Atributos del artículo de la transacción.
transactionDateTime

string

Marca de tiempo del momento en que se realizó la transacción. Obligatorio. El formato es “AAAA-MM-DD HH:MM:SS[+/-HH:MM]”, en el que [+/-HH:MM] es un desplazamiento opcional de la zona horaria respecto de UTC. Si no aparece la compensación, la API usará la zona horaria de la cuenta de forma predeterminada. Ejemplos: "2018-03-05 09:15:00" o "2018-02-01 14:34:30+03:00"
transactionAmountMicros

number

Importe de la transacción en micros Obligatorio. El importe de la transacción en micros debe ser mayor que 1,000. Si se proporcionan los atributos de los artículos, representa el valor total de los artículos después de multiplicar el precio unitario por artículo por la cantidad proporcionada en ItemAttributes.
currencyCode

string

Es el código de moneda de la transacción. Se usa el código de tres letras ISO 4217. Obligatorio.
conversionAction

string

El nombre del recurso de la acción de conversión a la que se informarán las conversiones. Obligatorio.
orderId

string

Es el ID de pedido de la transacción. Accesible solo a clientes incluidos en la lista de entidades permitidas.
customValue

string

Es el valor de la variable personalizada para cada transacción. Accesible solo a clientes incluidos en la lista de entidades permitidas.

StoreAttribute

Almacena los atributos de la transacción.

Representación JSON 
{
  "storeCode": string
}
Campos
storeCode

string

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

ItemAttribute

Atributos del artículo de la transacción.

Representación JSON 
{
  "itemId": string,
  "countryCode": string,
  "languageCode": string,
  "quantity": string,
  "merchantId": string
}
Campos
itemId

string

Es un identificador único de un producto. Puede ser el ID de artículo de Merchant Center o el GTIN (código comercial global de artículo).
countryCode

string

Es el código de territorio del Repositorio Común de Datos de Configuración regional (CLDR) del país asociado al feed en el que se suben tus artículos. Para obtener más información, consulte https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes.
languageCode

string

Código ISO 639-1 del idioma asociado con el feed en el que se suben tus artículos
quantity

string (int64 format)

Indica la cantidad de artículos vendidos. Si la opción no está configurada, se establece en 1 de forma predeterminada.
merchantId

string (int64 format)

ID de la cuenta de Merchant Center.

UserAttribute

Atributo de usuario, solo se puede usar con el tipo de trabajo CUSTOMER_MATCH_WITH_ATTRIBUTES.

Representación 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

Marca de tiempo de la última compra que realizó el usuario El formato es AAAA-MM-DD HH:MM:SS[+/-HH:MM], donde [+/-HH:MM] es un desplazamiento opcional de la zona horaria de UTC. Si no aparece la compensación, la API usará la zona horaria de la cuenta de forma predeterminada.
averagePurchaseCount

integer

El anunciante definió la cantidad promedio de compras que realiza el usuario en un período de 30 días.
averagePurchaseValueMicros

string (int64 format)

El anunciante definió el valor de compra promedio en micros para el usuario.
acquisitionDateTime

string

Marca de tiempo en la que se adquirió el usuario. El formato es AAAA-MM-DD HH:MM:SS[+/-HH:MM], donde [+/-HH:MM] es un desplazamiento opcional de la zona horaria de UTC. Si no aparece la compensación, la API usará la zona horaria de la cuenta de forma predeterminada.
lifecycleStage

string

Opcional. La etapa del ciclo de vida que definió el anunciante para el usuario Los valores aceptados son "Cliente potencial", "Activo" y "Abandonado".
firstPurchaseDateTime

string

Opcional. Marca de tiempo de la primera compra que realizó el usuario El formato es AAAA-MM-DD HH:MM:SS[+/-HH:MM], donde [+/-HH:MM] es un desplazamiento opcional de la zona horaria de UTC. Si no aparece la compensación, la API usará la zona horaria de la cuenta de forma predeterminada.
eventAttribute[]

object (EventAttribute)

Opcional. Eventos definidos por el anunciante y sus atributos. Todos los valores de los campos anidados son obligatorios. Actualmente, este campo se encuentra en versión beta.
lifetimeValueMicros

string (int64 format)

El anunciante definió el valor del ciclo de vida del cliente para el usuario.
lifetimeValueBucket

integer

El anunciante definió el bucket de valor del ciclo de vida del cliente para el usuario. El rango válido para un bucket de valor del ciclo de vida del cliente es de 1 (bajo) a 10 (alto), excepto para la operación de quitar, en la que también se aceptará 0.
shoppingLoyalty

object (ShoppingLoyalty)

Son los datos relacionados con la lealtad de las compras. Shopping utiliza estos datos para brindarles a los usuarios una mejor experiencia. Accesible solo a los comercios incluidos en la lista de entidades permitidas con el consentimiento del usuario.

ShoppingLoyalty

Son los datos relacionados con la lealtad de las compras. Shopping utiliza estos datos para brindarles a los usuarios una mejor experiencia. Accesible solo a los comercios incluidos en la lista de entidades permitidas.

Representación JSON 
{
  "loyaltyTier": string
}
Campos
loyaltyTier

string

El nivel de membresía Es una cadena de formato libre, ya que cada comercio puede tener su propio sistema de lealtad. Por ejemplo, puede ser un número del 1 al 10, una cadena como "dorado" o "plateado", o incluso una cadena vacía "".

EventAttribute

Eventos definidos por el anunciante y sus atributos. Todos los valores de los campos anidados son obligatorios.

Representación JSON 
{
  "event": string,
  "eventDateTime": string,
  "itemAttribute": [
    {
      object (EventItemAttribute)
    }
  ]
}
Campos
event

string

Obligatorio. Es el evento definido por el anunciante que se utilizará para el remarketing. Los valores aceptados son "Viewed", "Cart", "Purchased" y "Recommended".
eventDateTime

string

Obligatorio. Marca de tiempo en la que ocurrió el evento. El formato es AAAA-MM-DD HH:MM:SS[+/-HH:MM], donde [+/-HH:MM] es un desplazamiento opcional de la zona horaria de UTC. Si no aparece la compensación, la API usará la zona horaria de la cuenta de forma predeterminada.
itemAttribute[]

object (EventItemAttribute)

Obligatorio. Atributos del artículo del evento.

EventItemAttribute

Atributos del elemento del evento de la Segmentación por clientes.

Representación JSON 
{
  "itemId": string
}
Campos
itemId

string

Opcional. Es un identificador único de un producto. Puede ser el ID de artículo de Merchant Center o el GTIN (código comercial global de artículo).