- JSON 表示法
- TransactionAttribute
- StoreAttribute
- ItemAttribute
- UserAttribute
- ShoppingLoyalty
- EventAttribute
- EventItemAttribute
包含用户标识符和属性的用户数据。
JSON 表示法 |
---|
{ "userIdentifiers": [ { object ( |
字段 | |
---|---|
userIdentifiers[] |
用户身份信息。必填。 |
transactionAttribute |
与用户关联的其他交易/属性。更新实体店销售数据时必须提供。 |
userAttribute |
与用户关联的其他属性。更新目标客户匹配属性时必填。这类交易的有效期为 540 天。 |
consent |
用户的意见征求设置。目标客户匹配功能会忽略此字段并返回一条警告。 |
TransactionAttribute
实体店销售交易的属性。
JSON 表示法 |
---|
{ "storeAttribute": { object ( |
字段 | |
---|---|
storeAttribute |
存储交易的属性。只有许可名单中的客户才能访问。 |
itemAttribute |
交易的商品属性。 |
transactionDateTime |
交易发生的时间戳。必需。格式为“YYYY-MM-DD HH:MM:SS[+/-HH:MM]”,其中 [+/-HH:MM] 是相对于世界协调时间 (UTC) 的可选时区偏移量。如果缺少偏移量,该 API 将默认使用帐号的时区。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30+03:00” |
transactionAmountMicros |
交易金额(以微单位表示)。必需。交易金额(以微单位表示)必须大于 1000。如果提供了商品属性,则表示用每件商品的单价乘以 ItemAttributes 中提供的数量后,商品的总价值。 |
currencyCode |
交易货币代码。采用由三个字母组成的 ISO 4217 代码。必填。 |
conversionAction |
要报告转化次数的转化操作的资源名称。必填。 |
orderId |
交易订单 ID。只有许可名单中的客户才能访问。 |
customValue |
每笔交易的自定义变量的值。只有许可名单中的客户才能访问。 |
StoreAttribute
存储交易的属性。
JSON 表示法 |
---|
{ "storeCode": string } |
字段 | |
---|---|
storeCode |
商店代码(来自 https://support.google.com/business/answer/3370250#storecode) |
ItemAttribute
交易的商品属性。
JSON 表示法 |
---|
{ "itemId": string, "countryCode": string, "languageCode": string, "quantity": string, "merchantId": string } |
字段 | |
---|---|
itemId |
商品的唯一标识符。它可以是 Merchant Center 商品 ID 或 GTIN(全球贸易项目代码)。 |
countryCode |
您用来上传商品数据的 Feed 所关联的国家/地区的通用语言区域数据代码库 (CLDR) 地区代码。如需了解详情,请参阅 https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes。 |
languageCode |
与您上传的商品的 Feed 相关联的语言的 ISO 639-1 代码 |
quantity |
售出的商品数量。如果未设置,则默认为 1。 |
merchantId |
Merchant Center 帐号的 ID。 |
UserAttribute
用户属性,只能与 CUSTOMER_MATCH_WITH_ATTRIBUTES 作业类型一起使用。
JSON 表示法 |
---|
{ "lastPurchaseDateTime": string, "averagePurchaseCount": integer, "averagePurchaseValueMicros": string, "acquisitionDateTime": string, "lifecycleStage": string, "firstPurchaseDateTime": string, "eventAttribute": [ { object ( |
字段 | |
---|---|
lastPurchaseDateTime |
用户最近一次购物的时间戳。格式为 YYYY-MM-DD HH:MM:SS[+/-HH:MM],其中 [+/-HH:MM] 是相对于世界协调时间 (UTC) 的时区偏移量(可选)。如果缺少偏移量,该 API 将默认使用帐号的时区。 |
averagePurchaseCount |
由广告客户定义的用户在 30 天内的平均购买次数。 |
averagePurchaseValueMicros |
广告客户定义的用户平均购买价值(以微单位表示)。 |
acquisitionDateTime |
获取用户时的时间戳。格式为 YYYY-MM-DD HH:MM:SS[+/-HH:MM],其中 [+/-HH:MM] 是相对于世界协调时间 (UTC) 的时区偏移量(可选)。如果缺少偏移量,该 API 将默认使用帐号的时区。 |
lifecycleStage |
可选。广告客户为用户定义的生命周期阶段。可接受的值为“潜在客户”“有效”和“流失”。 |
firstPurchaseDateTime |
可选。用户首次购买的时间戳。格式为 YYYY-MM-DD HH:MM:SS[+/-HH:MM],其中 [+/-HH:MM] 是相对于世界协调时间 (UTC) 的时区偏移量(可选)。如果缺少偏移量,该 API 将默认使用帐号的时区。 |
eventAttribute[] |
可选。广告客户定义的事件及其属性。嵌套字段中的所有值均为必需值。此字段目前处于测试阶段。 |
lifetimeValueMicros |
广告客户为用户定义的生命周期价值。 |
lifetimeValueBucket |
广告客户为用户定义的生命周期价值范围。生命周期价值范围的有效范围为 1(低)到 10(高),但移除操作也可以接受 0。 |
shoppingLoyalty |
与购物忠诚度相关的数据。Google 购物会利用这些数据为用户提供更好的体验。只有在用户同意的情况下,许可名单中的商家才能访问。 |
ShoppingLoyalty
与购物忠诚度相关的数据。Google 购物会利用这些数据为用户提供更好的体验。只有许可名单中的商家可以使用。
JSON 表示法 |
---|
{ "loyaltyTier": string } |
字段 | |
---|---|
loyaltyTier |
会员级别。这是一个自由格式的字符串,因为每个商家可能都有自己的会员系统。例如,可以是 1 到 10 之间的数字,可以是“Golden”或“Silver”之类的字符串,也可以是空字符串“”。 |
EventAttribute
广告客户定义的事件及其属性。嵌套字段中的所有值均为必需值。
JSON 表示法 |
---|
{
"event": string,
"eventDateTime": string,
"itemAttribute": [
{
object ( |
字段 | |
---|---|
event |
必需。将用于再营销的广告客户定义的事件。可接受的值为“已查看”“购物车”“已购买”和“推荐”。 |
eventDateTime |
必需。事件发生的时间戳。格式为 YYYY-MM-DD HH:MM:SS[+/-HH:MM],其中 [+/-HH:MM] 是相对于世界协调时间 (UTC) 的时区偏移量(可选)。如果缺少偏移量,该 API 将默认使用帐号的时区。 |
itemAttribute[] |
必需。事件的商品属性。 |
EventItemAttribute
目标客户匹配的事件商品属性。
JSON 表示法 |
---|
{ "itemId": string } |
字段 | |
---|---|
itemId |
可选。商品的唯一标识符。它可以是 Merchant Center 商品 ID 或 GTIN(全球贸易项目代码)。 |