adstage
Web SDKイベント

カスタムイベント

ビジネスに合った独自のイベントを作成することで、より具体的なユーザー行動を分析できます。

🎯 カスタムイベントを作成する

どんなイベントを作ればよいか?

ビジネスで重視しているユーザー行動があれば、それをイベントにしてみましょう。

// 料理レシピサイトの場合
AdStage.events.track('recipe_bookmarked', {
  recipe_id: 'chicken_curry_123',
  recipe_name: 'チキンカレー',
  difficulty: 'medium',
  cooking_time: 30
});
 
// オンラインショップの場合
AdStage.events.track('wishlist_added', {
  product_id: 'PROD_456',
  product_name: 'ワイヤレスイヤホン',
  price: 89000,
  category: '家電'
});

イベント名はどう付ければよいか?

特別なルールはありませんが、後で探しやすいように意味が明確な名前を使うのがおすすめです。

// このようにしておくと、後で分析するときに区別しやすくなります
AdStage.events.track('video_play_started', { video_id: '123' });
AdStage.events.track('video_play_completed', { video_id: '123' });
 
// 似た機能には、似たパターンで名前を付けると便利です
AdStage.events.track('course_lesson_started', { course_id: 'js101', lesson_id: 'variables' });
AdStage.events.track('course_lesson_completed', { course_id: 'js101', lesson_id: 'variables' });

🏢 業種別の利用例

オンラインショップの場合

次のようなイベントをトラッキングすると、顧客の買い物パターンをより深く理解できます。

// 商品をクイックプレビューしたとき
AdStage.events.track('product_quick_preview', {
  product_id: 'PROD_123',
  product_name: 'ワイヤレスイヤホン',
  price: 89000,
  from_section: 'おすすめ商品'
});
 
// ほしい物リストに追加したとき
AdStage.events.track('added_to_wishlist', {
  product_id: 'PROD_123',
  current_wishlist_count: 5,
  product_price: 89000
});
 
// 再入荷通知を申し込んだとき - これをトラッキングすると人気商品の把握に役立ちます
AdStage.events.track('restock_alert_requested', {
  product_id: 'PROD_456',
  product_name: '品切れ商品',
  user_email_domain: 'gmail.com' // 個人情報はこのように一般化する
});
 
// レビューを書いたとき
AdStage.events.track('review_written', {
  product_id: 'PROD_123',
  rating: 5,
  review_has_photo: true
});

オンライン講座プラットフォームの場合

受講者の学習パターンを分析するには、次のようなイベントが役立ちます。

// 講義をどれだけ視聴したかをトラッキング - これで難しい区間を見つけられます
AdStage.events.track('lesson_watched', {
  course_name: 'JavaScript 入門',
  lesson_title: '変数とデータ型',
  watch_percentage: 75,
  watch_time_minutes: 8,
  rewound_count: 2 // 巻き戻し回数 - 難しい部分を把握できる
});
 
// クイズの結果 - 学習効果の測定に便利です
AdStage.events.track('quiz_finished', {
  quiz_name: 'JS 入門クイズ',
  score: 85,
  total_score: 100,
  attempt_number: 1, // 何回目の挑戦か
  passed: true
});
 
// 修了証を受け取ったとき - 完走率の分析用
AdStage.events.track('course_completed', {
  course_name: 'JavaScript 入門',
  completion_days: 14, // 完走までにかかった日数
  final_score: 92
});

ゲームの場合

プレイヤーのゲームパターンや面白さの要素を分析するには、次のようなイベントが役立ちます。

// ゲームを開始したとき
AdStage.events.track('game_started', {
  game_mode: 'サバイバルモード',
  difficulty: 'むずかしい',
  character_level: 15,
  playtime_today_minutes: 45 // 今日のプレイ時間
});
 
// レベルアップしたとき - ゲームバランスの調整に便利
AdStage.events.track('level_up', {
  new_level: 15,
  time_to_levelup_minutes: 45, // レベルアップにかかった時間
  main_activity: 'monster_hunting' // 主に何をしてレベルアップしたか
});
 
// アイテムを入手したとき
AdStage.events.track('item_obtained', {
  item_name: '伝説の剣',
  item_grade: 'legendary',
  how_obtained: 'ボスドロップ', // どのように入手したか
  player_level: 15
});
 
// 有料アイテムの購入 - 収益分析用
AdStage.events.track('item_purchased', {
  item_type: 'ゲーム内通貨',
  amount: 1000,
  real_price: 9900, // ウォン
  reason: 'ゲーム内通貨の不足' // 購入理由
});

ブログやメディアサイトの場合

どのコンテンツが人気なのか、読者がどのように読んでいるのかを知るには、次のようなイベントがおすすめです。

// 記事を最後まで読んだとき - どの記事が最後まで読まれているかがわかります
AdStage.events.track('article_finished_reading', {
  article_title: '2024 年のテックトレンド',
  category: 'テクノロジー',
  read_time_minutes: 4,
  scroll_percentage: 100,
  word_count: 1200
});
 
// コメントを投稿したとき - エンゲージメントの測定
AdStage.events.track('comment_added', {
  article_title: '面白い記事',
  comment_length: 85,
  is_reply: false, // コメントか返信か
  user_type: 'regular_reader' // 常連の読者かどうか
});
 
// ニュースレターの購読 - ロイヤルティの高い読者の獲得
AdStage.events.track('newsletter_signed_up', {
  newsletter_type: '週間まとめ',
  signup_location: '記事下部の CTA',
  reader_visits_this_month: 5 // 今月の訪問回数
});
 
// 記事の共有 - バイラル効果の測定
AdStage.events.track('article_shared', {
  article_title: '人気記事',
  share_platform: 'twitter',
  share_location: '記事上部' // どこで共有ボタンを押したか
});

💡 実際に使ってみる

カスタムイベントを作るときは、まず「後でこのデータで何を知りたいのか」を考えてみましょう。

// たとえば、ユーザーがいつ離脱するかを知りたい場合
AdStage.events.track('page_exit_attempt', {
  page_name: '商品詳細ページ',
  time_on_page_seconds: 30,
  scroll_depth: 25,
  exit_trigger: 'back_button' // 戻る操作、タブを閉じるなど
});
 
// どの機能が人気かを知りたい場合
AdStage.events.track('feature_used', {
  feature_name: '価格比較',
  user_type: 'premium',
  usage_count_today: 3
});

このようにビジネスに合ったイベントを作成すると、AdStage ダッシュボードで セグメント と ファネル を使った、より正確なユーザー分析ができます。

目次