UserData

包含用户标识符和属性的用户数据。

JSON 表示法 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  },
  "consent": {
    object (Consent)
  }
}
字段
userIdentifiers[]

object (UserIdentifier)

用户识别信息。必填。
transactionAttribute

object (TransactionAttribute)

与用户关联的其他交易/属性。更新实体店销售数据时必须提供。
userAttribute

object (UserAttribute)

与用户相关联的其他属性。更新目标客户匹配属性时必填。这类视频的有效期为 540 天。
consent

object (Consent)

用户的意见征求设置。目标客户匹配将忽略此字段并返回警告。

TransactionAttribute

实体店销售交易的属性。

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

交易发生的时间戳。必需。格式为“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

number

交易金额（以微单位表示）。必需。交易金额（以微单位表示）必须大于 1000。如果提供了商品属性，则此值表示将每件商品的单价乘以 ItemAttributes 中提供的数量后的商品总值。
currencyCode

string

交易货币代码。此规范使用的是由三个字母组成的 ISO 4217 代码。必填。
conversionAction

string

要报告转化次数的转化操作的资源名称。必填。
orderId

string

交易订单 ID。仅限许可名单中的客户访问。
customValue

string

每笔交易的自定义变量的值。仅限许可名单中的客户访问。

StoreAttribute

存储交易的属性。

JSON 表示法 
{
  "storeCode": string
}
字段
storeCode

string

商店代码网址：https://support.google.com/business/answer/3370250#storecode

ItemAttribute

交易的商品属性。

JSON 表示法 
{
  "itemId": string,
  "countryCode": string,
  "languageCode": string,
  "quantity": string,
  "merchantId": string
}
字段
itemId

string

商品的唯一标识符。可以是 Merchant Center 商品 ID 或 GTIN（全球贸易项目代码）。
countryCode

string

您用来上传商品数据的 Feed 所关联的国家/地区的通用语言区域数据存储库 (CLDR) 地区代码。如需了解详情，请访问 https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes。
languageCode

string

您用来上传商品的 Feed 所关联的语言的 ISO 639-1 代码
quantity

string (int64 format)

售出的商品数量。如果未设置，则默认为 1。
merchantId

string (int64 format)

Merchant Center 帐号的 ID。

UserAttribute

用户属性，只能与 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

用户最近一次购买交易的时间戳。格式为 YYYY-MM-DD HH:MM:SS[+/-HH:MM]，其中 [+/-HH:MM] 是相对于世界协调时间 (UTC) 的可选时区偏移量。如果缺少该偏移量，该 API 将默认使用帐号的时区。
averagePurchaseCount

integer

广告客户定义的用户在 30 天内的平均购买次数。
averagePurchaseValueMicros

string (int64 format)

广告客户定义的用户平均购买价值（以微单位表示）。
acquisitionDateTime

string

获取用户时的时间戳。格式为 YYYY-MM-DD HH:MM:SS[+/-HH:MM]，其中 [+/-HH:MM] 是相对于世界协调时间 (UTC) 的可选时区偏移量。如果缺少该偏移量，该 API 将默认使用帐号的时区。
lifecycleStage

string

可选。由广告客户定义的用户生命周期阶段。可接受的值为“潜在客户”“有效”和“客户流失”。
firstPurchaseDateTime

string

可选。用户首次购买的时间戳。格式为 YYYY-MM-DD HH:MM:SS[+/-HH:MM]，其中 [+/-HH:MM] 是相对于世界协调时间 (UTC) 的可选时区偏移量。如果缺少该偏移量，该 API 将默认使用帐号的时区。
eventAttribute[]

object (EventAttribute)

可选。由广告客户定义的事件及其属性。嵌套字段中的所有值均为必填字段。此字段目前为 Beta 版。
lifetimeValueMicros

string (int64 format)

广告客户为用户定义的生命周期价值。
lifetimeValueBucket

integer

广告客户为用户定义的生命周期价值范围。生命周期价值范围的有效范围为 1（低）到 10（高），但接受 0 的移除操作除外。
shoppingLoyalty

object (ShoppingLoyalty)

与购物会员卡相关的数据。Google 购物会利用这些数据为用户提供更好的体验。只有在用户同意的情况下，允许名单中的商家才能访问。

ShoppingLoyalty

与购物会员卡相关的数据。Google 购物会利用这些数据为用户提供更好的体验。仅限许可名单中的商家访问。

JSON 表示法 
{
  "loyaltyTier": string
}
字段
loyaltyTier

string

会员级别。这是一个自由格式的字符串，因为每个商家可能都有自己的会员系统。例如，可以是 1 到 10 之间的数字，可以是“Golden”或“Silver”之类的字符串，也可以是空字符串“"”。

EventAttribute

由广告客户定义的事件及其属性。嵌套字段中的所有值均为必填字段。

JSON 表示法 
{
  "event": string,
  "eventDateTime": string,
  "itemAttribute": [
    {
      object (EventItemAttribute)
    }
  ]
}
字段
event

string

必需。用于再营销的由广告客户定义的事件。可接受的值为“已查看”“购物车”“已购买”和“推荐”。
eventDateTime

string

必需。事件发生时的时间戳。格式为 YYYY-MM-DD HH:MM:SS[+/-HH:MM]，其中 [+/-HH:MM] 是相对于世界协调时间 (UTC) 的可选时区偏移量。如果缺少该偏移量，该 API 将默认使用帐号的时区。
itemAttribute[]

object (EventItemAttribute)

必需。事件的商品属性。

EventItemAttribute

目标客户匹配的事件项目属性。

JSON 表示法 
{
  "itemId": string
}
字段
itemId

string

可选。商品的唯一标识符。可以是 Merchant Center 商品 ID 或 GTIN（全球贸易项目代码）。