イベント説明

一意のデバイスに対するアプリのインストールと最初のセッションを表します。

---

トラッキングトリガー

SDK/S2S統合により、一意のデバイス識別子の最初のセッションが送信されると、自動的にトラッキングされます。

---

技術的な詳細

イベント名	__START__
イベント タイプ	インストール/最初のセッション
トラッキング方法	自動（SDK/S2S初期化）
設定必須	なし - 自動追跡
可用性	BIポストバックのみ

イベントの説明

すべてのアプリの起動とユーザーセッションを追跡し、エンゲージメントとリテンションメトリクスの基礎を提供します。

---

トラッキング・トリガー

SDK/S2S統合によってセッションが送信されると自動的にトラッキングされます。最初のセッション（インストール）と、その後のすべてのアプリ起動を含む。

---

セッション定義

アプリがフォアグラウンドになった時点でセッションが開始され、アプリがバックグラウンドになった時点で設定可能なタイムアウト時間（デフォルト：60秒）の後に終了します。

---

技術的な詳細

イベント名	__SESSION__
イベントタイプ	セッション/アプリ起動
トラッキング方法	自動（SDKセッション管理）
設定が必要	なし - 自動追跡
可用性	すべてのレポートロケーション

---

アナリティクスでの使用

セッション・イベントは複数の派生メトリクスを提供します：

• デイリーアクティブユーザー（DAU）：特定の日にセッションを行ったユニークユーザー
• 継続率：リピーター率：次回以降もセッションを継続するユーザーの割合
• セッション頻度：期間中のユーザーごとの平均セッション数
• リエンゲージメント属性：リエンゲージメントキャンペーンによるセッション

イベントの説明

アプリ内課金や、カスタムイベント名を使用しないSDK収益メソッドで報告された収益イベントをトラッキングします。

---

トラッキングトリガー

SDK/S2S統合が収益メソッドを通して収益イベントを報告した時にトラッキングされます。

---

技術的な詳細

イベント名	__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

イベント説明

収益ソースやイベント名に関係なく、あらゆる種類の収益が報告される度に自動的にトリガーされる収益集計イベント。

---

トラッキングトリガー

何らかの方法で収益が報告された場合に自動的にトラッキングされます：

• __iap__ イベントトリガー（デフォルト収益イベント
• SDKは広告収益イベントを報告する
• S2Sはカスタムイベント名（例えば "購入"）で収益を報告します。
• refund "や "offline_purchase "のような他の収益イベントが報告される

---

ポストバック設定に関する警告

---

技術的な詳細

イベント名	__REVENUE__
イベントタイプ	集計収益（すべてのソース）
トラッキング方法	自動（あらゆる収益イベントによってトリガーされる）
設定が必要	なし - 収益イベントが存在する場合は自動
可用性	すべての報告場所

---

使用例

__REVENUE__ を使用する場合：

• パートナープラットフォームへのすべての収益タイプのシングルポストバック
• イベントごとの内訳なしの収益レポートの集計
• 1つの収益イベントによるパートナー設定の簡素化

特定の収益イベントを使用する場合：

• IAP、サブスクリプション、広告収益の個別トラッキング
• パートナー・プラットフォームにおけるイベント固有の最適化
• イベントタイプ別の詳細な収益アトリビューション

イベントの説明

アプリのアンインストールを追跡し、解約分析とリエンゲージメントキャンペーンのターゲティングを可能にします。

---

トラッキングのトリガー

iOS または Android アプリのアンインストールトラッキングが有効で、少なくとも 1 回のアンインストールが検出された場合に自動的にトラッキングされます。 デバイスのアンインストールが検出されると、再インストールまたはデータ保持の制限まで毎日 1 回イベントがトリガーされます。

---

前提条件

__UNINSTALL__ イベントが表示される前に、Singular プラットフォームでアンインストールトラッキングを明示的に有効にする必要があります。

プラットフォーム固有のセットアップ：

• iOS のアンインストールトラッキングを開始する
• Android のアンインストールトラッキングを開始する

---

技術的な詳細

イベント名	__UNINSTALL__
イベントタイプ	アンインストール/解約
トラッキング方法	自動（アンインストール追跡の有効化が必要）
設定が必要	Singularプラットフォームでアンインストールトラッキングを有効にする
頻度	アンインストールされたデバイスごとに毎日1回
可用性	すべてのレポートロケーション（有効化後）

---

アンインストール検出方法

iOSサイレントプッシュ通知検証

AndroidFCM（Firebaseクラウドメッセージング）検証

イベントの説明

前回のアンインストール後のアプリの再インストールを追跡し、ウィンバックキャンペーンの測定とユーザーライフサイクルの分析を可能にします。

---

トラッキングトリガー

SDK/S2S経由でアンインストールトラッキングが有効な場合、自動的にトラッキングされる。デバイスの__UNINSTALL__ が追跡され、その後__SESSION__ がトリガーされると、__REINSTALL__イベントが自動的に発生します。

---

トリガーシーケンス

1. 初期インストール：ユーザーがアプリをインストール、__START__と__SESSION__ がトラッキングされる。
2. アプリの使用：ユーザーがアプリを使用、複数の__SESSION__イベントがトラッキングされる。
3. アンインストール：ユーザがアプリをアンインストール、__UNINSTALL__を検出、追跡
4. 再インストール：ユーザーがアプリを再インストールして起動
5. 再インストールの検出： __UNINSTALL__ の後の最初の__SESSION__が__REINSTALL__イベントをトリガーする

---

技術的な詳細

イベント名	__REINSTALL__
イベントタイプ	再インストール/ウィンバック
トラッキング方法	自動（アンインストールのトラッキングが必要）
設定が必要	Singularプラットフォームでアンインストールトラッキングを有効にする
前提条件	デバイスの事前の__UNINSTALL__ イベント
可用性	すべてのレポートロケーション

---

属性の考慮事項

ユーザーが再インストール前にキャンペーンリンクをクリックした場合、再インストールはリエンゲージメントキャンペーンに帰属させることができます。アトリビューションウィンドウの設定は、再インストールのアトリビューションにも初回インストールのアトリビューションと同様に適用されます。

メトリクス定義

一意のデバイスの最初のセッションを追跡し、新しいアプリのインストールと主要なアトリビューション指標を表します。

---

計算方法

報告期間中に最初の__SESSION__イベントが発生した一意のデバイス識別子の数。

---

レポートでの使用

• キャンペーンパフォーマンス測定
• ソースおよびチャネル別のインストールアトリビューション
• インストールあたりのコスト（CPI）計算
• インストールファネル分析

指標定義

リエンゲージメントキャンペーンによって引き起こされたセッションをトラッキングし、既存ユーザーをターゲットとしたキャンペーンの効果を測定します。

---

設定の依存性

リエンゲージメント追跡は、リエンゲージメントのアトリビューションウィンドウおよびキャンペーンパラメータを定義するパートナー構成設定に依存します。

---

計算方法

ユーザーの最初のセッションかその後のセッションかに関係なく、設定されたアトリビューションウィンドウ内でリエンゲージメントキャンペーンに起因するセッション。

---

レポートでの使用

• リエンゲージメントキャンペーンのROI測定
• 休眠ユーザーのアクティブ化率
• クロスチャネル・リエンゲージメント・パフォーマンス
• ユーザーライフサイクルのステージ遷移

指標の定義

特定の日に少なくとも1回のセッションを行ったユニークユーザーの日次カウント。

---

計算方法

特定の暦日に少なくとも1つの__SESSION__イベントを持つ一意のデバイス識別子のカウント。

---

関連指標

• WAU：週間アクティブユーザー数（7日間のユニークユーザー数
• MAU：月間アクティブユーザー数（30日間のユニークユーザー数
• DAU/MAU レシオ：スティッキネス指標（DAU÷MAU

---

レポーティングにおける利用状況

• アプリのエンゲージメント傾向分析
• ユーザーベースの成長測定
• 季節的な利用パターンの特定
• プラットフォームの健全性モニタリング

指標の定義

アプリをインストール（最初のセッション）し、指定期間内に追加セッションに戻ったユーザーの割合。

---

計算方法

(インストール後N日目にセッションを行ったユーザー数／0日目にインストールした総ユーザー数）×100

---

リテンションタイプ

リテンションタイプ	リテンションタイプ
初日リテンション	インストール翌日に戻ってきたユーザーの割合
7日目リテンション	インストールから7日後に再訪問したユーザーの割合
30日目リテンション	インストールから30日後に再訪問したユーザーの割合
ローリングリテンション	N日目以降に復帰したユーザー（累積）

---

レポートでの使用

• 製品と市場の適合性評価
• オンボーディングの効果測定
• キャンペーン品質の比較（高リテンションソースと低リテンションソース）
• 解約の予測と防止

メトリクス定義

広告収益化を除く、IAP（アプリ内課金）、カスタム収益イベント、サブスクリプション収益をトラッキングします。

---

含まれる収益ソース

• __iap__ イベント（デフォルト収益イベント）
• カスタム収益イベント（購入、サブスクリプションなど）
• サブスクリプションの更新とアップグレード
• 1回限りの購入と消耗品

---

除外される収益ソース

• 広告収益（Ad Mon Revenueで個別にトラッキングされる

---

レポーティングでの使用

• キャンペーンROIとROASの計算
• ユーザー生涯価値（LTV）の測定
• 収益化ファネル分析
• ソース別収益アトリビューション

メトリック定義

広告収益化イベントから発生した収益のみをトラッキングし、広告収入と購入収入を分離します。

---

含まれる収益ソース

• バナー広告インプレッション
• インタースティシャル広告のビュー
• リワード動画の視聴完了
• ネイティブ広告のエンゲージメント
• オファーウォールの完了

---

実装要件

広告収益化SDKの統合、または適切なイベントタイプを指定したS2S経由の広告収益レポートが必要です。

---

レポーティングでの使用

• 広告収益化戦略の最適化
• ハイブリッド収益化モデル分析
• ユーザーセグメントの収益性（IAP対広告収益）
• フィルレートとeCPMパフォーマンス

指標の定義

すべてのソースからのすべての収益イベントを追跡し、IAP、サブスクリプション、広告収益を含む収益化の全体像を提供します。

---

計算方法

総収入 = 収入 + 広告収入

---

含まれる収益ソース

• すべてのIAPおよび購入収入
• サブスクリプション収益
• 広告収益
• カスタム収益イベント（払い戻し、オフライン購入など）

---

レポートでの使用

• 完全なキャンペーンROI測定
• マネタイズの種類を超えたブレンドLTV計算
• 全体的なビジネスパフォーマンスのトラッキング
• クロスチャネル収益性比較