Google アナリティクス 4 イベント

add_payment_info

このイベントは、ユーザーが支払い情報を送信したことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
currency string (ISO 4217) × USD イベントに関連付けられた購入または商品アイテムの通貨(3 文字の ISO 4217 形式)。
items Array<Item> × イベントの商品アイテム。
payment_type string × Credit Card 選択した支払い方法。
value number × 7.77 イベントの金銭的価値。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテム ID(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

item_name string ○* jeggings

商品アイテム名(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

quantity number × 1

アイテムの数量。

promotion_id string ○* P_12345 商品プロモーションの ID。promotion_id または promotion name のいずれかが必要です。
promotion_name string ○* Summer Sale 商品プロモーションの名前。promotion_id または promotion name のいずれかが必要です。
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
creative_name string × summer_banner2 プロモーション スポットで使用されたクリエイティブの名前。
creative_slot string × featured_app_1 クリエイティブ スロットの名前。
discount number × 2.22 購入に関連付けられた割引の金銭的価値。
index number × 5 リスト内の商品アイテムのインデックス。
item_brand string × Gucci 商品アイテムのブランド
item_category string × pants 商品アイテム カテゴリ(コンテキスト固有)。商品アイテムに多数のカテゴリがある場合は、item_category2item_category5 も使用できます。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。
item_variant string × Black 商品アイテムのバリエーション。
location_id string × L_12345 イベントに関連付けられている場所。可能であれば、関連する商品アイテムに対応する Google プレイス ID に設定します。カスタムの地域 ID 文字列でオーバーライドすることもできます。
tax number × 1.11 取引に関連付けられた税金。
price number × 9.99 指定された通貨パラメータの単位で表した商品アイテムの価格。
currency string × USD 通貨(3 文字の ISO 4217 形式)。

gtag('event', 'add_payment_info', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  payment_type: 'Credit Card',
  value: 9.99
});

add_shipping_info

このイベントは、ユーザーが配送先情報を送信したことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
currency string (ISO 4217) × USD イベントに関連付けられた購入または商品アイテムの通貨(3 文字の ISO 4217 形式)。
items Array<Item> × イベントの商品アイテム。
shipping_tier string × Ground 購入された商品アイテムの配送方法で選択されている送料区分(GroundAirNext-day など)。
value number × 7.77 イベントの金銭的価値。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテム ID(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

item_name string ○* jeggings

商品アイテム名(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

quantity number × 1

アイテムの数量。

promotion_id string ○* P_12345 商品プロモーションの ID。promotion_id または promotion name のいずれかが必要です。
promotion_name string ○* Summer Sale 商品プロモーションの名前。promotion_id または promotion name のいずれかが必要です。
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
creative_name string × summer_banner2 プロモーション スポットで使用されたクリエイティブの名前。
creative_slot string × featured_app_1 クリエイティブ スロットの名前。
discount number × 2.22 購入に関連付けられた割引の金銭的価値。
index number × 5 リスト内の商品アイテムのインデックス。
item_brand string × Gucci 商品アイテムのブランド
item_category string × pants 商品アイテム カテゴリ(コンテキスト固有)。商品アイテムに多数のカテゴリがある場合は、item_category2item_category5 も使用できます。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。
item_variant string × Black 商品アイテムのバリエーション。
location_id string × L_12345 イベントに関連付けられている場所。可能であれば、関連する商品アイテムに対応する Google プレイス ID に設定します。カスタムの地域 ID 文字列でオーバーライドすることもできます。
tax number × 1.11 取引に関連付けられた税金。
price number × 9.99 指定された通貨パラメータの単位で表した商品アイテムの価格。
currency string × USD 通貨(3 文字の ISO 4217 形式)。

gtag('event', 'add_shipping_info', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'Black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  shipping_tier: 'Ground',
  value: 7.77
});

add_to_cart

このイベントは、購入のために商品アイテムがカートに追加されたことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string × USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。
items Array<Item> × イベントの商品アイテム。
value number × 7.77 イベントの金銭的価値。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテム ID(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

item_name string ○* jeggings

商品アイテム名(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

quantity number × 1

アイテムの数量。

promotion_id string ○* P_12345 商品プロモーションの ID。promotion_id または promotion name のいずれかが必要です。
promotion_name string ○* Summer Sale 商品プロモーションの名前。promotion_id または promotion name のいずれかが必要です。
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
creative_name string × summer_banner2 プロモーション スポットで使用されたクリエイティブの名前。
creative_slot string × featured_app_1 クリエイティブ スロットの名前。
discount number × 2.22 購入に関連付けられた割引の金銭的価値。
index number × 5 リスト内の商品アイテムのインデックス。
item_brand string × Gucci 商品アイテムのブランド
item_category string × pants 商品アイテム カテゴリ(コンテキスト固有)。商品アイテムに多数のカテゴリがある場合は、item_category2item_category5 も使用できます。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。
item_variant string × Black 商品アイテムのバリエーション。
location_id string × L_12345 イベントに関連付けられている場所。可能であれば、関連する商品アイテムに対応する Google プレイス ID に設定します。カスタムの地域 ID 文字列でオーバーライドすることもできます。
tax number × 1.11 取引に関連付けられた税金。
price number × 9.99 指定された通貨パラメータの単位で表した商品アイテムの価格。
currency string × USD 通貨(3 文字の ISO 4217 形式)。

gtag('event', 'add_to_cart', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  value: 7.77
});

add_to_wishlist

このイベントは、商品アイテムがウィッシュリストに追加されたことを示します。アプリで人気のあるギフトアイテムを特定するには、このイベントを使用します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string × USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。
items Array<Item> × イベントの商品アイテム。
value number × 7.77 イベントの金銭的価値。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテム ID(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

item_name string ○* jeggings

商品アイテム名(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

quantity number × 1

アイテムの数量。

promotion_id string ○* P_12345 商品プロモーションの ID。promotion_id または promotion name のいずれかが必要です。
promotion_name string ○* Summer Sale 商品プロモーションの名前。promotion_id または promotion name のいずれかが必要です。
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
creative_name string × summer_banner2 プロモーション スポットで使用されたクリエイティブの名前。
creative_slot string × featured_app_1 クリエイティブ スロットの名前。
discount number × 2.22 購入に関連付けられた割引の金銭的価値。
index number × 5 リスト内の商品アイテムのインデックス。
item_brand string × Gucci 商品アイテムのブランド
item_category string × pants 商品アイテム カテゴリ(コンテキスト固有)。商品アイテムに多数のカテゴリがある場合は、item_category2item_category5 も使用できます。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。
item_variant string × Black 商品アイテムのバリエーション。
location_id string × L_12345 イベントに関連付けられている場所。可能であれば、関連する商品アイテムに対応する Google プレイス ID に設定します。カスタムの地域 ID 文字列でオーバーライドすることもできます。
tax number × 1.11 取引に関連付けられた税金。
price number × 9.99 指定された通貨パラメータの単位で表した商品アイテムの価格。
currency string × USD 通貨(3 文字の ISO 4217 形式)。

gtag('event', 'add_to_wishlist', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  value: 9.99
});

begin_checkout

このイベントは、ユーザーが購入手続きを開始したことを示します。

パラメータ

名前 タイプ 必須 説明
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
currency string (ISO 4217) × USD イベントに関連付けられた購入または商品アイテムの通貨(3 文字の ISO 4217 形式)。
items Array<Item> × イベントの商品アイテム。
value number × 7.77 イベントの金銭的価値。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテム ID(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

item_name string ○* jeggings

商品アイテム名(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

quantity number × 1

アイテムの数量。

promotion_id string ○* P_12345 商品プロモーションの ID。promotion_id または promotion name のいずれかが必要です。
promotion_name string ○* Summer Sale 商品プロモーションの名前。promotion_id または promotion name のいずれかが必要です。
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
creative_name string × summer_banner2 プロモーション スポットで使用されたクリエイティブの名前。
creative_slot string × featured_app_1 クリエイティブ スロットの名前。
discount number × 2.22 購入に関連付けられた割引の金銭的価値。
index number × 5 リスト内の商品アイテムのインデックス。
item_brand string × Gucci 商品アイテムのブランド
item_category string × pants 商品アイテム カテゴリ(コンテキスト固有)。商品アイテムに多数のカテゴリがある場合は、item_category2item_category5 も使用できます。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。
item_variant string × Black 商品アイテムのバリエーション。
location_id string × L_12345 イベントに関連付けられている場所。可能であれば、関連する商品アイテムに対応する Google プレイス ID に設定します。カスタムの地域 ID 文字列でオーバーライドすることもできます。
tax number × 1.11 取引に関連付けられた税金。
price number × 9.99 指定された通貨パラメータの単位で表した商品アイテムの価格。
currency string × USD 通貨(3 文字の ISO 4217 形式)。

gtag('event', 'begin_checkout', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  value: 7.77
});

earn_virtual_currency

このイベントは、仮想通貨の授与を測定します。仮想経済について詳しく把握するには、このイベントを spend_virtual_currency とともにログに記録します

パラメータ

名前 タイプ 必須 説明
virtual_currency_name string × Gems 仮想通貨の名前。
value number × 5 仮想通貨の価値。

gtag('event', 'earn_virtual_currency', {
  virtual_currency_name: 'Gems',
  value: 5
});

generate_lead

リエンゲージメント キャンペーンの効果を把握するには、見込み顧客を発掘したときにこのイベントをログに記録します。

パラメータ

名前 タイプ 必須 説明
currency string × USD 見込み顧客の通貨(3 文字の ISO 4217 形式)。
value number × 99.99 見込み顧客の価値。

gtag('event', 'generate_lead', {
  currency: 'USD',
  value: 99.99,
  transaction_id: 'T_12345'
});

join_group

ユーザーが団体、チーム、ファミリーなどのグループに参加したときに、このイベントをログに記録します。特定のグループまたはソーシャル機能の人気度を分析するには、このイベントを使用します。

パラメータ

名前 タイプ 必須 説明
group_id string × G_12345 グループの ID。

gtag('event', 'join_group', {
  group_id: 'G_12345'
});

level_end

このイベントは、プレーヤーがレベルを終了したことを示します。

パラメータ

名前 タイプ 必須 説明
level_name string × 旅の始まり... レベルの名前。
success boolean × true レベルを完了した場合は、true に設定します。

gtag('event', 'level_end', {
  level_name: 'The journey begins...',
  success: true,
});

level_start

このイベントは、プレーヤーがレベルを開始したことを示します。

パラメータ

名前 タイプ 必須 説明
level_name string × 旅の始まり... レベルの名前。

gtag('event', 'level_start', {
  level_name: 'The journey begins...'
});

level_up

このイベントは、プレーヤーがレベルアップしたことを示します。ユーザーベースのレベル分布を測定して、完了しにくいレベルを特定するには、このイベントを使用します。

パラメータ

名前 タイプ 必須 説明
level number × 5 キャラクターのレベル。
character string × Player 1 レベルアップしたキャラクター。

gtag('event', 'level_up', {
  level: 5,
  character: 'Player 1'
});

login

ユーザーがログインしたことを示すには、このイベントを送信します。

パラメータ

名前 タイプ 必須 説明
method string × Google ログインに使用するメソッド。

gtag('event', 'login', {
  method: 'Google'
});

post_score

このイベントは、ユーザーがスコアを投稿したときに送信します。ゲーム内でのユーザーのパフォーマンスを把握して、ハイスコアをオーディエンスや行動と関連付けるには、このイベントを使用します。

パラメータ

名前 タイプ 必須 説明
score number 10000 投稿するスコア。
level number × 5 スコアのレベル。
character string × Player 1 スコアを達成したキャラクター。

gtag('event', 'post_score', {
  score: 10000,
  level: 5,
  character: 'Player 1'
});

purchase

このイベントは、ユーザーが 1 つ以上の商品アイテムを購入したことを示します。

パラメータ

名前 タイプ 必須 説明
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
currency string (ISO 4217) × USD イベントに関連付けられた購入または商品アイテムの通貨(3 文字の ISO 4217 形式)。
items Array<Item> × イベントの商品アイテム。
transaction_id string × T_12345 取引を一意に識別する ID。
shipping number × 3.33 取引に関連付けられた送料。
tax number × 1.11 取引に関連付けられた税金。
value number × 12.21 指定された通貨パラメータの単位で表したイベントの金銭的価値。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテム ID(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

item_name string ○* jeggings

商品アイテム名(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

quantity number × 1

アイテムの数量。

promotion_id string ○* P_12345 商品プロモーションの ID。promotion_id または promotion name のいずれかが必要です。
promotion_name string ○* Summer Sale 商品プロモーションの名前。promotion_id または promotion name のいずれかが必要です。
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
creative_name string × summer_banner2 プロモーション スポットで使用されたクリエイティブの名前。
creative_slot string × featured_app_1 クリエイティブ スロットの名前。
discount number × 2.22 購入に関連付けられた割引の金銭的価値。
index number × 5 リスト内の商品アイテムのインデックス。
item_brand string × Gucci 商品アイテムのブランド
item_category string × pants 商品アイテム カテゴリ(コンテキスト固有)。商品アイテムに多数のカテゴリがある場合は、item_category2item_category5 も使用できます。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。
item_variant string × Black 商品アイテムのバリエーション。
location_id string × L_12345 イベントに関連付けられている場所。可能であれば、関連する商品アイテムに対応する Google プレイス ID に設定します。カスタムの地域 ID 文字列でオーバーライドすることもできます。
tax number × 1.11 取引に関連付けられた税金。
price number × 9.99 指定された通貨パラメータの単位で表した商品アイテムの価格。
currency string × USD 通貨(3 文字の ISO 4217 形式)。

gtag('event', 'purchase', {
  affiliation: 'Google Store',
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }, {
    item_id: 'SKU_12346',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'gray',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  transaction_id: 'T_12345',
  shipping: 3.33,
  value: 21.09,
  tax: 2.22
})

refund

このイベントは、払い戻しが行われたことを示します。

パラメータ

名前 タイプ 必須 説明
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
currency string (ISO 4217) × USD イベントに関連付けられた購入または商品アイテムの通貨(3 文字の ISO 4217 形式)。
items Array<Item> × イベントの商品アイテム。商品アイテムは全額払い戻しのために省略されることがあります。
transaction_id string × T_12345 取引を一意に識別する ID。
shipping number × 3.33 取引に関連付けられた送料。
tax number × 1.11 取引に関連付けられた税金。
value number × 12.21 指定された通貨パラメータの単位で表したイベントの金銭的価値。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテム ID(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

item_name string ○* jeggings

商品アイテム名(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

quantity number × 1

アイテムの数量。

promotion_id string ○* P_12345 商品プロモーションの ID。promotion_id または promotion name のいずれかが必要です。
promotion_name string ○* Summer Sale 商品プロモーションの名前。promotion_id または promotion name のいずれかが必要です。
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
creative_name string × summer_banner2 プロモーション スポットで使用されたクリエイティブの名前。
creative_slot string × featured_app_1 クリエイティブ スロットの名前。
discount number × 2.22 購入に関連付けられた割引の金銭的価値。
index number × 5 リスト内の商品アイテムのインデックス。
item_brand string × Gucci 商品アイテムのブランド
item_category string × pants 商品アイテム カテゴリ(コンテキスト固有)。商品アイテムに多数のカテゴリがある場合は、item_category2item_category5 も使用できます。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。
item_variant string × Black 商品アイテムのバリエーション。
location_id string × L_12345 イベントに関連付けられている場所。可能であれば、関連する商品アイテムに対応する Google プレイス ID に設定します。カスタムの地域 ID 文字列でオーバーライドすることもできます。
tax number × 1.11 取引に関連付けられた税金。
price number × 9.99 指定された通貨パラメータの単位で表した商品アイテムの価格。
currency string × USD 通貨(3 文字の ISO 4217 形式)。

全額払い戻し

gtag('event', 'refund', {
  affiliation: 'Google Store',
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  transaction_id: 'T_12345',
  shipping: 3.33,
  value: 12.21,
  tax: 1.11
});

一部払い戻し

gtag('event', 'refund', {
  affiliation: 'Google Store',
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  transaction_id: 'T_12345',
  shipping: 3.33,
  value: 12.21,
  tax: 1.11
});

remove_from_cart

このイベントは、商品アイテムがカートから削除されたことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string × USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。
items Array<Item> × イベントの商品アイテム。
value number × 7.77 イベントの金銭的価値。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテム ID(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

item_name string ○* jeggings

商品アイテム名(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

quantity number × 1

アイテムの数量。

promotion_id string ○* P_12345 商品プロモーションの ID。promotion_id または promotion name のいずれかが必要です。
promotion_name string ○* Summer Sale 商品プロモーションの名前。promotion_id または promotion name のいずれかが必要です。
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
creative_name string × summer_banner2 プロモーション スポットで使用されたクリエイティブの名前。
creative_slot string × featured_app_1 クリエイティブ スロットの名前。
discount number × 2.22 購入に関連付けられた割引の金銭的価値。
index number × 5 リスト内の商品アイテムのインデックス。
item_brand string × Gucci 商品アイテムのブランド
item_category string × pants 商品アイテム カテゴリ(コンテキスト固有)。商品アイテムに多数のカテゴリがある場合は、item_category2item_category5 も使用できます。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。
item_variant string × Black 商品アイテムのバリエーション。
location_id string × L_12345 イベントに関連付けられている場所。可能であれば、関連する商品アイテムに対応する Google プレイス ID に設定します。カスタムの地域 ID 文字列でオーバーライドすることもできます。
tax number × 1.11 取引に関連付けられた税金。
price number × 9.99 指定された通貨パラメータの単位で表した商品アイテムの価格。
currency string × USD 通貨(3 文字の ISO 4217 形式)。

gtag('event', 'remove_from_cart', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  value: 7.77
});

検索処理の状況に関する情報を取得するには、このイベントを使用します。このイベントを使用すると、アプリで最も人気のあるコンテンツを特定できます。

パラメータ

名前 タイプ 必須 説明
search_term string t-shirts 検索されたキーワード。

gtag('event', 'search', {
  search_term: 't-shirts'
});

select_content

このイベントは、ユーザーが特定のタイプのコンテンツを選択したことを示します。 このイベントを使用すると、アプリで人気のあるコンテンツやコンテンツのカテゴリを特定できます。

パラメータ

名前 タイプ 必須 値の例 説明
content_type string × product 選択されたコンテンツの種類。
item_id string × I_12345 選択された商品アイテムの識別子。

gtag('event', 'select_content', {
  content_type: 'product',
  item_id: 'I_12345'
});

select_item

このイベントは、リストから商品アイテムが選択されたことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
items Array<Item> × イベントの商品アイテム。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテム ID(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

item_name string ○* jeggings

商品アイテム名(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

quantity number × 1

アイテムの数量。

promotion_id string ○* P_12345 商品プロモーションの ID。promotion_id または promotion name のいずれかが必要です。
promotion_name string ○* Summer Sale 商品プロモーションの名前。promotion_id または promotion name のいずれかが必要です。
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
creative_name string × summer_banner2 プロモーション スポットで使用されたクリエイティブの名前。
creative_slot string × featured_app_1 クリエイティブ スロットの名前。
discount number × 2.22 購入に関連付けられた割引の金銭的価値。
index number × 5 リスト内の商品アイテムのインデックス。
item_brand string × Gucci 商品アイテムのブランド
item_category string × pants 商品アイテム カテゴリ(コンテキスト固有)。商品アイテムに多数のカテゴリがある場合は、item_category2item_category5 も使用できます。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。
item_variant string × Black 商品アイテムのバリエーション。
location_id string × L_12345 イベントに関連付けられている場所。可能であれば、関連する商品アイテムに対応する Google プレイス ID に設定します。カスタムの地域 ID 文字列でオーバーライドすることもできます。
tax number × 1.11 取引に関連付けられた税金。
price number × 9.99 指定された通貨パラメータの単位で表した商品アイテムの価格。
currency string × USD 通貨(3 文字の ISO 4217 形式)。

gtag('event', 'select_item', {
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    index: 5,
    item_list_name: 'Related Products',
    item_list_id: 'related_products',
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  item_list_name: 'Related products',
  item_list_id: 'related_products'
});

select_promotion

このイベントは、リストからプロモーションが選択されたことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
items Array<Item> × イベントの商品アイテム。
location_id string × L_12345 地域の ID。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテム ID(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

item_name string ○* jeggings

商品アイテム名(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

quantity number × 1

アイテムの数量。

promotion_id string ○* P_12345 商品プロモーションの ID。promotion_id または promotion name のいずれかが必要です。
promotion_name string ○* Summer Sale 商品プロモーションの名前。promotion_id または promotion name のいずれかが必要です。
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
creative_name string × summer_banner2 プロモーション スポットで使用されたクリエイティブの名前。
creative_slot string × featured_app_1 クリエイティブ スロットの名前。
discount number × 2.22 購入に関連付けられた割引の金銭的価値。
index number × 5 リスト内の商品アイテムのインデックス。
item_brand string × Gucci 商品アイテムのブランド
item_category string × pants 商品アイテム カテゴリ(コンテキスト固有)。商品アイテムに多数のカテゴリがある場合は、item_category2item_category5 も使用できます。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。
item_variant string × Black 商品アイテムのバリエーション。
location_id string × L_12345 イベントに関連付けられている場所。可能であれば、関連する商品アイテムに対応する Google プレイス ID に設定します。カスタムの地域 ID 文字列でオーバーライドすることもできます。
tax number × 1.11 取引に関連付けられた税金。
price number × 9.99 指定された通貨パラメータの単位で表した商品アイテムの価格。
currency string × USD 通貨(3 文字の ISO 4217 形式)。

gtag('event', 'select_promotion', {
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    promotion_id: 'P_12345',
    promotion_name: 'Summer Sale',
    creative_name: 'Summer Banner',
    creative_slot: 'featured_app_1',
    location_id: 'L_12345',
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'Black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  location_id: 'L_12345'
});

share

話題性のあるコンテンツを特定するには、このイベントを使用します。

パラメータ

名前 タイプ 必須 説明
method string × Twitter コンテンツを共有する方法。
content_type string × image 共有コンテンツの種類。
content_id string × C_12345 共有コンテンツの ID。

gtag('event', 'share', {
  method: 'Twitter',
  content_type: 'image',
  content_id: 'C_12345',
});

sign_up

このイベントは、ユーザーがアカウントに登録したことを示します。ログインしているユーザーとログインしていないユーザーの行動の違いを把握するには、このイベントを使用します。

パラメータ

名前 タイプ 必須 説明
method string × Google 登録に使用された方法。

gtag('event', 'sign_up', {
  method: 'Google'
});

spend_virtual_currency

このイベントでは、アプリ内の仮想アイテムの売り上げを測定して、最も人気のある仮想アイテムを特定することができます。

パラメータ

名前 タイプ 必須 説明
item_name string × Starter Boost 仮想通貨が使用されている商品アイテムの名前。
virtual_currency_name string Gems 仮想通貨の名前。
value number 5 仮想通貨の価値。

gtag('event', 'spend_virtual_currency', {
  item_name: 'Starter Boost',
  virtual_currency_name: 'Gems',
  value: 5
});

tutorial_begin

このイベントは、オンボーディング プロセスの開始を示します。チュートリアルを完了したユーザー数を把握するには、このイベントを目標到達プロセスで tutorial_complete とともに使用します。

パラメータ

このイベントのパラメータはありません。

gtag('event', 'tutorial_begin');

tutorial_complete

このイベントは、ユーザーがオンボーディング プロセスを完了したことを示します。チュートリアルを完了したユーザー数を把握するには、このイベントを目標到達プロセスで tutorial_begin とともに使用します。

パラメータ

このイベントで使用するパラメータの候補はありません。

gtag('event', 'tutorial_complete');

unlock_achievement

ユーザーがレベルを達成したときに、このイベントをログに記録します。このイベントを使用すると、ユーザーによるゲームの利用状況を把握できます。

パラメータ

名前 タイプ 必須 説明
achievement_id string A_12345 達成されたレベルの ID。

gtag('event', 'unlock_achievement', {
  achievement_id: 'A_12345'
});

view_cart

このイベントは、ユーザーがカートを表示したことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string × USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。
items Array<Item> × イベントの商品アイテム。
value number × 7.77 イベントの金銭的価値。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテム ID(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

item_name string ○* jeggings

商品アイテム名(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

quantity number × 1

アイテムの数量。

promotion_id string ○* P_12345 商品プロモーションの ID。promotion_id または promotion name のいずれかが必要です。
promotion_name string ○* Summer Sale 商品プロモーションの名前。promotion_id または promotion name のいずれかが必要です。
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
creative_name string × summer_banner2 プロモーション スポットで使用されたクリエイティブの名前。
creative_slot string × featured_app_1 クリエイティブ スロットの名前。
discount number × 2.22 購入に関連付けられた割引の金銭的価値。
index number × 5 リスト内の商品アイテムのインデックス。
item_brand string × Gucci 商品アイテムのブランド
item_category string × pants 商品アイテム カテゴリ(コンテキスト固有)。商品アイテムに多数のカテゴリがある場合は、item_category2item_category5 も使用できます。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。
item_variant string × Black 商品アイテムのバリエーション。
location_id string × L_12345 イベントに関連付けられている場所。可能であれば、関連する商品アイテムに対応する Google プレイス ID に設定します。カスタムの地域 ID 文字列でオーバーライドすることもできます。
tax number × 1.11 取引に関連付けられた税金。
price number × 9.99 指定された通貨パラメータの単位で表した商品アイテムの価格。
currency string × USD 通貨(3 文字の ISO 4217 形式)。

gtag('event', 'view_cart', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  value: 7.77
});

view_item

このイベントは、一部のコンテンツがユーザーに表示されたことを示します。最もよく閲覧されている商品アイテムを特定するには、このイベントを使用します。

パラメータ

名前 タイプ 必須 説明
currency string × USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。
items Array<Item> × イベントの商品アイテム。
value number × 7.77 イベントの金銭的価値。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテム ID(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

item_name string ○* jeggings

商品アイテム名(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

quantity number × 1

アイテムの数量。

promotion_id string ○* P_12345 商品プロモーションの ID。promotion_id または promotion name のいずれかが必要です。
promotion_name string ○* Summer Sale 商品プロモーションの名前。promotion_id または promotion name のいずれかが必要です。
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
creative_name string × summer_banner2 プロモーション スポットで使用されたクリエイティブの名前。
creative_slot string × featured_app_1 クリエイティブ スロットの名前。
discount number × 2.22 購入に関連付けられた割引の金銭的価値。
index number × 5 リスト内の商品アイテムのインデックス。
item_brand string × Gucci 商品アイテムのブランド
item_category string × pants 商品アイテム カテゴリ(コンテキスト固有)。商品アイテムに多数のカテゴリがある場合は、item_category2item_category5 も使用できます。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。
item_variant string × Black 商品アイテムのバリエーション。
location_id string × L_12345 イベントに関連付けられている場所。可能であれば、関連する商品アイテムに対応する Google プレイス ID に設定します。カスタムの地域 ID 文字列でオーバーライドすることもできます。
tax number × 1.11 取引に関連付けられた税金。
price number × 9.99 指定された通貨パラメータの単位で表した商品アイテムの価格。
currency string × USD 通貨(3 文字の ISO 4217 形式)。

gtag('event', 'view_item', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  value: 9.99
});

view_item_list

ユーザーに特定のカテゴリの商品アイテムのリストが表示されたときに、このイベントをログに記録します。

パラメータ

名前 タイプ 必須 説明
items Array<Item> × イベントの商品アイテム。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテム ID(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

item_name string ○* jeggings

商品アイテム名(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

quantity number × 1

アイテムの数量。

promotion_id string ○* P_12345 商品プロモーションの ID。promotion_id または promotion name のいずれかが必要です。
promotion_name string ○* Summer Sale 商品プロモーションの名前。promotion_id または promotion name のいずれかが必要です。
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
creative_name string × summer_banner2 プロモーション スポットで使用されたクリエイティブの名前。
creative_slot string × featured_app_1 クリエイティブ スロットの名前。
discount number × 2.22 購入に関連付けられた割引の金銭的価値。
index number × 5 リスト内の商品アイテムのインデックス。
item_brand string × Gucci 商品アイテムのブランド
item_category string × pants 商品アイテム カテゴリ(コンテキスト固有)。商品アイテムに多数のカテゴリがある場合は、item_category2item_category5 も使用できます。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。
item_variant string × Black 商品アイテムのバリエーション。
location_id string × L_12345 イベントに関連付けられている場所。可能であれば、関連する商品アイテムに対応する Google プレイス ID に設定します。カスタムの地域 ID 文字列でオーバーライドすることもできます。
tax number × 1.11 取引に関連付けられた税金。
price number × 9.99 指定された通貨パラメータの単位で表した商品アイテムの価格。
currency string × USD 通貨(3 文字の ISO 4217 形式)。

gtag('event', 'view_item_list', {
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    index: 5,
    item_list_name: 'Related Products',
    item_list_id: 'related_products',
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  item_list_name: 'Related products',
  item_list_id: 'related_products'
});

view_promotion

このイベントは、リストからプロモーションが表示されたことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
items Array<Item> × イベントの商品アイテム。
location_id string × L_12345 地域の ID。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテム ID(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

item_name string ○* jeggings

商品アイテム名(コンテキスト固有)。

*商品データやインプレッション データには、item_id または item_name のいずれかが必要です。

quantity number × 1

アイテムの数量。

promotion_id string ○* P_12345 商品プロモーションの ID。promotion_id または promotion name のいずれかが必要です。
promotion_name string ○* Summer Sale 商品プロモーションの名前。promotion_id または promotion name のいずれかが必要です。
affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
coupon string × SUMMER_FUN 購入に使用されたクーポンコード。
creative_name string × summer_banner2 プロモーション スポットで使用されたクリエイティブの名前。
creative_slot string × featured_app_1 クリエイティブ スロットの名前。
discount number × 2.22 購入に関連付けられた割引の金銭的価値。
index number × 5 リスト内の商品アイテムのインデックス。
item_brand string × Gucci 商品アイテムのブランド
item_category string × pants 商品アイテム カテゴリ(コンテキスト固有)。商品アイテムに多数のカテゴリがある場合は、item_category2item_category5 も使用できます。
item_list_name string × Related products ユーザーに商品アイテムが表示されたリストの名前。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。
item_variant string × Black 商品アイテムのバリエーション。
location_id string × L_12345 イベントに関連付けられている場所。可能であれば、関連する商品アイテムに対応する Google プレイス ID に設定します。カスタムの地域 ID 文字列でオーバーライドすることもできます。
tax number × 1.11 取引に関連付けられた税金。
price number × 9.99 指定された通貨パラメータの単位で表した商品アイテムの価格。
currency string × USD 通貨(3 文字の ISO 4217 形式)。

gtag('event', 'view_promotion', {
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    promotion_id: 'P_12345',
    promotion_name: 'Summer Sale',
    creative_slot: 'featured_app_1',
    location_id: 'L_12345',
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'Black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  location_id: 'L_12345'
});