- Biểu diễn dưới dạng JSON
- TransactionAttribute
- StoreAttribute
- ItemAttribute
- UserAttribute
- ShoppingLoyalty
- EventAttribute
- EventItemAttribute
Dữ liệu người dùng có chứa các 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 ( |
Các trường | |
---|---|
userIdentifiers[] |
Thông tin nhận dạng người dùng. Bắt buộc. |
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 |
Các thuộc tính bổ sung có liên quan đến 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 tin này sẽ hết hạn sau 540 ngày. |
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 ( |
Các trường | |
---|---|
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 xem được. |
itemAttribute |
Thuộc tính mặt hàng của giao dịch. |
transactionDateTime |
Dấu thời gian khi giao dịch thực hiện. Bắt buộc. Định dạng là "YYYY-MM-DD HH:MM:SS[+/-HH:MM]", trong đó [+/-HH:MM] là chênh lệch múi giờ không bắt buộc so với giờ UTC. Nếu không có giá trị 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 |
Số tiền giao dịch cực nhỏ. Bắt buộc. Số tiền giao dịch cực nhỏ phải lớn hơn 1000. Nếu bạn cung cấp Thuộc tính của mặt hàng, thuộc tính này cho biết 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 |
Mã đơn vị tiền tệ giao dịch. Hệ thống sử dụng mã gồm ba chữ cái theo ISO 4217. Bắt buộc. |
conversionAction |
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 |
Mã đơn đặt hàng giao dịch. Chỉ những khách hàng trong danh sách cho phép mới xem được. |
customValue |
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 xem đượ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 } |
Các trường | |
---|---|
storeCode |
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 } |
Các trường | |
---|---|
itemId |
Giá trị nhận dạng duy nhất của một sản phẩm. Đó có thể là Mã mặt hàng trong Merchant Center hoặc GTIN (Mã số sản phẩm thương mại toàn cầu). |
countryCode |
Mã lãnh thổ 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 mặt hàng mà bạn tải lên. Hãy truy cập vào https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes để biết thêm thông tin. |
languageCode |
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 |
Số lượng mặt hàng đã bán ra. Giá trị mặc định là 1 nếu không đặt. |
merchantId |
Mã tài khoản Merchant Center. |
UserAttribute
Thuộc tính người dùng, chỉ có thể được sử 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 ( |
Các trường | |
---|---|
lastPurchaseDateTime |
Dấu thời gian của giao dịch mua hàng 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à chênh lệch múi giờ không bắt buộc so với giờ UTC. Nếu không có giá trị chênh lệch, API sẽ sử dụng múi giờ của tài khoản làm mặc định. |
averagePurchaseCount |
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 |
Nhà quảng cáo đã xác định giá trị mua hàng trung bình cực nhỏ cho người dùng. |
acquisitionDateTime |
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à chênh lệch múi giờ không bắt buộc so với giờ UTC. Nếu không có giá trị chênh lệch, API sẽ sử dụng múi giờ của tài khoản làm mặc định. |
lifecycleStage |
Không bắt buộc. Giai đoạn 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 |
Không bắt buộc. Dấu thời gian của giao dịch mua hàng đầu tiên 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à chênh lệch múi giờ không bắt buộc so với giờ UTC. Nếu không có giá trị chênh lệch, API sẽ sử dụng múi giờ của tài khoản làm mặc định. |
eventAttribute[] |
Không bắt buộc. Các sự kiện do nhà quảng cáo xác định và thuộc tính của chúng. 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 |
Giá trị vòng đời do nhà quảng cáo xác định cho người dùng. |
lifetimeValueBucket |
Nhà quảng cáo xác định nhóm giá trị vòng đời 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á khi giá trị 0 cũng được chấp nhận. |
shoppingLoyalty |
Dữ liệu liên quan đến chương trình khách hàng thân thiết mua sắm. Google 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 mua sắm. Google 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 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 } |
Các trường | |
---|---|
loyaltyTier |
Bậc thành 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à thuộc tính của chúng. 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 ( |
Các trường | |
---|---|
event |
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 |
Bắt buộc. Dấu thời gian tại thời điểm xảy ra sự kiện. Định dạng là YYYY-MM-DD HH:MM:SS[+/-HH:MM], trong đó [+/-HH:MM] là chênh lệch múi giờ không bắt buộc so với giờ UTC. Nếu không có giá trị chênh lệch, API sẽ sử dụng múi giờ của tài khoản làm mặc định. |
itemAttribute[] |
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 } |
Các trường | |
---|---|
itemId |
Không bắt buộc. Giá trị nhận dạng duy nhất của một sản phẩm. Đó có thể là Mã mặt hàng trong Merchant Center hoặc GTIN (Mã số sản phẩm thương mại toàn cầu). |