adstage
Web SDKイベント

基本的なイベントトラッキング

ユーザーの行動とインタラクションをトラッキングすることで、Web サイトの成果を分析し、改善できます。

🚀 基本的なイベントトラッキング

// SDK の初期化
AdStage.init({
  apiKey: 'your-api-key'
});
 
// 基本的なイベントトラッキング
AdStage.events.track('button_click');
 
// 属性付きでイベントをトラッキング
AdStage.events.track('button_click', {
  button_id: 'hero_cta',
  button_text: '今すぐ始める',
  page: '/landing'
});
 
// ページビューのトラッキング(SPA では手動)
AdStage.events.track('page_view', {
  page_title: 'ホームページ',
  page_path: '/',
  referrer: document.referrer
});

📊 一般的なイベントパターン

// EC イベント
AdStage.events.track('view_item', {
  item_id: 'SKU123',
  item_name: 'ワイヤレスイヤホン',
  price: 89000,
  currency: 'KRW'
});
 
AdStage.events.track('add_to_cart', {
  item_id: 'SKU123',
  quantity: 1,
  value: 89000
});
 
AdStage.events.track('purchase', {
  transaction_id: 'T12345',
  value: 178000,
  currency: 'KRW'
});
 
// エンゲージメントイベント
AdStage.events.track('sign_up', {
  method: 'email',
  source: 'homepage'
});
 
AdStage.events.track('search', {
  search_term: 'ワイヤレスイヤホン',
  results_count: 24
});

🎯 ユーザー属性の設定

setUserProperties でサポートされる属性

属性型サポートされる値説明
genderstring'male' | 'female' | 'other' | 'unknown'ユーザーの性別
countrystring自由入力(ISO 3166-1 alpha-2 推奨)国コード(例: 'KR'、'US')
citystring自由入力都市名(例: 'Seoul'、'New York')
agestring自由入力年齢または年齢層(例: '25'、'25-34')
languagestring自由入力(ISO 639-1 推奨)言語コード(例: 'ko-KR'、'en-US')

setDeviceInfo でサポートされる属性

属性型サポートされる値説明
categorystring'mobile' | 'desktop' | 'tablet' | 'other'デバイスカテゴリ
platformstring自由入力プラットフォーム名(例: 'Windows'、'macOS'、'iOS')
modelstring自由入力デバイスモデル(例: 'iPhone 15'、'MacBook Pro')
appVersionstring自由入力アプリのバージョン(例: '1.0.0'、'2.1.3')
osVersionstring自由入力OS のバージョン(例: '14.0'、'macOS 14.1')
// ユーザー属性の設定
AdStage.events.setUserProperties({
  gender: 'male',        // 'male' | 'female' | 'other' | 'unknown'
  country: 'KR',         // 国コード
  city: 'Seoul',         // 都市名
  age: '25-34',          // 年齢層
  language: 'ko-KR'      // 言語コード
});
 
// デバイス情報の設定
AdStage.events.setDeviceInfo({
  category: 'desktop',   // 'mobile' | 'desktop' | 'tablet' | 'other'
  platform: 'Windows',  // プラットフォーム名
  model: 'Surface Pro', // デバイスモデル
  appVersion: '1.0.0',  // アプリのバージョン
  osVersion: 'Windows 11' // OS のバージョン
});

📝 フォームイベントのトラッキング

// フォーム要素を取得
const form = document.getElementById('contact-form');
 
form.addEventListener('submit', (e) => {
  e.preventDefault();
  
  // フォーム送信イベント
  AdStage.events.track('form_submit', {
    form_id: 'contact_form',
    form_type: 'contact',
    success: true
  });
  
  // 実際のフォーム送信ロジック
  submitForm(new FormData(form));
});
 
// フィールドのフォーカスをトラッキング
document.getElementById('email').addEventListener('focus', () => {
  AdStage.events.track('form_field_focus', {
    form_id: 'contact_form',
    field_name: 'email'
  });
});

次のステップ

より高度なイベントトラッキング機能をご確認ください。

目次