OfflineUserDataJob

包含商店訪客的離線使用者資料，或將以非同步方式處理的使用者名單成員的工作。系統無法讀取上傳的資料，工作的處理結果只能使用 GoogleAdsService.Search/SearchStream 讀取。

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

不可變動。離線使用者資料工作的資源名稱。離線使用者資料工作資源名稱的格式如下：

customers/{customerId}/offlineUserDataJobs/{offline_user_data_job_id}
type

enum (OfflineUserDataJobType)

不可變動。工作類型。
status

enum (OfflineUserDataJobStatus)

僅供輸出。工作狀態，
failureReason

enum (OfflineUserDataJobFailureReason)

僅供輸出。處理失敗的原因 (如果狀態為「失敗」)。
operationMetadata

object (OfflineUserDataJobMetadata)

僅供輸出。描繪媒合率範圍的離線使用者資料工作中繼資料。
id

string (int64 format)

僅供輸出。這個離線使用者資料工作的 ID。
externalId

string (int64 format)

不可變動。使用者指定的工作 ID。
聯集欄位 metadata。工作的中繼資料。metadata 只能是下列其中一項：
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

不可變動。基於客戶關係管理使用者清單的資料更新中繼資料。
storeSalesMetadata

object (StoreSalesMetadata)

不可變動。商店銷售資料更新的中繼資料。

OfflineUserDataJobType

離線使用者資料工作的類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
STORE_SALES_UPLOAD_FIRST_PARTY 自助式商店直接銷售資料。
STORE_SALES_UPLOAD_THIRD_PARTY 第三方的商店銷售直接資料。
CUSTOMER_MATCH_USER_LIST 目標客戶比對使用者名單資料。
CUSTOMER_MATCH_WITH_ATTRIBUTES 目標顧客比對與屬性資料。

OfflineUserDataJobStatus

離線使用者資料工作的狀態。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
PENDING 已成功建立工作，正在等待上傳。
RUNNING 系統已接受上傳內容，系統正在處理資料。
SUCCESS 已成功處理上傳的資料。
FAILED 無法處理上傳的資料。

OfflineUserDataJobFailureReason

離線使用者資料工作失敗的原因。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
INSUFFICIENT_MATCHED_TRANSACTIONS 相符的交易不足。
INSUFFICIENT_TRANSACTIONS 上傳的交易資料不足。
HIGH_AVERAGE_TRANSACTION_VALUE 帳戶中的平均交易價值異常高，如果確實是這樣，請與支援團隊聯絡以申請例外狀況。詳情請參閱：https://support.google.com/google-ads/answer/10018944#transaction_value
LOW_AVERAGE_TRANSACTION_VALUE 帳戶的平均交易價值異常低。如果確實是這樣，請與支援團隊聯絡以申請例外狀況。詳情請參閱：https://support.google.com/google-ads/answer/10018944#transaction_value
NEWLY_OBSERVED_CURRENCY_CODE 上傳內容中有你從未使用過的貨幣代碼。如果確實是這樣，請與支援團隊聯絡以申請例外狀況。詳情請參閱：https://support.google.com/google-ads/answer/10018944#Unrecognized_currency

OfflineUserDataJobMetadata

離線使用者資料工作的中繼資料。

JSON 表示法 
{
  "matchRateRange": enum (OfflineUserDataJobMatchRateRange)
}
欄位
matchRateRange

enum (OfflineUserDataJobMatchRateRange)

僅供輸出。所上傳目標顧客比對使用者名單的媒合率。說明工作狀態為「執行中」時的預估媒合率，以及工作狀態為「SUCCESS/FAILED」後顯示最終媒合率時的最終媒合率。

OfflineUserDataJobMatchRateRange

離線使用者資料工作的媒合率範圍。

列舉
UNSPECIFIED 未指定。
UNKNOWN 媒合率範圍的預設值。
MATCH_RANGE_LESS_THAN_20 離線資料上傳實體的媒合率範圍介於 0% 至 19% 之間。
MATCH_RANGE_20_TO_30 離線資料上傳實體的媒合率範圍介於 20% 至 30% 之間。
MATCH_RANGE_31_TO_40 離線資料上傳實體的媒合率範圍介於 31% 至 40% 之間。
MATCH_RANGE_41_TO_50 離線資料上傳實體的媒合率範圍介於 41% 至 50% 之間。
MATCH_RANGE_51_TO_60 離線資料上傳實體的媒合率範圍介於 51% 至 60% 之間。
MATCH_RANGE_61_TO_70 離線資料上傳實體的媒合率範圍介於 61% 至 70% 之間。
MATCH_RANGE_71_TO_80 離線資料上傳實體的媒合率範圍介於 71% 至 80% 之間。
MATCH_RANGE_81_TO_90 離線資料上傳實體的媒合率範圍介於 81% 至 90% 之間。
MATCH_RANGE_91_TO_100 離線資料上傳實體的媒合率範圍大於或等於 91%。

StoreSalesMetadata

商店銷售直接交易的中繼資料。

JSON 表示法 
{
  "thirdPartyMetadata": {
    object (StoreSalesThirdPartyMetadata)
  },
  "loyaltyFraction": number,
  "transactionUploadFraction": number,
  "customKey": string
}
欄位
thirdPartyMetadata

object (StoreSalesThirdPartyMetadata)

第三方商店銷售上傳資料的中繼資料。
loyaltyFraction

number

這是指所有可識別的交易 (例如與任何形式的客戶資訊相關聯的交易) 所佔的比例。必要欄位。此比率必須介於 0 到 1 之間 (不包括 0)。
transactionUploadFraction

number

這是上傳銷售量與可連結至客戶整體銷售量兩者的比率。必要欄位。這項比率必須介於 0 到 1 之間 (不包括 0)。舉例來說，如果您上傳的銷售量在與客戶相關聯的整體銷售量中佔了一半，這個數字就會是 0.5。
customKey

string

商店銷售自訂變數鍵的名稱。預先定義的鍵，可以套用至交易，稍後用於報表中的自訂區隔。只有許可清單中的客戶可以存取。

StoreSalesThirdPartyMetadata

第三方商店銷售中繼資料。這項產品僅適用於許可清單中的消費者。如要進一步瞭解上傳設定，請與您的 Google 業務開發代表聯絡。

JSON 表示法 
{
  "advertiserUploadDateTime": string,
  "validTransactionFraction": number,
  "partnerMatchFraction": number,
  "partnerUploadFraction": number,
  "bridgeMapVersionId": string,
  "partnerId": string
}
欄位
advertiserUploadDateTime

string

廣告客戶將資料上傳到夥伴的時間。必要欄位。格式為「YYYY-MM-DD HH:MM:SS」。範例：「2018-03-05 09:15:00」或「2018-02-01 14:34:30」
validTransactionFraction

number

有效交易的百分比。無效的交易可能包含無效的格式或值。必要欄位。此比率必須介於 0 到 1 之間 (不包括 0)。
partnerMatchFraction

number

與合作夥伴端第三方指派的使用者 ID 相符的有效交易比例。必要欄位。此比率必須介於 0 到 1 之間 (不包括 0)。
partnerUploadFraction

number

合作夥伴上傳至 Google 的有效交易比例。必要欄位。此比率必須介於 0 到 1 之間 (不包括 0)。
bridgeMapVersionId

string

要用於上傳作業的合作夥伴 ID 版本。這是必填欄位。
partnerId

string (int64 format)

更新交易動態饋給的第三方合作夥伴 ID。