ビルトインイベントリファレンス
Singular SDKおよびS2S連携で自動マッピングされるイベントの総合ガイドです。 イベントの種類、トラッキングトリガー、レポートの表示場所を網羅しています。
自動イベントトラッキング: アプリにSingular SDKまたはS2Sを連携すると、追加設定なしで特定のイベントが 自動的にマッピングされ、Singularプラットフォームでトラッキングされます。
これらのビルトインイベントは、ユーザーレベルレポート、パートナーポストバック、 集計アナリティクスに自動的に表示され、キャンペーン測定とユーザー行動分析の 基盤となる指標を提供します。
自動イベントトラッキング
SDKの初期化による利点
Singular SDKが初期化されるかS2S連携が設定されると、Singularは追加実装なしで コアイベントを自動的にレポートします。
自動トラッキング指標:
- インストール: ユニークデバイスの初回セッションが自動的にトラッキングされます
- セッション: すべてのアプリ起動とユーザーセッションが監視されます
- DAU: 日次アクティブユーザーがセッションデータから計算されます
- リテンション: コホート全体のユーザー復帰率が測定されます
収益イベントの設定: インストールとセッションイベントは自動ですが、収益イベントはSDK収益メソッドまたは S2S収益パラメーターを使ってアプリ内で設定が必要です。設定後は、以降のすべての 購入に対して収益トラッキングが自動的に行われます。
イベントレポートの表示場所
ビルトインイベントが表示される場所
ビルトインイベントはSingularプラットフォームの複数のレポートおよびデータエクスポート 場所に自動的に表示されます。
| 場所 | 説明 |
|---|---|
| ユーザーレベルアトリビューションログ |
タイムスタンプとアトリビューション情報を含むすべてのビルトインイベントを 含む、ユーザーレベルの詳細データをエクスポートします。 |
| パートナーポストバック |
パートナーが自動生成イベント名を受信するよう設定されている場合、 キャンペーン最適化のためにビルトインイベントをパートナープラットフォームに送信します。 パートナー設定 → イベントポストバックで設定します |
| 内部BIポストバック |
カスタム分析とレポートのために、ビルトインイベントを内部ビジネスインテリジェンス システムに転送します。 |
| SKANコンバージョンモデル |
iOSキャンペーン最適化のため、SKAdNetworkコンバージョン値マッピングに ビルトインイベントを含めます。 SKANコンバージョンモデルビルダーで設定します |
自動マッピングされるイベントの一覧
Singular SDKおよびS2S連携で自動的にトラッキングされるビルトインイベントの 完全なリファレンスです。トラッキングトリガーと利用可能な場所の詳細を含みます。
ユーザーレベルイベントリファレンス
ビルトインイベントの種類
__START__
- インストールイベント
イベントの説明
ユニークデバイスのアプリインストールと初回セッションを表し、 プライマリインストールアトリビューションイベントとして機能します。
トラッキングトリガー
自動トラッキング — ユニークデバイス識別子に対してSDK/S2S連携を通じて初回セッションが 送信されたときにトラッキングされます。
重要な制限:
__START__
イベントはBIポストバックにのみ表示されます。このイベントは標準レポートや
パートナーポストバックには表示されません。
技術的詳細
| イベント名 |
__START__
|
| イベント種別 | インストール/初回セッション |
| トラッキング方法 | 自動(SDK/S2S初期化) |
| 設定の要否 | 不要 - 自動トラッキング |
| 利用可能な場所 | BIポストバックのみ |
__SESSION__
- セッションイベント
イベントの説明
すべてのアプリ起動とユーザーセッションをトラッキングし、エンゲージメントと リテンション指標の基盤を提供します。
トラッキングトリガー
自動トラッキング — SDK/S2S連携を通じてセッションが送信されたときにトラッキングされます。 初回セッション(インストール)とその後のすべてのアプリ起動を含みます。
セッションの定義
セッションはアプリがフォアグラウンドに移行したときに開始し、アプリが バックグラウンドに移行してから設定可能なタイムアウト期間(デフォルト: 60秒) が経過すると終了します。
技術的詳細
| イベント名 |
__SESSION__
|
| イベント種別 | セッション/アプリ起動 |
| トラッキング方法 | 自動(SDKセッション管理) |
| 設定の要否 | 不要 - 自動トラッキング |
| 利用可能な場所 | すべてのレポート場所 |
アナリティクスでの活用
セッションイベントは複数の派生指標を生成します:
- 日次アクティブユーザー(DAU): 特定の日にセッションがあるユニークユーザー数
- リテンション率: その後のセッションのために復帰するユーザーの割合
- セッション頻度: 期間ごとのユーザーあたり平均セッション数
- リエンゲージメントアトリビューション: リエンゲージメントキャンペーンからのセッション
__iap__
- SDK収益イベント
イベントの説明
カスタムイベント名なしにSDK収益メソッドを通じて報告されたアプリ内購入と 収益イベントをトラッキングします。
トラッキングトリガー
SDK/S2S連携が 収益メソッド を通じて収益イベントを報告するときにトラッキングされます。ただし、SDK設定で 収益イベントにカスタム名が設定されていない場合に限ります。
カスタム収益イベント名:
収益イベントにカスタム名(例: "purchase"や"subscription")が設定されている場合、
__iap__
ではなくそのカスタム名で表示されます。どちらの方法でも収益を正確にトラッキングします。
__iap__
はカスタム名が指定されていない場合のデフォルト値です。
技術的詳細
| イベント名 |
__iap__
|
| イベント種別 | 収益/アプリ内購入 |
| トラッキング方法 | SDK収益メソッドまたはS2S収益パラメーター |
| 設定の要否 | アプリコードでの収益トラッキング実装が必要 |
| 利用可能な場所 | すべてのレポート場所 |
実装例
iOS SDK:
// Track revenue without custom event name (appears as __iap__)
Singular.revenue(withAmount: 9.99, currency: "USD")
Android SDK:
// Track revenue without custom event name (appears as __iap__)
Singular.revenue("USD", 9.99);
S2S収益:
amt=9.99&cur=USD&is_revenue_event=true
__REVENUE__
- すべての収益イベント
イベントの説明
収益ソースやイベント名に関係なく、何らかの収益が報告されるたびに自動的に トリガーされる集計収益イベントです。
トラッキングトリガー
自動トラッキング — 何らかの方法で収益が報告された場合にトラッキングされます:
-
__iap__イベントがトリガーされたとき(デフォルト収益イベント) - SDKが広告収益化収益イベントを報告するとき
- S2SがカスタムイベントPK(例: "purchase")で収益を報告するとき
- "refund"や"offline_purchase"などその他の収益イベントが報告されるとき
ポストバック設定の注意事項
収益重複のリスク:
__iap__
または他の収益イベントのポストバックをすでに送信している場合、
__REVENUE__
のポストバックを送信しないでください。
__REVENUE__
はすべての収益イベントで発火するため、収益が重複して報告されます。
推奨アプローチ:
特定の収益イベント(
__iap__
、カスタム収益イベント)または
__REVENUE__
のいずれか一方のみポストバックを送信してください。
技術的詳細
| イベント名 |
__REVENUE__
|
| イベント種別 | 集計収益(すべてのソース) |
| トラッキング方法 | 自動(任意の収益イベントによってトリガー) |
| 設定の要否 | 不要 - 収益イベント存在時に自動 |
| 利用可能な場所 | すべてのレポート場所 |
ユースケース
__REVENUE__
を使用する場合:
- パートナープラットフォームへすべての収益タイプの単一ポストバック送信
- イベント別内訳なしの集計収益レポート
- 1つの収益イベントによるシンプルなパートナー設定
特定の収益イベントを使用する場合:
- IAP、サブスクリプション、広告収益を別々にトラッキング
- パートナープラットフォームでのイベント別最適化
- イベント種別による詳細な収益アトリビューション
__UNINSTALL__
- アンインストールイベント
イベントの説明
アプリのアンインストールをトラッキングし、チャーン分析とリエンゲージメント キャンペーンのターゲティングを可能にします。
トラッキングトリガー
自動トラッキング — iOSまたはAndroidアプリでアンインストールトラッキングが有効化され、 少なくとも1件のアンインストールが検出された場合にトラッキングされます。 デバイスのアンインストールが検出されると、再インストールまたはデータ保持 期限に達するまで1日1回イベントがトリガーされます。
前提条件
__UNINSTALL__
イベントが表示されるようにするには、Singularプラットフォームでアンインストール
トラッキングを明示的に有効化する必要があります。
プラットフォーム別設定:
技術的詳細
| イベント名 |
__UNINSTALL__
|
| イベント種別 | アンインストール/チャーン |
| トラッキング方法 | 自動(アンインストールトラッキングの有効化が必要) |
| 設定の要否 | Singularプラットフォームでアンインストールトラッキングを有効化 |
| 発生頻度 | アンインストール済みデバイスごとに1日1回 |
| 利用可能な場所 | すべてのレポート場所(有効化後) |
アンインストール検出方法
iOS: サイレントプッシュ通知による確認
Android: FCM(Firebase Cloud Messaging)による確認
検出タイミング: アンインストールの検出はリアルタイムではありません。プラットフォームの 通知配信に依存し、実際のアンインストールから通常24〜48時間以内に検出されます。
__REINSTALL__
- 再インストールイベント
イベントの説明
以前のアンインストール後のアプリ再インストールをトラッキングし、 ウィンバックキャンペーンの測定とユーザーライフサイクル分析を可能にします。
トラッキングトリガー
自動トラッキング
— SDK/S2Sを通じてアンインストールトラッキングが有効化されている場合に
トラッキングされます。デバイスに対して
__UNINSTALL__
がトラッキングされた後、続いて
__SESSION__
がトリガーされると、
__REINSTALL__
イベントが自動的に発火します。
トリガーシーケンス
-
初回インストール:
ユーザーがアプリをインストール、
__START__と__SESSION__がトラッキングされます -
アプリ使用:
ユーザーがアプリを使用し、複数の
__SESSION__イベントがトラッキングされます -
アンインストール:
ユーザーがアプリをアンインストール、
__UNINSTALL__が検出・トラッキングされます - 再インストール: ユーザーがアプリを再インストールして起動します
-
再インストール検出:
__UNINSTALL__後の最初の__SESSION__が__REINSTALL__イベントをトリガーします
技術的詳細
| イベント名 |
__REINSTALL__
|
| イベント種別 | 再インストール/ウィンバック |
| トラッキング方法 | 自動(アンインストールトラッキングが必要) |
| 設定の要否 | Singularプラットフォームでアンインストールトラッキングを有効化 |
| 前提条件 |
当該デバイスの過去の
__UNINSTALL__
イベント
|
| 利用可能な場所 | すべてのレポート場所 |
アトリビューションに関する考慮事項
再インストール前にユーザーがキャンペーンリンクをクリックしていた場合、 リエンゲージメントキャンペーンにアトリビューションされることがあります。 アトリビューション期間設定は、初回インストールアトリビューションと同様に 再インストールアトリビューションにも適用されます。
ウィンバックキャンペーンの測定:
__REINSTALL__
イベントを使用して、離脱ユーザーを対象としたウィンバックキャンペーンの
効果を測定してください。キャンペーンソース別の再インストール率とその後の
エンゲージメントを比較しましょう。
集計イベントレポート
Singularはビルトインイベントをもとに集計レベルのイベントと指標を自動的に生成し、 キャンペーンパフォーマンスの測定とユーザー行動分析を提供します。
派生指標
セッションベースのイベント
セッションイベントから自動的に計算され、レポートと分析ダッシュボードに表示される 集計指標です。
重要な注意事項: これらの集計イベントはイベントセクションには表示されませんが、標準指標として レポートインターフェース全体に表示されます。
指標の定義
ユニークデバイスの初回セッションをトラッキングし、新規アプリインストールと プライマリアトリビューション指標を表します。
計算方法
レポート期間内に初回
__SESSION__
イベントがあるユニークデバイス識別子の数です。
レポートでの活用
- キャンペーンパフォーマンスの測定
- ソースとチャネル別のインストールアトリビューション
- インストール単価(CPI)の計算
- インストールファネル分析
指標の定義
リエンゲージメントキャンペーンによってトリガーされたセッションをトラッキングし、 既存ユーザーを対象としたキャンペーンの効果を測定します。
設定の依存関係
リエンゲージメントトラッキングは、リエンゲージメントアトリビューション期間と キャンペーンパラメーターを定義するパートナー設定に依存します。
計算方法
ユーザーにとって初回セッションか否かにかかわらず、設定されたアトリビューション 期間内にリエンゲージメントキャンペーンにアトリビューションされたセッション数です。
レポートでの活用
- リエンゲージメントキャンペーンのROI測定
- 休眠ユーザーの活性化率
- クロスチャネルのリエンゲージメントパフォーマンス
- ユーザーライフサイクルステージの移行
指標の定義
特定の日に少なくとも1つのセッションがあるユニークユーザーの日次カウントで、 アクティブユーザーベースの規模を測定します。
計算方法
特定のカレンダー日に少なくとも1つの
__SESSION__
イベントがあるユニークデバイス識別子の数です。
関連指標
- WAU: 週次アクティブユーザー(7日間のユニークユーザー数)
- MAU: 月次アクティブユーザー(30日間のユニークユーザー数)
- DAU/MAU比率: スティッキネス指標(DAUをMAUで割った値)
レポートでの活用
- アプリエンゲージメントのトレンド分析
- ユーザーベースの成長測定
- 季節的な使用パターンの把握
- プラットフォームの健全性モニタリング
指標の定義
アプリをインストール(初回セッション)した後、指定期間内に追加セッションのために 復帰したユーザーの割合です。
計算方法
(インストール後N日目にセッションがあったユーザー数 / Day 0にインストールした 総ユーザー数)× 100
リテンションの種類
| リテンションの種類 | 説明 |
|---|---|
| Day 1リテンション | インストール翌日に復帰するユーザーの割合 |
| Day 7リテンション | インストール7日後に復帰するユーザーの割合 |
| Day 30リテンション | インストール30日後に復帰するユーザーの割合 |
| ローリングリテンション | N日目以降に復帰したユーザー(累計) |
レポートでの活用
- プロダクトマーケットフィットの評価
- オンボーディングの効果測定
- キャンペーン品質の比較(高/低リテンションソース)
- チャーン予測と防止
収益ベースのイベント
集計収益指標
キャンペーンROI測定のため、レポートと分析ダッシュボードに自動的に計算・表示される 収益指標です。
指標の定義
広告収益化を除く、IAP(アプリ内購入)、カスタム収益イベント、サブスクリプション 収益をトラッキングします。
含まれる収益ソース
-
__iap__イベント(デフォルト収益イベント) - カスタム収益イベント(purchase、subscriptionなど)
- サブスクリプションの更新とアップグレード
- 一回限りの購入と消耗品
除外される収益ソース
- 広告収益化収益(Ad Mon Revenueで別途トラッキング)
レポートでの活用
- キャンペーンROIとROASの計算
- ユーザーLTV測定
- マネタイゼーションファネル分析
- ソース別収益アトリビューション
指標の定義
広告収益化イベントから生成された収益のみをトラッキングし、広告収入を 購入収益と分離します。
含まれる収益ソース
- バナー広告インプレッション
- インタースティシャル広告視聴
- リワード動画の完了
- ネイティブ広告エンゲージメント
- オファーウォール完了
実装要件
広告収益化SDKの連携、または適切なイベント種別の指定によるS2S経由の広告収益 報告が必要です。
レポートでの活用
- 広告収益化戦略の最適化
- ハイブリッドマネタイゼーションモデルの分析
- ユーザーセグメントの収益性(IAP vs 広告収益)
- フィルレートとeCPMのパフォーマンス
指標の定義
IAP、サブスクリプション、広告収益を含むすべてのソースからの収益イベントを トラッキングし、完全なマネタイゼーション状況を提供します。
計算方法
総収益 = 収益 + Ad Mon Revenue
含まれる収益ソース
- すべてのIAPおよび購入収益
- サブスクリプション収益
- 広告収益化収益
- カスタム収益イベント(返金、オフライン購入など)
レポートでの活用
- 完全なキャンペーンROI測定
- マネタイゼーション種別を横断したブレンドLTV計算
- 全体的なビジネスパフォーマンスのトラッキング
- クロスチャネルの収益性比較
収益のセグメント化: 収益、Ad Mon Revenue、総収益を組み合わせて使用し、マネタイゼーションミックスを 把握して、さまざまなユーザーセグメントに対する戦略を最適化しましょう。
追加リソース
Singularプラットフォームのイベントトラッキング、設定、レポートに関する完全な ドキュメントです。
イベントドキュメント
- イベントFAQ - 完全なイベントリファレンスとよくある質問
- アプリ内イベントのトラッキング方法 - ステップバイステップのイベント実装ガイド
- Singular標準イベント - 業種別の標準イベントと推奨イベントの全リスト
- エクスポートログとユーザーレベルデータのFAQ - ユーザーレベルイベントデータへのアクセス
- 内部BIポストバック - 内部システムへのイベント転送