標準イベントガイド
- 概要
- 標準イベント一覧
- カテゴリ別イベントガイド
このドキュメントでは重複する説明を省き、標準イベントの一覧とカテゴリ別の例だけを簡潔にまとめています。
すべての例は AdStage.events.track(eventName, properties) の形式でイベントを送信します。
イベント名には任意の文字列を使えるため、以下の標準イベントにない名前もカスタムイベントとして
自由に送信できます。ただし、アトリビューションやコンバージョン分析で一貫した集計を得るには、
できるだけ以下の標準イベント名を使うことをおすすめします。
| カテゴリ | イベント名 | 説明 |
|---|
| 広告トラッキング | click | 広告のクリック |
| view | 広告の表示/閲覧 |
| install | アプリのインストール |
| ライフサイクル | sign_up | 会員登録の完了 |
| sign_up_start | 会員登録の開始 |
| login | ログイン |
| logout | ログアウト |
| first_open | 初回起動 |
| コンテンツ閲覧 | home_view | ホーム画面の閲覧 |
| product_list_view | 商品一覧の閲覧 |
| search_result_view | 検索結果の閲覧 |
| product_details_view | 商品詳細の閲覧 |
| page_view | ページの閲覧 |
| screen_view | 画面の閲覧 |
| EC | add_to_cart | カートに追加 |
| remove_from_cart | カートから削除 |
| add_to_wishlist | ウィッシュリストに追加 |
| add_payment_info | 支払い情報の追加 |
| begin_checkout | 決済の開始 |
| purchase | 購入完了 |
| refund | 返金 |
| サブスク・トライアル | start_trial | 無料トライアルの開始 |
| subscribe | サブスクリプションの開始 |
| unsubscribe | サブスクリプションの解約 |
| アプリ内広告 | ad_impression | アプリ内広告のインプレッション |
| ad_click | アプリ内広告のクリック |
| 進行・達成 | tutorial_begin | チュートリアルの開始 |
| tutorial_complete | チュートリアルの完了 |
| level_up | レベルアップ |
| achievement | 実績の達成 |
| インタラクション | search | 検索 |
| select_content | コンテンツの選択/クリック |
| share | シェア |
| like | いいね |
| rate | 評価の登録 |
| schedule | 予約 |
| spend_credits | クレジットの使用 |
| 金融 | sell_stock | 株式の売却 |
| buy_stock | 株式の購入 |
| complete_open_account | 口座開設の完了 |
| apply_card | カードの申し込み |
| ゲーム | game_play | ゲームプレイ |
| acquire_bonus | ボーナスの獲得 |
| select_game_server | ゲームサーバーの選択 |
| complete_patch | パッチの完了 |
| カスタム | custom | 任意のカスタムイベント |
広告の成果測定とアトリビューションの中核となる MMP イベントです。
対応イベント:click、view、install
// 広告のクリック
AdStage.events.track('click', {
ad_platform: 'google_ads',
ad_campaign: 'summer_campaign',
ad_content: 'banner_01',
});
// 広告の表示/閲覧
AdStage.events.track('view', {
ad_platform: 'google_ads',
ad_campaign: 'summer_campaign',
});
// アプリのインストール
AdStage.events.track('install', {
ad_platform: 'facebook_ads',
ad_campaign: 'brand_awareness',
});
ユーザー認証やアカウント管理、アプリの起動に関するイベントです。
対応イベント:sign_up、sign_up_start、login、logout、first_open
// 会員登録の開始
AdStage.events.track('sign_up_start', {
method: 'email', // 登録方法:email、google、facebook など
});
// 会員登録の完了
AdStage.events.track('sign_up', {
method: 'email',
});
// ログイン
AdStage.events.track('login', {
method: 'google', // ログイン方法
});
// ログアウト
AdStage.events.track('logout');
// 初回起動(アプリ/Web への初回アクセス)
AdStage.events.track('first_open', {
source: 'notification',
campaign: 'push_campaign_01',
});
ユーザーのページ閲覧や画面遷移、コンテンツの探索をトラッキングするイベントです。
対応イベント:home_view、product_list_view、search_result_view、product_details_view、page_view、screen_view
// ホーム画面の閲覧
AdStage.events.track('home_view', {
page_location: window.location.href,
});
// ページの閲覧
AdStage.events.track('page_view', {
page_title: '商品一覧',
page_location: window.location.href,
content_group1: 'product_category',
});
// 画面の閲覧(SPA アプリ)
AdStage.events.track('screen_view', {
screen_name: 'product_list',
screen_class: 'ProductListPage',
});
// 商品一覧の閲覧
AdStage.events.track('product_list_view', {
item_list_id: 'bestsellers',
item_list_name: 'ベストセラー商品',
items: [
/* 商品の配列 */
],
});
// 検索結果の閲覧
AdStage.events.track('search_result_view', {
search_term: 'スマートフォン',
number_of_results: 24,
});
// 商品詳細の閲覧
AdStage.events.track('product_details_view', {
currency: 'KRW',
value: 29000,
items: [
{
item_id: 'PROD_123',
item_name: 'スマートウォッチ',
item_category: 'Electronics',
item_brand: 'Samsung',
price: 29000,
quantity: 1,
},
],
});
オンラインショッピングと購入プロセスをトラッキングする中核的なイベントです。
対応イベント:add_to_cart、remove_from_cart、add_to_wishlist、add_payment_info、begin_checkout、purchase、refund
// カートに追加
AdStage.events.track('add_to_cart', {
currency: 'KRW',
value: 29000,
items: [
{
item_id: 'PROD_123',
item_name: 'スマートウォッチ',
quantity: 1,
price: 29000,
},
],
});
// カートから削除
AdStage.events.track('remove_from_cart', {
currency: 'KRW',
value: 29000,
items: [
{
item_id: 'PROD_123',
quantity: 1,
},
],
});
// ウィッシュリストに追加
AdStage.events.track('add_to_wishlist', {
currency: 'KRW',
value: 29000,
items: [
{
item_id: 'PROD_123',
item_name: 'スマートウォッチ',
price: 29000,
},
],
});
// 決済の開始
AdStage.events.track('begin_checkout', {
currency: 'KRW',
value: 58000,
coupon: 'SUMMER10',
items: [
/* 決済する商品の一覧 */
],
});
// 支払い情報の追加
AdStage.events.track('add_payment_info', {
currency: 'KRW',
value: 58000,
payment_type: 'credit_card',
});
// 購入完了
AdStage.events.track('purchase', {
transaction_id: 'T_12345',
currency: 'KRW',
value: 58000,
coupon: 'SUMMER10',
shipping: 3000,
tax: 5800,
items: [
/* 購入した商品の一覧 */
],
});
// 返金
AdStage.events.track('refund', {
transaction_id: 'T_12345',
currency: 'KRW',
value: 29000,
items: [
/* 返金する商品の一覧 */
],
});
サブスクリプションと無料トライアルに関する中核的なイベントです。
対応イベント:start_trial、subscribe、unsubscribe
// 無料トライアルの開始
AdStage.events.track('start_trial', {
trial_days: 7,
plan_name: 'premium_trial',
});
// サブスクリプションの開始
AdStage.events.track('subscribe', {
subscription_id: 'SUB_123',
plan_name: 'premium_monthly',
value: 9.99,
currency: 'USD',
});
// サブスクリプションの解約
AdStage.events.track('unsubscribe', {
subscription_id: 'SUB_123',
plan_name: 'premium_monthly',
cancellation_reason: 'price',
});
アプリ内に表示される広告の成果を測定するためのイベントです。
対応イベント:ad_impression、ad_click
// アプリ内広告のインプレッション
AdStage.events.track('ad_impression', {
ad_platform: 'google_ads',
ad_source: 'google',
ad_medium: 'cpc',
ad_campaign: 'summer_campaign',
ad_content: 'banner_01',
value: 0.5,
});
// アプリ内広告のクリック
AdStage.events.track('ad_click', {
ad_platform: 'facebook_ads',
ad_source: 'facebook',
ad_medium: 'social',
ad_campaign: 'brand_awareness',
});
ユーザーの学習、ゲーム、業務などの進行状況と達成をトラッキングするイベントです。
対応イベント:tutorial_begin、tutorial_complete、level_up、achievement
// チュートリアルの開始
AdStage.events.track('tutorial_begin');
// チュートリアルの完了
AdStage.events.track('tutorial_complete', {
tutorial_id: 'basic_tutorial',
completion_time: 300, // 秒
});
// レベルアップ
AdStage.events.track('level_up', {
level: 5,
character: 'warrior',
});
// 実績の達成
AdStage.events.track('achievement', {
achievement_id: 'first_win',
achievement_name: '初勝利',
});
ユーザーとコンテンツとのインタラクションをトラッキングするイベントです。
対応イベント:search、select_content、share、like、rate、schedule、spend_credits
// 検索
AdStage.events.track('search', {
search_term: 'スマートフォン',
content_group1: 'electronics',
});
// コンテンツの選択/クリック
AdStage.events.track('select_content', {
content_type: 'product',
content_id: 'PROD_123',
});
// シェア
AdStage.events.track('share', {
content_type: 'product',
content_id: 'PROD_123',
method: 'facebook',
});
// いいね
AdStage.events.track('like', {
content_type: 'product',
content_id: 'PROD_123',
});
// 評価の登録
AdStage.events.track('rate', {
content_type: 'product',
content_id: 'PROD_123',
rating: 5,
});
// 予約
AdStage.events.track('schedule', {
content_type: 'consultation',
scheduled_at: '2026-07-01T10:00:00Z',
});
// クレジットの使用
AdStage.events.track('spend_credits', {
credit_name: 'coins',
value: 100,
item_name: 'power_up',
});
証券、カード、口座など、金融サービスに特化したイベントです。
対応イベント:sell_stock、buy_stock、complete_open_account、apply_card
// 株式の購入
AdStage.events.track('buy_stock', {
symbol: 'AAPL',
quantity: 10,
price: 190.5,
currency: 'USD',
});
// 株式の売却
AdStage.events.track('sell_stock', {
symbol: 'AAPL',
quantity: 5,
price: 195.2,
currency: 'USD',
});
// 口座開設の完了
AdStage.events.track('complete_open_account', {
account_type: 'securities',
});
// カードの申し込み
AdStage.events.track('apply_card', {
card_type: 'credit',
product_name: 'travel_card',
});
ゲームサービスに特化したイベントです。
対応イベント:game_play、acquire_bonus、select_game_server、complete_patch
// ゲームプレイ
AdStage.events.track('game_play', {
stage: 'world_1',
mode: 'single',
});
// ボーナスの獲得
AdStage.events.track('acquire_bonus', {
bonus_type: 'daily_login',
value: 50,
});
// ゲームサーバーの選択
AdStage.events.track('select_game_server', {
server_id: 'asia_01',
server_name: 'アジア第 1 サーバー',
});
// パッチの完了
AdStage.events.track('complete_patch', {
patch_version: '1.2.0',
});
標準イベントでは扱えないビジネス固有のイベントは、任意の名前で自由に送信できます。
イベント名には Firebase Analytics スタイルの文字列をそのまま使い、標準イベント一覧にない
名前もそのまま収集されます。
// ビジネス固有のカスタムイベント(任意の名前)
AdStage.events.track('newsletter_subscribe', {
source: 'footer_form',
campaign: 'summer_news',
});
// リード獲得など、標準にないマーケティングイベントもカスタムで送信
AdStage.events.track('generate_lead', {
currency: 'KRW',
value: 0, // 見込み顧客の価値
content_id: 'newsletter_signup',
});
標準の分類にない名前(例:view_item、view_item_list、view_search_results、level_start、
unlock_achievement、spend_virtual_currency など)を使っていた場合は、できるだけ上記の標準イベント名に
マッピングして使うことをおすすめします。例:view_item → product_details_view、
view_item_list → product_list_view、view_search_results → search_result_view、
unlock_achievement → achievement、spend_virtual_currency → spend_credits。
マッピングが難しい名前は、そのままカスタムイベントとして送信してもかまいません。