UserData

ユーザーの識別子と属性を保持するユーザーデータ。

JSON 表現 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  },
  "consent": {
    object (Consent)
  }
}
フィールド
userIdentifiers[]

object (UserIdentifier)

ユーザーの識別情報（必須）。
transactionAttribute

object (TransactionAttribute)

ユーザーに関連付けられている追加の取引/属性。店舗販売データを更新する場合に必要です。
userAttribute

object (UserAttribute)

ユーザーに関連付けられている追加の属性。カスタマー マッチの属性を更新する場合は必須。有効期限は 540 日間です。
consent

object (Consent)

ユーザーの同意設定。カスタマー マッチではこの項目は無視され、警告が返されます。

TransactionAttribute

店舗販売取引の属性。

JSON 表現 
{
  "storeAttribute": {
    object (StoreAttribute)
  },
  "itemAttribute": {
    object (ItemAttribute)
  },
  "transactionDateTime": string,
  "transactionAmountMicros": number,
  "currencyCode": string,
  "conversionAction": string,
  "orderId": string,
  "customValue": string
}
フィールド
storeAttribute

object (StoreAttribute)

トランザクションの属性を保存します。許可リストに登録されているお客様のみがアクセスできます。
itemAttribute

object (ItemAttribute)

トランザクションのアイテム属性。
transactionDateTime

string

トランザクションが発生したときのタイムスタンプ。必須。形式は「YYYY-MM-DD HH:MM:SS[+/-HH:MM]」です。[+/-HH:MM] は UTC からのタイムゾーン オフセットです（省略可）。オフセットが指定されていない場合、API はアカウントのタイムゾーンをデフォルトとして使用します。例: "2018-03-05 09:15:00"、"2018-02-01 14:34:30+03:00"
transactionAmountMicros

number

取引金額（マイクロ秒単位）。必須。取引金額は 1,000 超である必要があります。アイテム属性が指定されている場合、アイテムあたりの単価に ItemAttributes で指定された数量を掛けた値の合計額を表します。
currencyCode

string

トランザクションの通貨コード。ISO 4217 の 3 文字のコードを使用します。必須。
conversionAction

string

コンバージョンをレポートするコンバージョン アクションのリソース名。必須。
orderId

string

トランザクションの注文 ID。許可リストに登録されているお客様のみがアクセスできます。
customValue

string

各トランザクションのカスタム変数の値。許可リストに登録されているお客様のみがアクセスできます。

StoreAttribute

トランザクションの属性を保存します。

JSON 表現 
{
  "storeCode": string
}
フィールド
storeCode

string

https://support.google.com/business/answer/3370250#storecode に記載されている店舗コード

ItemAttribute

トランザクションのアイテム属性。

JSON 表現 
{
  "itemId": string,
  "countryCode": string,
  "languageCode": string,
  "quantity": string,
  "merchantId": string
}
フィールド
itemId

string

商品の一意の識別子。Merchant Center の商品アイテム ID または GTIN（国際取引商品番号）のいずれかを指定できます。
countryCode

string

商品アイテムのアップロード先フィードに関連付けられている国の Common Locale Data Repository（CLDR）テリトリー コード。詳しくは、https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes をご覧ください。
languageCode

string

商品アイテムのアップロード先フィードに関連付けられている言語の ISO 639-1 コードです。
quantity

string (int64 format)

販売されたアイテムの数。設定しない場合、デフォルトで 1 になります。
merchantId

string (int64 format)

Merchant Center アカウントの ID。

UserAttribute

ユーザー属性。CUSTOMER_MATCH_WITH_ATTRIBUTES ジョブタイプでのみ使用できます。

JSON 表現 
{
  "lastPurchaseDateTime": string,
  "averagePurchaseCount": integer,
  "averagePurchaseValueMicros": string,
  "acquisitionDateTime": string,
  "lifecycleStage": string,
  "firstPurchaseDateTime": string,
  "eventAttribute": [
    {
      object (EventAttribute)
    }
  ],
  "lifetimeValueMicros": string,
  "lifetimeValueBucket": integer,
  "shoppingLoyalty": {
    object (ShoppingLoyalty)
  }
}
フィールド
lastPurchaseDateTime

string

ユーザーが最後に行った購入のタイムスタンプ。形式は YYYY-MM-DD HH:MM:SS[+/-HH:MM] です。[+/-HH:MM] は UTC からのタイムゾーン オフセットです（省略可）。オフセットが指定されていない場合、API はアカウントのタイムゾーンをデフォルトとして使用します。
averagePurchaseCount

integer

広告主様が 30 日間にユーザーが行った購入の平均回数を定義しました。
averagePurchaseValueMicros

string (int64 format)

広告主がユーザーの平均購入額をマイクロ単位で定義します。
acquisitionDateTime

string

ユーザーを獲得したときのタイムスタンプ。形式は YYYY-MM-DD HH:MM:SS[+/-HH:MM] です。[+/-HH:MM] は UTC からのタイムゾーン オフセットです（省略可）。オフセットが指定されていない場合、API はアカウントのタイムゾーンをデフォルトとして使用します。
lifecycleStage

string

（省略可）広告主がユーザーのライフサイクル ステージを定義する。指定できる値は「Lead」、「Active」、「Churned」です。
firstPurchaseDateTime

string

（省略可）ユーザーが最初に行った購入のタイムスタンプ。形式は YYYY-MM-DD HH:MM:SS[+/-HH:MM] です。[+/-HH:MM] は UTC からのタイムゾーン オフセットです（省略可）。オフセットが指定されていない場合、API はアカウントのタイムゾーンをデフォルトとして使用します。
eventAttribute[]

object (EventAttribute)

（省略可）広告主様がイベントとその属性を定義しました。ネストされたフィールド内のすべての値は必須です。現在、このフィールドはベータ版です。
lifetimeValueMicros

string (int64 format)

広告主がユーザーのライフタイム バリューを定義します。
lifetimeValueBucket

integer

広告主が定義したユーザーのライフタイム バリュー バケット。ライフタイム バリューのバケットの有効範囲は 1（低）～ 10（高）です。ただし、削除オペレーションでは 0 も許容されます。
shoppingLoyalty

object (ShoppingLoyalty)

ショッピングのロイヤリティ関連のデータ。Google ショッピングでは、このデータを利用してユーザー エクスペリエンスを向上させます。ユーザーの同意を得た許可リストに登録されている販売者のみがアクセスできます。

ShoppingLoyalty

ショッピングのロイヤリティ関連のデータ。Google ショッピングでは、このデータを利用してユーザー エクスペリエンスを向上させます。許可リストに登録された販売者のみがアクセスできます。

JSON 表現 
{
  "loyaltyTier": string
}
フィールド
loyaltyTier

string

メンバーシップ階層。各販売者が独自のポイント システムを持っている可能性があるため、自由形式の文字列です。たとえば、1 ～ 10 の数値、「Golden」や「Silver」などの文字列、空の文字列「"」を指定できます。

EventAttribute

広告主様がイベントとその属性を定義しました。ネストされたフィールド内のすべての値は必須です。

JSON 表現 
{
  "event": string,
  "eventDateTime": string,
  "itemAttribute": [
    {
      object (EventItemAttribute)
    }
  ]
}
フィールド
event

string

必須。リマーケティングに使用されるイベント（広告主様が定義）。指定できる値は、「閲覧済み」、「カート」、「購入済み」、「推奨」です。
eventDateTime

string

必須。イベントが発生した時点のタイムスタンプ。形式は YYYY-MM-DD HH:MM:SS[+/-HH:MM] です。[+/-HH:MM] は UTC からのタイムゾーン オフセットです（省略可）。オフセットが指定されていない場合、API はアカウントのタイムゾーンをデフォルトとして使用します。
itemAttribute[]

object (EventItemAttribute)

必須。イベントのアイテム属性。

EventItemAttribute

カスタマー マッチのイベント アイテム属性。

JSON 表現 
{
  "itemId": string
}
フィールド
itemId

string

（省略可）商品の一意の識別子。Merchant Center の商品アイテム ID または GTIN（国際取引商品番号）のいずれかを指定できます。