- JSON 表示法
- TransactionAttribute
- StoreAttribute
- ItemAttribute
- UserAttribute
- ShoppingLoyalty
- EventAttribute
- EventItemAttribute
保留使用者 ID 和屬性的使用者資料。
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 |
產品的專屬 ID。可以是 Merchant Center 項目 ID 或全球交易品項識別碼 (GTIN)。 |
countryCode |
與上傳商品所在動態饋給相關聯的國家/地區通用語言代碼資料存放區 (CLDR) 地域代碼。詳情請參閱 https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes。 |
languageCode |
與上傳商品所在動態饋給相關聯的語言 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 |
選用設定。由廣告主為使用者定義的生命週期階段。可接受的值為「Lead」、「Active」和「Churned」。 |
firstPurchaseDateTime |
選用設定。使用者首次購買時間戳記。格式為 YYYY-MM-DD HH:MM:SS[+/-HH:MM],其中 [+/-HH:MM] 是與世界標準時間 (UTC) 的選用時區偏移值。如果缺少偏移值,API 會使用帳戶的時區做為預設值。 |
eventAttribute[] |
選用設定。廣告客戶定義的事件及其屬性。巢狀欄位中的所有值皆為必填。這個欄位目前為 Beta 版。 |
lifetimeValueMicros |
廣告主為使用者定義的生命週期價值。 |
lifetimeValueBucket |
廣告主為使用者定義的生命週期價值區間。生命週期值範圍的有效範圍介於 1 (低) 到 10 (高),但可接受 0 的移除作業除外。 |
shoppingLoyalty |
購物忠誠度相關資料。Google 購物可運用這項資料為使用者提供更優質的體驗。經使用者同意後,才能使用許可清單中的商家。 |
ShoppingLoyalty
購物忠誠度相關資料。Google 購物可運用這項資料為使用者提供更優質的體驗。僅適用於許可清單中的商家。
JSON 表示法 |
---|
{ "loyaltyTier": string } |
欄位 | |
---|---|
loyaltyTier |
會員層級。這是任意格式的字串,因為每個商家都有自己的會員系統。舉例來說,這可以是 1 到 10 之間的數字,或是「黃金」或「銀」等字串,甚至是空字串 ""。 |
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 |
選用設定。產品的專屬 ID。可以是 Merchant Center 項目 ID 或全球交易品項識別碼 (GTIN)。 |