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 ダッシュボードで セグメント と ファネル を使った、より正確なユーザー分析ができます。

