UserData

ユーザー ID と属性を保持するユーザーデータ。

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

object (UserIdentifier)

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

object (TransactionAttribute)

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

object (UserAttribute)

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

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（国際取引商品番号）のいずれかになります。