OfflineUserDataJob

Công việc chứa dữ liệu người dùng ngoại tuyến của khách ghé thăm cửa hàng thực tế hoặc thành viên trong danh sách người dùng sẽ được xử lý không đồng bộ. Không đọc được dữ liệu đã tải lên và 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
{
  "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.
}
Các trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của công việc liên quan đến 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 lỗi xử lý, nếu trạng thái 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 nhóm metadata. Siêu dữ liệu về công việc. metadata chỉ có thể là một trong những trạng thái sau đây:
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 CRM.

storeSalesMetadata

object (StoreSalesMetadata)

Không thể thay đổi. Siêu dữ liệu về bản 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 xác đị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 Trực tiếp bán hàng để tự phục vụ.
STORE_SALES_UPLOAD_THIRD_PARTY Dữ liệu Bán hàng trực tiếp tại cửa hàng 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 với 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 xác đị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 (Các) tệp 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 xác đị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 không đủ.
HIGH_AVERAGE_TRANSACTION_VALUE Giá trị giao dịch trung bình của tài khoản cao bất thường. Nếu bạn muốn được xem xét điều này, hãy liên hệ với nhóm hỗ trợ để yêu cầu 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 bạn muốn được xem xét điều này, hãy liên hệ với nhóm hỗ trợ để yêu cầu 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 sử dụng trong tệp tải lên. Nếu bạn muốn được xem xét điều này, hãy liên hệ với nhóm hỗ trợ để yêu cầu 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)
}
Các 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 CHẠY" và tỷ lệ khớp cuối cùng khi tỷ lệ khớp cuối cùng có sẵ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 một công việc liên quan đến dữ liệu người dùng ngoại tuyến.

Enum
UNSPECIFIED Chưa xác đị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 dành cho Trực tiếp bán hàng tại cửa hàng thực tế.

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

object (StoreSalesThirdPartyMetadata)

Siêu dữ liệu về nội dung tải lên của bên thứ ba về Lượt bán hàng tại cửa hàng thực tế.

loyaltyFraction

number

Đây là một phần trong tất cả giao dịch có thể nhận dạng được (ví dụ: giao dịch được 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ể 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 lên 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 xem đượ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 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
}
Các trường
advertiserUploadDateTime

string

Thời điể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 các đị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ệ mà đố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 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.