標準イベントのメリット

Singularは様々な業種で一般的に使用されている標準イベントをサポートしており、レポーティングや最適化のために広告ネットワークでよくサポートされています。

メリット

• 自動認識：Singularは標準イベントを自動的に認識し、手動で定義することなくイベントリストに追加します。
• パートナーサポート：広告ネットワークはキャンペーンの最適化とレポート作成のために標準イベントをサポートします。
• 業界の整合性：プラットフォームやパートナー間で一貫したネーミング
• ベストプラクティスイベントが標準的な定義と一致する場合に推奨されるアプローチ

---

標準イベント属性

各標準イベントに対して、完全なデータキャプチャとパートナー互換性のための推奨標準属性を渡す。

例: sng_content_view イベント(ユーザが商品を閲覧)は以下を含むべきである：

• sng_attr_content_type - 閲覧したコンテンツのタイプ
• sng_attr_content_id - 一意のコンテンツ識別子
• sng_attr_content - コンテンツの説明または名前

---

イベント戦略リソース

UA/マーケティング/ビジネスチームは、以下のリソースを使用して、マーケティングKPIに基づいてイベントリストをコンパイルする必要があります：

• アプリ内イベントのトラッキング方法- イベントプランニングと実施ガイド
• Singularな標準イベント：全リストと業種別推奨イベント- 完全な標準イベントリファレンス

---

プラットフォーム固有のイベント名

カスタムイベントの定義

イベントがSingularの標準イベントと一致しない場合、特定のトラッキング要件のためにカスタム名でカスタムイベントを定義します。

カスタムイベントのガイドライン

• 文字数制限：最大32文字
• 言語Singularからイベントを受け取る広告ネットワークパートナーとの互換性のため、英語名を推奨します。
• 命名規則：明瞭性と保守性のため、説明的で一貫性のある命名を使用する。
• 文書化：カスタムイベント名と目的を文書化したイベントカタログの維持管理

---

イベントトラッキングの範囲

イベントの選択基準

• マーケティングの関連性：イベントがキャンペーン最適化のための洞察を提供する
• KPI測定：重要なパフォーマンス指標に貢献するイベント
• ユーザー価値：イベントはユーザーのエンゲージメントまたは収益化を示す
• パートナーの最適化：広告ネットワークがキャンペーンのターゲティングに使用するイベント

登録手順

1. アプリに移動：Singularプラットフォームで、設定 → アプリに移動し、新しいアプリを追加をクリックします。
2. アプリ名を入力開発アプリのアプリ名を入力（わかりやすいようにバンドルIDを使用することをお勧めします
3. プラットフォームを選択します：アプリのプラットフォームに対応するOSを選択（iOSまたはAndroid
4. Configure Bundle ID:Bundle IDオプションを選択し、Bundle Identifierの開発バージョンを入力し、アプリを保存します。
5. iOSのみ - 詳細設定：アプリを保存した後、アプリ名の横にある矢印をクリックして詳細を表示します。
   • 詳細設定を表示するオプションを切り替える
   • チームIDの追加（ユニバーサルリンクに必要）
   • Add Scheme（ディープリンクに必要）

---

開発後のアップデート

開発とテストが終了したら

1. バンドルIDの更新：アプリの設定でバンドルIDを本番バージョンに変更する
2. 本番アプリのセットアップ：マーケティングチームが、アプリ構成FAQの指示に従って本番アプリを追加します。

リアルタイム検証ツール

即座にフィードバックを提供するリアルタイム検証ツールを使用して、実装された機能をテストします。

テストコンソール

テスティングコンソールを使用して、実装されたさまざまな SDK 機能をリアルタイムで手動でテストします。

テスティングコンソールの利点

• リアルタイムのフィードバック：SDKコールとデータ伝送の即時検証
• 機能ごと：開発中に個々の機能を段階的にテスト
• デバッグサポート：設定の問題やデータの問題を即座に特定
• セッション追跡：セッションの初期化とイベントトラッキングの検証

---

サードパーティデバッグツール

トラフィックの検査と検証にプロキシツールを使用する代替テストアプローチ。

Charles Proxyのセットアップ：

• Charles Proxyまたは同様のネットワーク検査ツールをインストールする。
• HTTPS トラフィックを検査するために SSL プロキシを有効にする。
• Singular データが正しいパラメータで正しい時間にトリガーされたことを検証する。
• API エンドポイントの呼び出しとレスポンスコードの検証

包括的な検証ツール

実装完了後、自動および手動ツールを使用して完全な統合検証を行います。

SDK監査レポート

SDK監査レポートを実行して、統合の問題を自動的に特定し、推奨されるソリューションを受け取ります。

監査レポートの特徴

• 自動検出：SDK 機能の欠落または設定ミスを特定します。
• ベストプラクティスの検証：Singularの推奨事項に照らして実装を検証
• 実行可能な推奨事項：特定された問題に対する具体的なソリューションを提供
• 包括的なカバレッジ：すべてのSDK機能と構成をチェック

---

ログのエクスポート検証

Export Logsページを使用してユーザーレベルのデータをダウンロードし、アプリからSingularに正常に送信されたすべてのデータを確認します。

ログのエクスポート詳細

• データ形式：完全なユーザーレベルデータのCSVファイル
• タイミングデータが利用可能になる約30分前
• 検証イベント、セッション、属性データの検証
• デバッグ：欠落しているイベントや不正確なデータを特定

---

ディープリンクのテスト

Singular SDK統合のテスト方法」の指示に従ってディープリンクをテストします。

ディープリンクのテストケース：

• ユニバーサルリンク：iOS ユニバーサル・リンクおよび Android アプリ・リンクのテスト
• カスタムスキーム：カスタムURLスキームの処理の検証
• ディファードディープリンク：アプリのインストール前にクリックされたリンクのテスト
• キャンペーンパラメータ：パラメータの受け渡しとアトリビューションの検証

---

アトリビューションの検証

Attribution Details APIを使用して、テスト後にデバイスのアトリビューション詳細をクエリします。アトリビューションデータは、イベントの約4～6分後に入手できます。

Attribution Details Endpoint を使用してアトリビューションを検証する方法をご覧ください。

アトリビューション検証のステップ

1. テストの実行:アプリをインストールし、テストユーザージャーニーを完了します。
2. 処理を待ちます：アトリビューション処理に4～6分かかる
3. API をクエリします：デバイス識別子を使用してアトリビューションの詳細APIを使用する
4. 結果を確認する：正しいキャンペーンとソースへのアトリビューションを確認する