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)

出力のみ。処理が失敗した理由（ステータスが FAILED の場合）。
operationMetadata

object (OfflineUserDataJobMetadata)

出力のみ。マッチ率の範囲を示すオフライン ユーザーデータ ジョブのメタデータ。
id

string (int64 format)

出力のみ。このオフライン ユーザーデータ ジョブの ID。
externalId

string (int64 format)

変更不可。ユーザー指定のジョブ ID。
共用体フィールド metadata。ジョブのメタデータ。metadata は次のいずれかになります。
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

変更不可。CRM ベースのユーザーリストに対するデータ更新のメタデータ。
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。