- JSON 表現
- TransactionAttribute
- StoreAttribute
- ItemAttribute
- UserAttribute
- ShoppingLoyalty
- EventAttribute
- EventItemAttribute
ユーザー ID と属性を保持するユーザーデータ。
JSON 表現 |
---|
{ "userIdentifiers": [ { object ( |
フィールド | |
---|---|
userIdentifiers[] |
ユーザーの識別情報。必須。 |
transactionAttribute |
ユーザーに関連付けられている追加の取引/属性。店舗での販売データを更新する場合は必須です。 |
userAttribute |
ユーザーに関連付けられているその他の属性。カスタマー マッチの属性を更新する場合は必須です。有効期限は 540 日間です。 |
consent |
ユーザーの同意設定。カスタマー マッチはこの項目を無視して警告を返します。 |
TransactionAttribute
店舗での販売の取引の属性。
JSON 表現 |
---|
{ "storeAttribute": { object ( |
フィールド | |
---|---|
storeAttribute |
トランザクションの属性を保存します。許可リストに登録されたお客様のみがアクセスできます。 |
itemAttribute |
トランザクションのアイテム属性。 |
transactionDateTime |
トランザクション発生時のタイムスタンプ。必須。形式は「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 |
取引金額(マイクロ単位)。必須。取引金額が 1,000 を超える金額(マイクロ単位)である必要があります。アイテム属性が指定されている場合は、アイテムあたりの単価に ItemAttributes で指定された数量を掛けて、アイテムの合計価格を表します。 |
currencyCode |
トランザクションの通貨コード。ISO 4217 の 3 文字のコードを使用します。必須。 |
conversionAction |
コンバージョンを報告するコンバージョン アクションのリソース名。必須。 |
orderId |
取引の注文 ID。許可リストに登録されたお客様のみがアクセスできます。 |
customValue |
各トランザクションのカスタム変数の値。許可リストに登録されたお客様のみがアクセスできます。 |
StoreAttribute
トランザクションの属性を保存します。
JSON 表現 |
---|
{ "storeCode": string } |
フィールド | |
---|---|
storeCode |
https://support.google.com/business/answer/3370250#storecode に記載されている店舗コード |
ItemAttribute
トランザクションのアイテム属性。
JSON 表現 |
---|
{ "itemId": string, "countryCode": string, "languageCode": string, "quantity": string, "merchantId": string } |
フィールド | |
---|---|
itemId |
商品の一意の識別子。Merchant Center の商品アイテム ID または GTIN(国際取引商品番号)のいずれかになります。 |
countryCode |
商品アイテムのアップロード先フィードに関連付けられている国の、Common Locale Data Repository(CLDR)テリトリー コード。詳しくは、https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes をご覧ください。 |
languageCode |
商品アイテムのアップロード先フィードに関連付けられている ISO 639-1 コード |
quantity |
販売されたアイテムの数。設定しない場合、デフォルトで 1 になります。 |
merchantId |
Merchant Center アカウントの ID。 |
UserAttribute
ユーザー属性。CUSTOMER_MATCH_WITH_ATTRIBUTES ジョブタイプでのみ使用できます。
JSON 表現 |
---|
{ "lastPurchaseDateTime": string, "averagePurchaseCount": integer, "averagePurchaseValueMicros": string, "acquisitionDateTime": string, "lifecycleStage": string, "firstPurchaseDateTime": string, "eventAttribute": [ { object ( |
フィールド | |
---|---|
lastPurchaseDateTime |
ユーザーが最後に行った購入のタイムスタンプ。形式は YYYY-MM-DD HH:MM:SS[+/-HH:MM] です。[+/-HH:MM] は UTC からのタイムゾーン オフセットです(省略可)。オフセットが指定されていない場合、API ではアカウントのタイムゾーンがデフォルトで使用されます。 |
averagePurchaseCount |
広告主様が定義した 30 日間の平均購入回数。 |
averagePurchaseValueMicros |
広告主は、ユーザーの平均購入額をマイクロ単位で定義しています。 |
acquisitionDateTime |
ユーザーを獲得した時点のタイムスタンプ。形式は YYYY-MM-DD HH:MM:SS[+/-HH:MM] です。[+/-HH:MM] は UTC からのタイムゾーン オフセットです(省略可)。オフセットが指定されていない場合、API ではアカウントのタイムゾーンがデフォルトで使用されます。 |
lifecycleStage |
(省略可)広告主様が定義したユーザーのライフサイクル ステージ。指定できる値は「Lead」、「Active」、「Churned」です。 |
firstPurchaseDateTime |
(省略可)ユーザーが初めて行った購入のタイムスタンプ。形式は YYYY-MM-DD HH:MM:SS[+/-HH:MM] です。[+/-HH:MM] は UTC からのタイムゾーン オフセットです(省略可)。オフセットが指定されていない場合、API ではアカウントのタイムゾーンがデフォルトで使用されます。 |
eventAttribute[] |
(省略可)広告主様が定義したイベントとその属性です。ネストされたフィールドのすべての値は必須です。現在、このフィールドはベータ版です。 |
lifetimeValueMicros |
広告主がユーザーのライフタイム バリューを定義しました。 |
lifetimeValueBucket |
広告主が定義したユーザーのライフタイム バリューのバケット。ライフタイム バリュー バケットの有効範囲は 1(低)~ 10(高)です。ただし、削除オペレーションでは 0 も許容されます。 |
shoppingLoyalty |
ショッピングのロイヤリティ関連のデータ。Google ショッピングでは、このデータを活用して、ユーザー エクスペリエンスを向上させます。ユーザーの同意を得たうえで、許可リストに登録されている販売者のみがアクセスできます。 |
ShoppingLoyalty
ショッピングのロイヤリティ関連のデータ。Google ショッピングでは、このデータを活用して、ユーザー エクスペリエンスを向上させます。許可リストに登録された販売者のみがアクセスできます。
JSON 表現 |
---|
{ "loyaltyTier": string } |
フィールド | |
---|---|
loyaltyTier |
メンバーシップ階層。販売者ごとに独自のポイント システムがある場合があるため、これは自由形式の文字列です。たとえば、1 ~ 10 の数字、「Golden」や「Silver」などの文字列、空の文字列「"」を指定できます。 |
EventAttribute
広告主様が定義したイベントとその属性です。ネストされたフィールドのすべての値は必須です。
JSON 表現 |
---|
{
"event": string,
"eventDateTime": string,
"itemAttribute": [
{
object ( |
フィールド | |
---|---|
event |
必須。リマーケティングに使用する、広告主が定義したイベント。指定できる値は、「閲覧済み」、「カート」、「購入済み」、「おすすめ」です。 |
eventDateTime |
必須。イベントが発生した時点のタイムスタンプ。形式は YYYY-MM-DD HH:MM:SS[+/-HH:MM] です。[+/-HH:MM] は UTC からのタイムゾーン オフセットです(省略可)。オフセットが指定されていない場合、API ではアカウントのタイムゾーンがデフォルトで使用されます。 |
itemAttribute[] |
必須。イベントのアイテム属性。 |
EventItemAttribute
カスタマー マッチのイベント アイテム属性。
JSON 表現 |
---|
{ "itemId": string } |
フィールド | |
---|---|
itemId |
(省略可)商品の一意の識別子。Merchant Center の商品アイテム ID または GTIN(国際取引商品番号)のいずれかになります。 |