UserData

ข้อมูลผู้ใช้ที่เก็บตัวระบุและแอตทริบิวต์ผู้ใช้

การแสดง JSON 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  }
}
ช่อง
userIdentifiers[]

object (UserIdentifier)

ต้องระบุข้อมูลระบุตัวตนของผู้ใช้
transactionAttribute

object (TransactionAttribute)

ธุรกรรม/แอตทริบิวต์เพิ่มเติมที่เชื่อมโยงกับผู้ใช้ ต้องระบุเมื่ออัปเดตข้อมูลยอดขายในร้าน
userAttribute

object (UserAttribute)

แอตทริบิวต์เพิ่มเติมที่เชื่อมโยงกับผู้ใช้ ต้องระบุเมื่ออัปเดตแอตทริบิวต์การจับคู่ข้อมูลลูกค้า ซึ่งจะหมดอายุภายใน 540 วัน

TransactionAttribute

แอตทริบิวต์ของธุรกรรมยอดขายในร้าน

การแสดง JSON 
{
  "storeAttribute": {
    object (StoreAttribute)
  },
  "itemAttribute": {
    object (ItemAttribute)
  },
  "transactionDateTime": string,
  "transactionAmountMicros": number,
  "currencyCode": string,
  "conversionAction": string,
  "orderId": string,
  "customValue": string
}
ช่อง
storeAttribute

object (StoreAttribute)

แอตทริบิวต์ Store ของธุรกรรม ลูกค้าที่อยู่ในรายการที่อนุญาตเท่านั้นที่จะเข้าถึงได้
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

จำนวนเงินของธุรกรรมในระดับไมโคร ต้องระบุ จำนวนธุรกรรมในระดับไมโครต้องมากกว่า 1,000 หากระบุแอตทริบิวต์สินค้า แอตทริบิวต์ดังกล่าวจะแทนมูลค่ารวมของสินค้าหลังจากคูณราคาต่อหน่วยต่อสินค้าด้วยจำนวนที่ระบุใน ItemAttributes
currencyCode

string

รหัสสกุลเงินของธุรกรรม ระบบจะใช้รหัส 3 ตัวอักษรตามมาตรฐาน ISO 4217 ต้องระบุ
conversionAction

string

ชื่อทรัพยากรของการกระทำที่ถือเป็น Conversion ที่จะรายงาน Conversion ต้องระบุ
orderId

string

รหัสคำสั่งซื้อของธุรกรรม ลูกค้าที่อยู่ในรายการที่อนุญาตเท่านั้นที่จะเข้าถึงได้
customValue

string

ค่าของตัวแปรที่กำหนดเองสำหรับธุรกรรมแต่ละรายการ ลูกค้าที่อยู่ในรายการที่อนุญาตเท่านั้นที่จะเข้าถึงได้

StoreAttribute

แอตทริบิวต์ Store ของธุรกรรม

การแสดง 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 หรือ GTIN (หมายเลขสินค้าการค้าสากล) ก็ได้
countryCode

string

รหัสเขตแดน Common Locale Data Repository (CLDR) ของประเทศที่เชื่อมโยงกับฟีดที่อัปโหลดสินค้า ดูข้อมูลเพิ่มเติมได้ที่ https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes
languageCode

string

รหัส ISO 639-1 ของภาษาที่เชื่อมโยงกับฟีดที่อัปโหลดสินค้า
quantity

string (int64 format)

จํานวนสินค้าที่ขาย ค่าเริ่มต้นคือ 1 หากไม่ได้ตั้งค่าไว้
merchantId

string (int64 format)

รหัสของบัญชี Merchant Center

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

ไม่บังคับ ขั้นของวงจรที่ผู้ลงโฆษณากำหนดสำหรับผู้ใช้ ค่าที่ยอมรับคือ "Lead", "Active" และ "Churned"
firstPurchaseDateTime

string

ไม่บังคับ การประทับเวลาการซื้อครั้งแรกที่ผู้ใช้ทำ รูปแบบคือ YYYY-MM-DD HH:MM:SS[+/-HH:MM] โดยที่ [+/-HH:MM] เป็นค่าออฟเซ็ตเขตเวลาที่ไม่บังคับจาก UTC หากไม่มีออฟเซ็ต API จะใช้เขตเวลาของบัญชีเป็นค่าเริ่มต้น
eventAttribute[]

object (EventAttribute)

ไม่บังคับ เหตุการณ์ที่ผู้ลงโฆษณากำหนดและแอตทริบิวต์ ต้องระบุค่าทั้งหมดในช่องที่ซ้อนกัน ปัจจุบันช่องนี้อยู่ในเวอร์ชันเบต้า
lifetimeValueMicros

string (int64 format)

มูลค่าตลอดอายุการใช้งานที่ผู้ลงโฆษณากำหนดสำหรับผู้ใช้
lifetimeValueBucket

integer

ที่เก็บข้อมูลมูลค่าตลอดอายุการใช้งานที่ผู้ลงโฆษณากำหนดสำหรับผู้ใช้ ช่วงที่ถูกต้องสำหรับที่เก็บข้อมูลมูลค่าตลอดอายุการใช้งานคือตั้งแต่ 1 (ต่ำ) ถึง 10 (สูง) ยกเว้นการดำเนินการนำออกที่ระบบจะยอมรับ 0 ด้วย
shoppingLoyalty

object (ShoppingLoyalty)

ข้อมูลที่เกี่ยวข้องกับความภักดีในการช็อปปิ้ง โดย Shopping จะใช้ข้อมูลนี้เพื่อมอบประสบการณ์การใช้งานที่ดียิ่งขึ้นให้แก่ผู้ใช้ เข้าถึงได้เฉพาะผู้ขายในรายการที่อนุญาตเมื่อได้รับความยินยอมจากผู้ใช้

ShoppingLoyalty

ข้อมูลที่เกี่ยวข้องกับความภักดีในการช็อปปิ้ง โดย Shopping จะใช้ข้อมูลนี้เพื่อมอบประสบการณ์การใช้งานที่ดียิ่งขึ้นให้แก่ผู้ใช้ เข้าถึงได้สำหรับผู้ขายในรายการที่อนุญาตเท่านั้น

การแสดง 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 หรือ GTIN (หมายเลขสินค้าการค้าสากล) ก็ได้