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.

OfflineUserDataJob

Biểu diễn dưới dạng JSON
OfflineUserDataJobType
OfflineUserDataJobStatus
OfflineUserDataJobFailureReason
OfflineUserDataJobMetadata
- Biểu diễn dưới dạng JSON
OfflineUserDataJobMatchRateRange
StoreSalesMetadata
- Biểu diễn dưới dạng JSON
StoreSalesThirdPartyMetadata
- Biểu diễn dưới dạng JSON

Công việc chứa dữ liệu người dùng ngoại tuyến của khách truy cập cửa hàng hoặc thành viên trong danh sách người dùng sẽ được xử lý không đồng bộ. Hệ thống không đọc được dữ liệu đã tải lên và bạn chỉ có thể đọc kết quả xử lý công việc bằng GoogleAdsService.Search/SearchStream.

Biểu diễn dưới dạng JSON

Biểu diễn dưới dạng JSON
{ "resourceName": string, "type": enum (`OfflineUserDataJobType`), "status": enum (`OfflineUserDataJobStatus`), "failureReason": enum (`OfflineUserDataJobFailureReason`), "operationMetadata": { object (`OfflineUserDataJobMetadata`) }, "id": string, "externalId": string, // Union field `metadata` can be only one of the following: "customerMatchUserListMetadata": { object (`CustomerMatchUserListMetadata`) }, "storeSalesMetadata": { object (`StoreSalesMetadata`) } // End of list of possible types for union field `metadata`. }

{
  "resourceName": string,
  "type": enum (OfflineUserDataJobType),
  "status": enum (OfflineUserDataJobStatus),
  "failureReason": enum (OfflineUserDataJobFailureReason),
  "operationMetadata": {
    object (OfflineUserDataJobMetadata)
  },
  "id": string,
  "externalId": string,

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  },
  "storeSalesMetadata": {
    object (StoreSalesMetadata)
  }
  // End of list of possible types for union field metadata.
}

Trường
`resourceName`	`string` Không thể thay đổi. Tên tài nguyên của công việc dữ liệu người dùng ngoại tuyến. Tên tài nguyên công việc dữ liệu người dùng ngoại tuyến có dạng: `customers/{customerId}/offlineUserDataJobs/{offline_user_data_job_id}`
`type`	`enum (OfflineUserDataJobType)` Không thể thay đổi. Loại công việc.
`status`	`enum (OfflineUserDataJobStatus)` Chỉ có đầu ra. Trạng thái của công việc.
`failureReason`	`enum (OfflineUserDataJobFailureReason)` Chỉ có đầu ra. Lý do không xử lý được, nếu trạng thái là KHÔNG THÀNH CÔNG.
`operationMetadata`	`object (OfflineUserDataJobMetadata)` Chỉ có đầu ra. Siêu dữ liệu về công việc trong dữ liệu người dùng ngoại tuyến mô tả phạm vi tỷ lệ khớp.
`id`	`string (int64 format)` Chỉ có đầu ra. Mã của công việc dữ liệu người dùng ngoại tuyến này.
`externalId`	`string (int64 format)` Không thể thay đổi. Mã công việc do người dùng chỉ định.
Trường hợp `metadata`. Siêu dữ liệu về việc làm. `metadata` chỉ có thể là một trong những trạng thái sau:
`customerMatchUserListMetadata`	`object (CustomerMatchUserListMetadata)` Không thể thay đổi. Siêu dữ liệu về việc cập nhật dữ liệu cho danh sách người dùng dựa trên hệ thống quản lý quan hệ khách hàng (CRM).
`storeSalesMetadata`	`object (StoreSalesMetadata)` Không thể thay đổi. Siêu dữ liệu cho việc cập nhật dữ liệu về lượt bán hàng tại cửa hàng thực tế.

OfflineUserDataJobType

Loại công việc liên quan đến dữ liệu người dùng ngoại tuyến.

Enum
`UNSPECIFIED`	Chưa chỉ định.
`UNKNOWN`	Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
`STORE_SALES_UPLOAD_FIRST_PARTY`	Lưu trữ dữ liệu Bán hàng trực tiếp để tự phục vụ.
`STORE_SALES_UPLOAD_THIRD_PARTY`	Lưu trữ dữ liệu Bán hàng trực tiếp cho bên thứ ba.
`CUSTOMER_MATCH_USER_LIST`	Dữ liệu danh sách người dùng So khớp khách hàng.
`CUSTOMER_MATCH_WITH_ATTRIBUTES`	So khớp khách hàng bằng dữ liệu thuộc tính.

OfflineUserDataJobStatus

Trạng thái của công việc liên quan đến dữ liệu người dùng ngoại tuyến.

Enum
`UNSPECIFIED`	Chưa chỉ định.
`UNKNOWN`	Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
`PENDING`	Công việc đã được tạo thành công và đang chờ tải lên.
`RUNNING`	Dữ liệu tải lên đã được chấp nhận và dữ liệu đang được xử lý.
`SUCCESS`	Dữ liệu được tải lên đã được xử lý thành công.
`FAILED`	Không xử lý được dữ liệu đã tải lên.

OfflineUserDataJobFailureReason

Lý do không thực hiện được công việc dữ liệu người dùng ngoại tuyến.

Enum
`UNSPECIFIED`	Chưa chỉ định.
`UNKNOWN`	Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
`INSUFFICIENT_MATCHED_TRANSACTIONS`	Các giao dịch đã khớp không đủ.
`INSUFFICIENT_TRANSACTIONS`	Các giao dịch đã tải lên chưa đủ.
`HIGH_AVERAGE_TRANSACTION_VALUE`	Giá trị giao dịch trung bình của tài khoản của bạn cao bất thường. Nếu đây là ý định của bạn, hãy liên hệ với nhóm hỗ trợ để yêu cầu một trường hợp ngoại lệ. Tìm hiểu thêm tại https://support.google.com/google-ads/answer/10018944#transaction_value
`LOW_AVERAGE_TRANSACTION_VALUE`	Giá trị giao dịch trung bình của tài khoản thấp bất thường. Nếu đây là ý định của bạn, hãy liên hệ với nhóm hỗ trợ để yêu cầu một trường hợp ngoại lệ. Tìm hiểu thêm tại https://support.google.com/google-ads/answer/10018944#transaction_value
`NEWLY_OBSERVED_CURRENCY_CODE`	Có một mã đơn vị tiền tệ mà trước đây bạn chưa từng sử dụng trong tệp tải lên. Nếu đây là ý định của bạn, hãy liên hệ với nhóm hỗ trợ để yêu cầu một trường hợp ngoại lệ. Tìm hiểu thêm tại https://support.google.com/google-ads/answer/10018944#Unrecognized_currency

OfflineUserDataJobMetadata

Siêu dữ liệu về công việc liên quan đến dữ liệu người dùng ngoại tuyến.

Biểu diễn dưới dạng JSON
{ "matchRateRange": enum (`OfflineUserDataJobMatchRateRange`) }

Trường

matchRateRange

enum (OfflineUserDataJobMatchRateRange)

Chỉ có đầu ra. Tỷ lệ khớp của lượt tải danh sách người dùng So khớp khách hàng lên. Mô tả tỷ lệ khớp ước tính khi trạng thái của công việc là "ĐANG HOẠT ĐỘNG" và tỷ lệ khớp cuối cùng khi tỷ lệ khớp cuối cùng xuất hiện sau trạng thái của công việc là "ĐÃ THÀNH CÔNG/KHÔNG THÀNH CÔNG".

OfflineUserDataJobMatchRateRange

Phạm vi tỷ lệ khớp của công việc dữ liệu người dùng ngoại tuyến.

Enum
`UNSPECIFIED`	Chưa chỉ định.
`UNKNOWN`	Giá trị mặc định cho phạm vi tỷ lệ khớp.
`MATCH_RANGE_LESS_THAN_20`	Phạm vi tỷ lệ khớp cho thực thể tải dữ liệu ngoại tuyến lên là từ 0% đến 19%.
`MATCH_RANGE_20_TO_30`	Phạm vi tỷ lệ khớp cho thực thể tải dữ liệu ngoại tuyến lên là từ 20% đến 30%.
`MATCH_RANGE_31_TO_40`	Phạm vi tỷ lệ khớp cho thực thể tải dữ liệu ngoại tuyến lên là từ 31% đến 40%.
`MATCH_RANGE_41_TO_50`	Phạm vi tỷ lệ khớp cho thực thể tải dữ liệu ngoại tuyến lên là từ 41% đến 50%.
`MATCH_RANGE_51_TO_60`	Phạm vi tỷ lệ khớp cho thực thể tải dữ liệu ngoại tuyến lên là từ 51% đến 60%.
`MATCH_RANGE_61_TO_70`	Phạm vi tỷ lệ khớp cho thực thể tải dữ liệu ngoại tuyến lên là từ 61% đến 70%.
`MATCH_RANGE_71_TO_80`	Phạm vi tỷ lệ khớp cho thực thể tải dữ liệu ngoại tuyến lên là từ 71% đến 80%.
`MATCH_RANGE_81_TO_90`	Phạm vi tỷ lệ khớp cho thực thể tải dữ liệu ngoại tuyến lên là từ 81% đến 90%.
`MATCH_RANGE_91_TO_100`	Phạm vi tỷ lệ khớp cho thực thể tải dữ liệu ngoại tuyến lên là lớn hơn hoặc bằng 91%.

StoreSalesMetadata

Siêu dữ liệu cho chỉ số bán hàng trực tiếp tại cửa hàng.

Biểu diễn dưới dạng JSON
{ "thirdPartyMetadata": { object (`StoreSalesThirdPartyMetadata`) }, "loyaltyFraction": number, "transactionUploadFraction": number, "customKey": string }

Trường
`thirdPartyMetadata`	`object (StoreSalesThirdPartyMetadata)` Siêu dữ liệu cho tệp Lượt bán hàng tại cửa hàng thực tế do bên thứ ba tải lên.
`loyaltyFraction`	`number` Đây là một phần trong tất cả các giao dịch có thể nhận dạng được (ví dụ: liên kết với bất kỳ hình thức thông tin khách hàng nào). Bắt buộc. Phần này cần phải nằm từ 0 đến 1 (không bao gồm 0).
`transactionUploadFraction`	`number` Đây là tỷ lệ doanh số bán hàng được tải lên so với tổng doanh số bán hàng có thể được liên kết với một khách hàng. Bắt buộc. Phần này cần phải nằm từ 0 đến 1 (không bao gồm 0). Ví dụ: nếu bạn tải một nửa số lượt bán hàng mà bạn có thể liên kết với một khách hàng, thì giá trị này sẽ là 0, 5.
`customKey`	`string` Tên của khoá biến tuỳ chỉnh cho lượt bán hàng tại cửa hàng thực tế. Khoá xác định trước có thể áp dụng cho giao dịch, sau đó dùng cho phân đoạn tuỳ chỉnh trong báo cáo. Chỉ những khách hàng trong danh sách cho phép mới truy cập được.

StoreSalesThirdPartyMetadata

Siêu dữ liệu về Lượt bán hàng tại cửa hàng thực tế của bên thứ ba. Sản phẩm này chỉ dành cho những khách hàng trong danh sách cho phép. Hãy liên hệ với người đại diện bộ phận phát triển kinh doanh của Google để biết thông tin chi tiết về cấu hình tải lên.

Biểu diễn dưới dạng JSON
{ "advertiserUploadDateTime": string, "validTransactionFraction": number, "partnerMatchFraction": number, "partnerUploadFraction": number, "bridgeMapVersionId": string, "partnerId": string }

Trường
`advertiserUploadDateTime`	`string` Thời gian mà nhà quảng cáo tải dữ liệu lên đối tác. Bắt buộc. Định dạng là "YYYY-MM-DD HH:MM:SS". Ví dụ: "2018-03-05 09:15:00" hoặc "2018-02-01 14:34:30"
`validTransactionFraction`	`number` Tỷ lệ giao dịch hợp lệ. Giao dịch không hợp lệ có thể bao gồm định dạng hoặc giá trị không hợp lệ. Bắt buộc. Phần này cần phải nằm từ 0 đến 1 (không bao gồm 0).
`partnerMatchFraction`	`number` Tỷ lệ giao dịch hợp lệ được khớp với mã nhận dạng người dùng do bên thứ ba chỉ định ở phía đối tác. Bắt buộc. Phần này cần phải nằm từ 0 đến 1 (không bao gồm 0).
`partnerUploadFraction`	`number` Tỷ lệ giao dịch hợp lệ do đối tác tải lên Google. Bắt buộc. Phần này cần phải nằm từ 0 đến 1 (không bao gồm 0).
`bridgeMapVersionId`	`string` Phiên bản của mã đối tác sẽ được dùng để tải lên. Bắt buộc.
`partnerId`	`string (int64 format)` Mã của đối tác bên thứ ba đang cập nhật nguồn cấp dữ liệu giao dịch.