- JSON-представление
- Атрибут транзакции
- StoreAttribute
- Атрибут элемента
- Пользовательский атрибут
- ПокупкиЛояльность
- Атрибут События
- EventItemAttribute
Пользовательские данные, содержащие идентификаторы и атрибуты пользователей.
JSON-представление |
---|
{ "userIdentifiers": [ { object ( |
Поля | |
---|---|
userIdentifiers[] | Идентификационная информация пользователя. Необходимый. |
transactionAttribute | Дополнительные транзакции/атрибуты, связанные с пользователем. Требуется при обновлении данных о продажах в магазине. |
userAttribute | Дополнительные атрибуты, связанные с пользователем. Требуется при обновлении атрибутов электронных адресов клиентов. Срок их действия составляет 540 дней. |
Атрибут транзакции
Атрибут транзакции продажи магазина.
JSON-представление |
---|
{ "storeAttribute": { object ( |
Поля | |
---|---|
storeAttribute | Сохраните атрибуты транзакции. Доступно только клиентам из белого списка. |
itemAttribute | Атрибуты позиции транзакции. |
transactionDateTime | Временная метка, когда произошла транзакция. Необходимый. Формат: «ГГГГ-ММ-ДД ЧЧ:ММ:СС[+/-ЧЧ:ММ]», где [+/-ЧЧ:ММ] — необязательное смещение часового пояса от UTC. Если смещение отсутствует, API будет использовать часовой пояс учетной записи по умолчанию. Примеры: «2018-03-05 09:15:00» или «2018-02-01 14:34:30+03:00». |
transactionAmountMicros | Сумма транзакции в микронах. Необходимый. Сумма транзакции в микронах должна быть больше 1000. Если указаны атрибуты товара, она представляет собой общую стоимость товаров после умножения цены за единицу товара на количество, указанное в ItemAttributes. |
currencyCode | Код валюты транзакции. Используется трехбуквенный код ISO 4217. Необходимый. |
conversionAction | Название ресурса действия-конверсии, для которого нужно сообщить о конверсиях. Необходимый. |
orderId | Идентификатор заказа транзакции. Доступно только клиентам из белого списка. |
customValue | Значение пользовательской переменной для каждой транзакции. Доступно только клиентам из белого списка. |
StoreAttribute
Сохраните атрибуты транзакции.
JSON-представление |
---|
{ "storeCode": string } |
Поля | |
---|---|
storeCode | Код магазина: https://support.google.com/business/answer/3370250#storecode . |
Атрибут элемента
Атрибуты позиции транзакции.
JSON-представление |
---|
{ "itemId": string, "countryCode": string, "languageCode": string, "quantity": string, "merchantId": string } |
Поля | |
---|---|
itemId | Уникальный идентификатор товара. Это может быть либо идентификатор товара Merchant Center, либо GTIN (глобальный номер предмета торговли). |
countryCode | Код территории Common Locale Data Repository (CLDR) страны, связанной с фидом, в который загружаются ваши элементы. Дополнительную информацию см. на странице https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes . |
languageCode | Код языка ISO 639-1, связанный с фидом, в который загружаются ваши товары. |
quantity | Количество проданных товаров. По умолчанию 1, если не установлено. |
merchantId | Идентификатор аккаунта Merchant Center. |
Пользовательский атрибут
Атрибут пользователя можно использовать только с типом задания CUSTOMER_MATCH_WITH_ATTRIBUTES.
JSON-представление |
---|
{ "lastPurchaseDateTime": string, "averagePurchaseCount": integer, "averagePurchaseValueMicros": string, "acquisitionDateTime": string, "lifecycleStage": string, "firstPurchaseDateTime": string, "eventAttribute": [ { object ( |
Поля | |
---|---|
lastPurchaseDateTime | Временная метка последней покупки, совершенной пользователем. Формат: ГГГГ-ММ-ДД ЧЧ:ММ:СС[+/-ЧЧ:ММ], где [+/-ЧЧ:ММ] — необязательное смещение часового пояса от UTC. Если смещение отсутствует, API будет использовать часовой пояс учетной записи по умолчанию. |
averagePurchaseCount | Рекламодатель определил среднее количество покупок, совершенных пользователем за 30-дневный период. |
averagePurchaseValueMicros | Рекламодатель определил для пользователя среднюю стоимость покупки в микронах. |
acquisitionDateTime | Временная метка, когда пользователь был привлечен. Формат: ГГГГ-ММ-ДД ЧЧ:ММ:СС[+/-ЧЧ:ММ], где [+/-ЧЧ:ММ] — необязательное смещение часового пояса от UTC. Если смещение отсутствует, API будет использовать часовой пояс учетной записи по умолчанию. |
lifecycleStage | Необязательный. Стадию жизненного цикла пользователя определяет рекламодатель. Принимаемые значения: «Лид», «Активный» и «Отток». |
firstPurchaseDateTime | Необязательный. Временная метка первой покупки, совершенной пользователем. Формат: ГГГГ-ММ-ДД ЧЧ:ММ:СС[+/-ЧЧ:ММ], где [+/-ЧЧ:ММ] — необязательное смещение часового пояса от UTC. Если смещение отсутствует, API будет использовать часовой пояс учетной записи по умолчанию. |
eventAttribute[] | Необязательный. События и их атрибуты, определенные рекламодателем. Все значения во вложенных полях являются обязательными. В настоящее время это поле находится в стадии бета-тестирования. |
lifetimeValueMicros | Пожизненная ценность пользователя определяется рекламодателем. |
lifetimeValueBucket | Сегмент общей ценности, определенный рекламодателем для пользователя. Допустимый диапазон для сегмента значений за все время — от 1 (низкий) до 10 (высокий), за исключением операции удаления, где также принимается 0. |
shoppingLoyalty | Данные, связанные с покупательской лояльностью. Покупки используют эти данные, чтобы предоставить пользователям лучший опыт. Доступно только продавцам из белого списка с согласия пользователя. |
ПокупкиЛояльность
Данные, связанные с покупательской лояльностью. Покупки используют эти данные, чтобы предоставить пользователям лучший опыт. Доступно только продавцам из белого списка.
JSON-представление |
---|
{ "loyaltyTier": string } |
Поля | |
---|---|
loyaltyTier | Уровень членства. Это строка произвольной формы, поскольку у каждого продавца может быть своя система лояльности. Например, это может быть число от 1 до 10, строка типа «Золотой» или «Серебряный» или даже пустая строка «». |
Атрибут События
События и их атрибуты, определенные рекламодателем. Все значения во вложенных полях являются обязательными.
JSON-представление |
---|
{
"event": string,
"eventDateTime": string,
"itemAttribute": [
{
object ( |
Поля | |
---|---|
event | Необходимый. Определенное рекламодателем событие, которое будет использоваться для ремаркетинга. Принимаемые значения: «Просмотрено», «Корзина», «Куплено» и «Рекомендовано». |
eventDateTime | Необходимый. Временная метка, в которую произошло событие. Формат: ГГГГ-ММ-ДД ЧЧ:ММ:СС[+/-ЧЧ:ММ], где [+/-ЧЧ:ММ] — необязательное смещение часового пояса от UTC. Если смещение отсутствует, API будет использовать часовой пояс учетной записи по умолчанию. |
itemAttribute[] | Необходимый. Атрибуты элемента события. |
EventItemAttribute
Атрибуты элемента события списка электронных адресов.
JSON-представление |
---|
{ "itemId": string } |
Поля | |
---|---|
itemId | Необязательный. Уникальный идентификатор товара. Это может быть либо идентификатор товара Merchant Center, либо GTIN (глобальный номер предмета торговли). |