UserData

Dữ liệu người dùng lưu giữ giá trị nhận dạng và thuộc tính người dùng.

Biểu diễn dưới dạng JSON 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  },
  "consent": {
    object (Consent)
  }
}
Trường
userIdentifiers[]

object (UserIdentifier)

Thông tin nhận dạng người dùng. Bắt buộc.
transactionAttribute

object (TransactionAttribute)

Các giao dịch/thuộc tính bổ sung được liên kết với người dùng. Bắt buộc khi cập nhật dữ liệu lượt bán hàng tại cửa hàng thực tế.
userAttribute

object (UserAttribute)

Các thuộc tính bổ sung liên kết với người dùng. Bắt buộc khi cập nhật các thuộc tính so khớp khách hàng. Những thông báo này sẽ hết hạn sau 540 ngày.
consent

object (Consent)

Chế độ cài đặt về sự đồng ý cho người dùng. Tính năng So khớp khách hàng sẽ bỏ qua trường này và trả về một cảnh báo.

TransactionAttribute

Thuộc tính của giao dịch bán hàng tại cửa hàng thực tế.

Biểu diễn dưới dạng JSON 
{
  "storeAttribute": {
    object (StoreAttribute)
  },
  "itemAttribute": {
    object (ItemAttribute)
  },
  "transactionDateTime": string,
  "transactionAmountMicros": number,
  "currencyCode": string,
  "conversionAction": string,
  "orderId": string,
  "customValue": string
}
Trường
storeAttribute

object (StoreAttribute)

Lưu trữ các thuộc tính của giao dịch. Chỉ những khách hàng trong danh sách cho phép mới truy cập được.
itemAttribute

object (ItemAttribute)

Thuộc tính mặt hàng của giao dịch.
transactionDateTime

string

Dấu thời gian khi giao dịch diễn ra. Bắt buộc. Định dạng là "YYYY-MM-DD HH:MM:SS[+/-HH:MM]", trong đó [+/-HH:MM] là giá trị chênh lệch múi giờ (không bắt buộc) so với giờ UTC. Nếu không có mức chênh lệch, API sẽ sử dụng múi giờ của tài khoản làm mặc định. Ví dụ: "2018-03-05 09:15:00" hoặc "2018-02-01 14:34:30+03:00"
transactionAmountMicros

number

Số tiền giao dịch tính bằng một phần triệu. Bắt buộc. Số tiền giao dịch tính bằng một phần triệu cần lớn hơn 1.000. Nếu bạn cung cấp Thuộc tính mặt hàng, thuộc tính này sẽ thể hiện tổng giá trị của các mặt hàng, sau khi nhân đơn giá của mỗi mặt hàng với số lượng được cung cấp trong ItemAttributes.
currencyCode

string

Mã đơn vị tiền tệ của giao dịch. Mã gồm ba chữ cái theo ISO 4217 được sử dụng. Bắt buộc.
conversionAction

string

Tên tài nguyên của hành động chuyển đổi để báo cáo lượt chuyển đổi. Bắt buộc.
orderId

string

Mã đơn đặt hàng giao dịch. Chỉ những khách hàng trong danh sách cho phép mới truy cập được.
customValue

string

Giá trị của biến tuỳ chỉnh cho từng giao dịch. Chỉ những khách hàng trong danh sách cho phép mới truy cập được.

StoreAttribute

Lưu trữ các thuộc tính của giao dịch.

Biểu diễn dưới dạng JSON 
{
  "storeCode": string
}
Trường
storeCode

string

Mã cửa hàng từ https://support.google.com/business/answer/3370250#storecode

ItemAttribute

Thuộc tính mặt hàng của giao dịch.

Biểu diễn dưới dạng JSON 
{
  "itemId": string,
  "countryCode": string,
  "languageCode": string,
  "quantity": string,
  "merchantId": string
}
Trường
itemId

string

Mã nhận dạng duy nhất của một sản phẩm. Đó có thể là Mã mặt hàng Merchant Center hoặc GTIN (Mã số sản phẩm thương mại toàn cầu).
countryCode

string

Mã lãnh thổ của Kho lưu trữ dữ liệu ngôn ngữ chung (CLDR) của quốc gia liên kết với nguồn cấp dữ liệu chứa các mặt hàng mà bạn tải lên. Hãy tham khảo https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes để biết thêm thông tin.
languageCode

string

Mã ISO 639-1 của ngôn ngữ liên kết với nguồn cấp dữ liệu chứa mặt hàng mà bạn đã tải lên
quantity

string (int64 format)

Số lượng mặt hàng đã bán ra. Giá trị mặc định là 1 nếu không được đặt.
merchantId

string (int64 format)

Mã nhận dạng của tài khoản Merchant Center.

UserAttribute

Chỉ có thể sử dụng thuộc tính người dùng với loại công việc CUSTOMER_MATCH_WITH_ATTRIBUTES.

Biểu diễn dưới dạng JSON 
{
  "lastPurchaseDateTime": string,
  "averagePurchaseCount": integer,
  "averagePurchaseValueMicros": string,
  "acquisitionDateTime": string,
  "lifecycleStage": string,
  "firstPurchaseDateTime": string,
  "eventAttribute": [
    {
      object (EventAttribute)
    }
  ],
  "lifetimeValueMicros": string,
  "lifetimeValueBucket": integer,
  "shoppingLoyalty": {
    object (ShoppingLoyalty)
  }
}
Trường
lastPurchaseDateTime

string

Dấu thời gian của giao dịch mua gần đây nhất mà người dùng thực hiện. Định dạng là YYYY-MM-DD HH:MM:SS[+/-HH:MM], trong đó [+/-HH:MM] là giá trị chênh lệch múi giờ (không bắt buộc) so với giờ UTC. Nếu không có mức chênh lệch, API sẽ sử dụng múi giờ của tài khoản làm mặc định.
averagePurchaseCount

integer

Nhà quảng cáo đã xác định số giao dịch mua trung bình mà người dùng thực hiện trong khoảng thời gian 30 ngày.
averagePurchaseValueMicros

string (int64 format)

Nhà quảng cáo đã xác định giá trị giao dịch mua trung bình theo phần triệu cho người dùng.
acquisitionDateTime

string

Dấu thời gian khi người dùng được thu nạp. Định dạng là YYYY-MM-DD HH:MM:SS[+/-HH:MM], trong đó [+/-HH:MM] là giá trị chênh lệch múi giờ (không bắt buộc) so với giờ UTC. Nếu không có mức chênh lệch, API sẽ sử dụng múi giờ của tài khoản làm mặc định.
lifecycleStage

string

Không bắt buộc. Giai đoạn trong vòng đời do nhà quảng cáo xác định cho người dùng. Các giá trị được chấp nhận là "Khách hàng tiềm năng", "Đang hoạt động" và "Đã rời bỏ ứng dụng".
firstPurchaseDateTime

string

Không bắt buộc. Dấu thời gian của giao dịch mua đầu tiên do người dùng thực hiện. Định dạng là YYYY-MM-DD HH:MM:SS[+/-HH:MM], trong đó [+/-HH:MM] là giá trị chênh lệch múi giờ (không bắt buộc) so với giờ UTC. Nếu không có mức chênh lệch, API sẽ sử dụng múi giờ của tài khoản làm mặc định.
eventAttribute[]

object (EventAttribute)

Không bắt buộc. Các sự kiện do nhà quảng cáo xác định và các thuộc tính của những sự kiện đó. Bạn phải nhập tất cả giá trị trong các trường lồng nhau. Hiện tại, trường này đang trong giai đoạn thử nghiệm.
lifetimeValueMicros

string (int64 format)

Giá trị vòng đời do nhà quảng cáo xác định cho người dùng.
lifetimeValueBucket

integer

Nhóm giá trị vòng đời do nhà quảng cáo xác định cho người dùng. Phạm vi hợp lệ cho một nhóm giá trị vòng đời là từ 1 (thấp) đến 10 (cao), ngoại trừ thao tác xoá có giá trị 0 cũng được chấp nhận.
shoppingLoyalty

object (ShoppingLoyalty)

Dữ liệu liên quan đến chương trình khách hàng thân thiết trong chiến dịch mua sắm. Mua sắm sử dụng dữ liệu này để cung cấp trải nghiệm tốt hơn cho người dùng. Chỉ những người bán có tên trong danh sách cho phép mới có thể truy cập khi có sự đồng ý của người dùng.

ShoppingLoyalty

Dữ liệu liên quan đến chương trình khách hàng thân thiết trong chiến dịch mua sắm. Mua sắm sử dụng dữ liệu này để cung cấp trải nghiệm tốt hơn cho người dùng. Chỉ những người bán có tên trong danh sách cho phép mới có thể truy cập.

Biểu diễn dưới dạng JSON 
{
  "loyaltyTier": string
}
Trường
loyaltyTier

string

Bậc hội viên. Đây là một chuỗi dạng tự do vì mỗi người bán có thể có hệ thống khách hàng thân thiết riêng. Ví dụ: Đó có thể là một số từ 1 đến 10 hoặc một chuỗi như "Vàng" hoặc "Bạc", hoặc thậm chí là chuỗi trống "".

EventAttribute

Các sự kiện do nhà quảng cáo xác định và các thuộc tính của những sự kiện đó. Bạn phải nhập tất cả giá trị trong các trường lồng nhau.

Biểu diễn dưới dạng JSON 
{
  "event": string,
  "eventDateTime": string,
  "itemAttribute": [
    {
      object (EventItemAttribute)
    }
  ]
}
Trường
event

string

Bắt buộc. Sự kiện do nhà quảng cáo xác định được dùng để tái tiếp thị. Những giá trị được chấp nhận là "Đã xem", "Giỏ hàng", "Đã mua" và "Được đề xuất".
eventDateTime

string

Bắt buộc. Dấu thời gian lúc sự kiện diễn ra. Định dạng là YYYY-MM-DD HH:MM:SS[+/-HH:MM], trong đó [+/-HH:MM] là giá trị chênh lệch múi giờ (không bắt buộc) so với giờ UTC. Nếu không có mức chênh lệch, API sẽ sử dụng múi giờ của tài khoản làm mặc định.
itemAttribute[]

object (EventItemAttribute)

Bắt buộc. Thuộc tính mặt hàng của sự kiện.

EventItemAttribute

Thuộc tính Mục sự kiện của danh sách So khớp khách hàng.

Biểu diễn dưới dạng JSON 
{
  "itemId": string
}
Trường
itemId

string

Không bắt buộc. Mã nhận dạng duy nhất của một sản phẩm. Đó có thể là Mã mặt hàng Merchant Center hoặc GTIN (Mã số sản phẩm thương mại toàn cầu).