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)

僅供輸出。上傳目標客戶比對使用者名單的媒合率。說明工作狀態為「RUNNING」時的預估媒合率，而在工作狀態為「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。