Chú ý: Bạn đang xem tài liệu về giao diện REST của API. Hầu hết các thư viện ứng dụng chính thức của chúng tôi đều sử dụng gRPC. Hãy xem Giới thiệu về REST để biết chi tiết.

Trang này được dịch bởi Cloud Translation API.

UserData

Biểu diễn dưới dạng JSON
TransactionAttribute
- Biểu diễn dưới dạng JSON
StoreAttribute
- Biểu diễn dưới dạng JSON
ItemAttribute
- Biểu diễn dưới dạng JSON
UserAttribute
- Biểu diễn dưới dạng JSON
ShoppingLoyalty
- Biểu diễn dưới dạng JSON
EventAttribute
- Biểu diễn dưới dạng JSON
EventItemAttribute
- Biểu diễn dưới dạng JSON

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 (`UserIdentifier`) } ], "transactionAttribute": { object (`TransactionAttribute`) }, "userAttribute": { object (`UserAttribute`) } }

Các trường

Các 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 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.

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 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.

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

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 }

{
  "storeAttribute": {
    object (StoreAttribute)
  },
  "itemAttribute": {
    object (ItemAttribute)
  },
  "transactionDateTime": string,
  "transactionAmountMicros": number,
  "currencyCode": string,
  "conversionAction": string,
  "orderId": string,
  "customValue": string
}

Các 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 xem đượ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 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`	`number` 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`	`string` 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`	`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 xem đượ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 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

Các trường
`storeCode`	`string` Mã cửa hàng từ https://support.google.com/business/answer/3370250#storecode

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 }

Các trường
`itemId`	`string` 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`	`string` 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`	`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 đặt.
`merchantId`	`string (int64 format)` 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

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`) } }

{
  "lastPurchaseDateTime": string,
  "averagePurchaseCount": integer,
  "averagePurchaseValueMicros": string,
  "acquisitionDateTime": string,
  "lifecycleStage": string,
  "firstPurchaseDateTime": string,
  "eventAttribute": [
    {
      object (EventAttribute)
    }
  ],
  "lifetimeValueMicros": string,
  "lifetimeValueBucket": integer,
  "shoppingLoyalty": {
    object (ShoppingLoyalty)
  }
}

Các trường
`lastPurchaseDateTime`	`string` 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`	`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ị mua hàng trung bình cực nhỏ 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à 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`	`string` 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`	`string` 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[]`	`object (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`	`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à 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`	`object (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

Các trường
`loyaltyTier`	`string` 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 "".

loyaltyTier

string

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 (`EventItemAttribute`) } ] }

Các trường

Các 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 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[]`	`object (EventItemAttribute)` Bắt buộc. Thuộc tính mặt hàng của sự kiện.

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 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[]

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 }

Các trường

Các trường
`itemId`	`string` 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).

itemId

string

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).