adstage
Web SDKイベント

標準イベントガイド

AdStage 標準イベントガイド

目次

  1. 概要
  2. 標準イベント一覧
  3. カテゴリ別イベントガイド

概要

このドキュメントでは重複する説明を省き、標準イベントの一覧とカテゴリ別の例だけを簡潔にまとめています。

すべての例は 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画面の閲覧
ECadd_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任意のカスタムイベント

カテゴリ別イベントガイド

広告トラッキングイベント (AD_TRACKING)

広告の成果測定とアトリビューションの中核となる 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',
});

ライフサイクルイベント (LIFECYCLE)

ユーザー認証やアカウント管理、アプリの起動に関するイベントです。

対応イベント: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',
});

コンテンツ閲覧イベント (CONTENT)

ユーザーのページ閲覧や画面遷移、コンテンツの探索をトラッキングするイベントです。

対応イベント: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,
    },
  ],
});

EC イベント (ECOMMERCE)

オンラインショッピングと購入プロセスをトラッキングする中核的なイベントです。

対応イベント: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: [
    /* 返金する商品の一覧 */
  ],
});

サブスクリプションとトライアルのイベント (SUBSCRIPTION)

サブスクリプションと無料トライアルに関する中核的なイベントです。

対応イベント: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)

アプリ内に表示される広告の成果を測定するためのイベントです。

対応イベント: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',
});

進行と達成のイベント (PROGRESSION)

ユーザーの学習、ゲーム、業務などの進行状況と達成をトラッキングするイベントです。

対応イベント: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: '初勝利',
});

インタラクションイベント (ENGAGEMENT)

ユーザーとコンテンツとのインタラクションをトラッキングするイベントです。

対応イベント: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',
});

金融イベント (FINANCE)

証券、カード、口座など、金融サービスに特化したイベントです。

対応イベント: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',
});

ゲームイベント (GAMING)

ゲームサービスに特化したイベントです。

対応イベント: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。 マッピングが難しい名前は、そのままカスタムイベントとして送信してもかまいません。

目次