- การแสดง 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 |
จำนวนเงินของธุรกรรมในหน่วยไมโคร ต้องระบุ จำนวนเงินของธุรกรรมในระดับไมโครต้องมากกว่า 1,000 หากระบุแอตทริบิวต์สินค้า แอตทริบิวต์นี้จะแสดงมูลค่ารวมของสินค้าหลังจากคูณราคาต่อหน่วยต่อสินค้าด้วยจำนวนที่ระบุใน itemAttributes |
currencyCode |
รหัสสกุลเงินที่ทำธุรกรรม ใช้รหัส 3 ตัวอักษรตามมาตรฐาน ISO 4217 ต้องระบุ |
conversionAction |
ชื่อทรัพยากรของการกระทำที่ถือเป็น Conversion ที่จะรายงาน Conversion ต้องระบุ |
orderId |
รหัสคำสั่งซื้อของธุรกรรม เฉพาะลูกค้าที่อยู่ในรายการที่อนุญาตเท่านั้นที่จะเข้าถึงได้ |
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 หรือ 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 |
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 |
ข้อมูลที่เกี่ยวข้องกับโปรแกรมสะสมคะแนน Shopping Shopping ใช้ข้อมูลนี้เพื่อมอบประสบการณ์การใช้งานที่ดียิ่งขึ้นให้แก่ผู้ใช้ เข้าถึงได้สำหรับผู้ขายในรายการที่อนุญาตเมื่อได้รับความยินยอมจากผู้ใช้เท่านั้น |
ShoppingLoyalty
ข้อมูลที่เกี่ยวข้องกับโปรแกรมสะสมคะแนน Shopping Shopping ใช้ข้อมูลนี้เพื่อมอบประสบการณ์การใช้งานที่ดียิ่งขึ้นให้แก่ผู้ใช้ เข้าถึงได้สำหรับผู้ขายในรายการที่อนุญาตเท่านั้น
การแสดง 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 หรือ GTIN (หมายเลขสินค้าการค้าสากล) ก็ได้ |