UserData

Пользовательские данные, содержащие идентификаторы и атрибуты пользователей.

JSON-представление
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  }
}
Поля
userIdentifiers[]

object ( UserIdentifier )

Идентификационная информация пользователя. Необходимый.

transactionAttribute

object ( TransactionAttribute )

Дополнительные транзакции/атрибуты, связанные с пользователем. Требуется при обновлении данных о продажах в магазине.

userAttribute

object ( UserAttribute )

Дополнительные атрибуты, связанные с пользователем. Требуется при обновлении атрибутов электронных адресов клиентов. Срок их действия составляет 540 дней.

Атрибут транзакции

Атрибут транзакции продажи магазина.

JSON-представление
{
  "storeAttribute": {
    object (StoreAttribute)
  },
  "itemAttribute": {
    object (ItemAttribute)
  },
  "transactionDateTime": string,
  "transactionAmountMicros": number,
  "currencyCode": string,
  "conversionAction": string,
  "orderId": string,
  "customValue": string
}
Поля
storeAttribute

object ( StoreAttribute )

Сохраните атрибуты транзакции. Доступно только клиентам из белого списка.

itemAttribute

object ( ItemAttribute )

Атрибуты позиции транзакции.

transactionDateTime

string

Временная метка, когда произошла транзакция. Необходимый. Формат: «ГГГГ-ММ-ДД ЧЧ:ММ:СС[+/-ЧЧ:ММ]», где [+/-ЧЧ:ММ] — необязательное смещение часового пояса от UTC. Если смещение отсутствует, API будет использовать часовой пояс учетной записи по умолчанию. Примеры: «2018-03-05 09:15:00» или «2018-02-01 14:34:30+03:00».

transactionAmountMicros

number

Сумма транзакции в микронах. Необходимый. Сумма транзакции в микронах должна быть больше 1000. Если указаны атрибуты товара, она представляет собой общую стоимость товаров после умножения цены за единицу товара на количество, указанное в ItemAttributes.

currencyCode

string

Код валюты транзакции. Используется трехбуквенный код ISO 4217. Необходимый.

conversionAction

string

Название ресурса действия-конверсии, для которого нужно сообщить о конверсиях. Необходимый.

orderId

string

Идентификатор заказа транзакции. Доступно только клиентам из белого списка.

customValue

string

Значение пользовательской переменной для каждой транзакции. Доступно только клиентам из белого списка.

StoreAttribute

Сохраните атрибуты транзакции.

JSON-представление
{
  "storeCode": string
}
Поля
storeCode

string

Код магазина: https://support.google.com/business/answer/3370250#storecode .

Атрибут элемента

Атрибуты позиции транзакции.

JSON-представление
{
  "itemId": string,
  "countryCode": string,
  "languageCode": string,
  "quantity": string,
  "merchantId": string
}
Поля
itemId

string

Уникальный идентификатор товара. Это может быть либо идентификатор товара Merchant Center, либо GTIN (глобальный номер предмета торговли).

countryCode

string

Код территории Common Locale Data Repository (CLDR) страны, связанной с фидом, в который загружаются ваши элементы. Дополнительную информацию см. на странице https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes .

languageCode

string

Код языка ISO 639-1, связанный с фидом, в который загружаются ваши товары.

quantity

string ( int64 format)

Количество проданных товаров. По умолчанию 1, если не установлено.

merchantId

string ( int64 format)

Идентификатор аккаунта Merchant Center.

Пользовательский атрибут

Атрибут пользователя можно использовать только с типом задания CUSTOMER_MATCH_WITH_ATTRIBUTES.

JSON-представление
{
  "lastPurchaseDateTime": string,
  "averagePurchaseCount": integer,
  "averagePurchaseValueMicros": string,
  "acquisitionDateTime": string,
  "lifecycleStage": string,
  "firstPurchaseDateTime": string,
  "eventAttribute": [
    {
      object (EventAttribute)
    }
  ],
  "lifetimeValueMicros": string,
  "lifetimeValueBucket": integer,
  "shoppingLoyalty": {
    object (ShoppingLoyalty)
  }
}
Поля
lastPurchaseDateTime

string

Временная метка последней покупки, совершенной пользователем. Формат: ГГГГ-ММ-ДД ЧЧ:ММ:СС[+/-ЧЧ:ММ], где [+/-ЧЧ:ММ] — необязательное смещение часового пояса от UTC. Если смещение отсутствует, API будет использовать часовой пояс учетной записи по умолчанию.

averagePurchaseCount

integer

Рекламодатель определил среднее количество покупок, совершенных пользователем за 30-дневный период.

averagePurchaseValueMicros

string ( int64 format)

Рекламодатель определил для пользователя среднюю стоимость покупки в микронах.

acquisitionDateTime

string

Временная метка, когда пользователь был привлечен. Формат: ГГГГ-ММ-ДД ЧЧ:ММ:СС[+/-ЧЧ:ММ], где [+/-ЧЧ:ММ] — необязательное смещение часового пояса от UTC. Если смещение отсутствует, API будет использовать часовой пояс учетной записи по умолчанию.

lifecycleStage

string

Необязательный. Стадию жизненного цикла пользователя определяет рекламодатель. Принимаемые значения: «Лид», «Активный» и «Отток».

firstPurchaseDateTime

string

Необязательный. Временная метка первой покупки, совершенной пользователем. Формат: ГГГГ-ММ-ДД ЧЧ:ММ:СС[+/-ЧЧ:ММ], где [+/-ЧЧ:ММ] — необязательное смещение часового пояса от UTC. Если смещение отсутствует, API будет использовать часовой пояс учетной записи по умолчанию.

eventAttribute[]

object ( EventAttribute )

Необязательный. События и их атрибуты, определенные рекламодателем. Все значения во вложенных полях являются обязательными. В настоящее время это поле находится в стадии бета-тестирования.

lifetimeValueMicros

string ( int64 format)

Пожизненная ценность пользователя определяется рекламодателем.

lifetimeValueBucket

integer

Сегмент общей ценности, определенный рекламодателем для пользователя. Допустимый диапазон для сегмента значений за все время — от 1 (низкий) до 10 (высокий), за исключением операции удаления, где также принимается 0.

shoppingLoyalty

object ( ShoppingLoyalty )

Данные, связанные с покупательской лояльностью. Покупки используют эти данные, чтобы предоставить пользователям лучший опыт. Доступно только продавцам из белого списка с согласия пользователя.

ПокупкиЛояльность

Данные, связанные с покупательской лояльностью. Покупки используют эти данные, чтобы предоставить пользователям лучший опыт. Доступно только продавцам из белого списка.

JSON-представление
{
  "loyaltyTier": string
}
Поля
loyaltyTier

string

Уровень членства. Это строка произвольной формы, поскольку у каждого продавца может быть своя система лояльности. Например, это может быть число от 1 до 10, строка типа «Золотой» или «Серебряный» или даже пустая строка «».

Атрибут События

События и их атрибуты, определенные рекламодателем. Все значения во вложенных полях являются обязательными.

JSON-представление
{
  "event": string,
  "eventDateTime": string,
  "itemAttribute": [
    {
      object (EventItemAttribute)
    }
  ]
}
Поля
event

string

Необходимый. Определенное рекламодателем событие, которое будет использоваться для ремаркетинга. Принимаемые значения: «Просмотрено», «Корзина», «Куплено» и «Рекомендовано».

eventDateTime

string

Необходимый. Временная метка, в которую произошло событие. Формат: ГГГГ-ММ-ДД ЧЧ:ММ:СС[+/-ЧЧ:ММ], где [+/-ЧЧ:ММ] — необязательное смещение часового пояса от UTC. Если смещение отсутствует, API будет использовать часовой пояс учетной записи по умолчанию.

itemAttribute[]

object ( EventItemAttribute )

Необходимый. Атрибуты элемента события.

EventItemAttribute

Атрибуты элемента события списка электронных адресов.

JSON-представление
{
  "itemId": string
}
Поля
itemId

string

Необязательный. Уникальный идентификатор товара. Это может быть либо идентификатор товара Merchant Center, либо GTIN (глобальный номер предмета торговли).