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。