SDK連携の前提条件
Singular SDK連携前に必要な必須の準備手順で、計画立案、アプリ登録、ドメイン設定、テスト準備を網羅しています。
必須の準備手順： 以下の手順は、すべてのSingular SDK連携に必要です。
SDK連携の計画立案、開発用アプリの登録、トラッキングリンク用ドメインの作成、実装中および実装後のテストワークフローの準備方法をご確認ください。
| 対象者 | ビジネスチーム、マーケティングチーム、開発チーム |
| 前提条件 | Singularアカウントへのアクセス、アプリのBundle ID、マーケティングKPIの定義 |
連携の概要
部門横断的な連携
Singular SDKの連携を成功させるには、マーケティング・ビジネス・開発チームが協力して要件を定義し、トラッキングを設定し、実装を検証する必要があります。
チームの役割：
| チーム | 役割 |
|---|---|
| マーケティング/ビジネス |
|
| 開発 |
|
ステップ1：SDK連携の計画
SDK連携を開始する前に、マーケティングおよびビジネスチームは、開発チームが適切なSDK機能を実装できるよう、主要な質問に回答する必要があります。
子どものプライバシー規制への準拠
子ども向けアプリ
質問： このアプリは明示的に子どもを対象としていますか？
子どもを対象としたアプリは、子どものプライバシーを保護するPlay StoreとApp Storeのポリシーを遵守する必要があります。Singularはコンプライアンスのための専門SDKを提供しています。
推奨ソリューション： デバイス識別子を収集しないことでプライバシーポリシーへの準拠を支援するSingular Kids Apps SDKをご使用ください。
ディープリンクの設定
ディープリンクの処理
質問： アプリはディープリンクを処理しますか？
ディープリンクにより、マーケティングキャンペーン、プッシュ通知、ウェブページなどの外部ソースからアプリ内の特定コンテンツにユーザーを誘導できます。
実装要件：
- 前提条件： ドメインとプラットフォームの設定についてSingular Links前提条件に従ってください。
- ディープリンクハンドラー： 関連するSDKガイド（iOS、Android、React Nativeなど）の説明に従って、コードにハンドラーを実装してください。
- テスト： Testing Consoleと手動テスト手順を使用して、ディープリンク機能を検証してください。
イベントトラッキング戦略
アプリ内イベント計画
質問： アプリはユーザーイベントをトラッキングしますか？
Singularはキャンペーンパフォーマンスを分析しKPIを測定するためにアプリ内イベントデータを収集します。イベント戦略はマーケティング目標とユーザー価値の測定に合致させる必要があります。
標準イベントのメリット
Singularは、様々な業種で一般的に使用され、レポートと最適化のために広告ネットワークでもサポートされている多様な標準イベントをサポートしています。
メリット：
- 自動認識： Singularは標準イベントを自動的に認識し、手動定義なしにイベントリストに追加します。
- パートナーサポート： 広告ネットワークはキャンペーン最適化とレポートのために標準イベントをサポートします。
- 業界標準： プラットフォームとパートナー間で一貫した命名規則
- ベストプラクティス： イベントが標準定義に合致する場合に推奨されるアプローチ
標準イベントの属性
各標準イベントについて、完全なデータ収集とパートナー互換性のために推奨される標準属性を渡してください。
例： sng_content_view イベント（ユーザーが商品を閲覧）には以下を含める必要があります：
-
sng_attr_content_type- 閲覧したコンテンツの種類 -
sng_attr_content_id- 固有のコンテンツ識別子 -
sng_attr_content- コンテンツの説明または名前
イベント戦略リソース
UA/マーケティング/ビジネスチームは、以下のリソースを使用してマーケティングKPIに基づくイベントリストを作成してください：
- アプリ内イベントのトラッキング方法 - イベント計画と実装ガイド
- Singular標準イベント：全リストと業種別推奨イベント - 完全な標準イベントリファレンス
プラットフォーム別イベント名
開発者向け注意： SDK連携では、開発プラットフォームによって若干異なるイベント/属性名の形式（全て大文字、アンダースコアなしなど）が必要になる場合があります。
プラットフォーム別リスト：
カスタムイベントの定義
イベントがSingularの標準イベントと一致しない場合、特定のトラッキング要件に応じてカスタム名でカスタムイベントを定義してください。
カスタムイベントガイドライン：
- 文字数制限： 最大32文字
- 言語： Singularからイベントを受け取る広告ネットワークパートナーとの互換性のために英語名を推奨します。
- 命名規則： 明確性と保守性のために説明的で一貫した命名を使用してください。
- ドキュメント化： カスタムイベント名と目的を記録したイベントカタログを維持してください。
イベントトラッキングの範囲
ベストプラクティス： マーケティング関連の目的に必要な場合にのみSingularにイベントを送信してください。イベントがキャンペーンパフォーマンスKPIやユーザー価値指標として重要でない場合、そのイベントはSingularでトラッキングすべきではありません。
イベント選定基準：
- マーケティング関連性： イベントがキャンペーン最適化のためのインサイトを提供します。
- KPI測定： イベントが主要業績評価指標に貢献します。
- ユーザー価値： イベントがユーザーエンゲージメントや収益化を示します。
- パートナー最適化： イベントがキャンペーンターゲティングのために広告ネットワークで使用されます。
iOS固有の設定
SKAdNetworkの実装
質問（iOS）： アプリはSKAdNetworkを実装しますか？
SKAdNetworkは、ユーザーレベルのトラッキング許可なしにiOSでプライバシーを保護したアトリビューションを可能にします。Singularは2つの実装モードをサポートします。
SKAdNetworkモード：
- マネージドモード： Singularが事前定義されたルールに基づいてコンバージョン値を自動的に更新します。
- マニュアルモード： アプリがSDKメソッドを使用して直接コンバージョン値を更新します。
App Tracking Transparency（ATT）
質問（iOS）： アプリはトラッキング情報の共有についてユーザーの許可を求めますか（ATT）？
SingularはユーザーがオプトインするとデバイスID（IDFA）の共有が可能となりインストールアトリビューションの精度が向上するため、ATTプロンプトの表示を推奨しています。
設定要件： ATTプロンプトを表示する場合、ユーザーがプロンプトに応答するまでSingularの初期化を遅延させるようSDKを設定してください。これにより、アトリビューションが正確なトラッキング認証状態を取得します。
ATTの実装：
- プロンプトのタイミング： Singular SDKを初期化する前にATTプロンプトを表示してください。
- SDK設定： ATTの応答を待つためにSDK設定オプションを使用してください。
- IDFAの取得： ユーザーが許可を付与した場合、決定論的アトリビューションのためにIDFAが収集されます。
- 代替アトリビューション： ユーザーが許可を拒否した場合、アトリビューションはフィンガープリンティングとIDFVを使用します。
ステップ2：開発アプリの登録
テスト中のデータ分離を維持するため、本番アプリとは別のBundle IDを使用してSingularプラットフォームに開発/テストアプリを登録してください。
Bundle ID戦略
開発 vs 本番
本番アプリとテストアプリの両方に同じSDK KeyとSecret Keyを使用します。Singularに保存されたデータは削除できません。
推奨アプローチ： テストアプリには異なるBundle Identifierを使用して、本番アプリとデータを分離してください。アプリをストアにリリースする前にBundle IDを本番バージョンに変更してください。
Bundle IDの例：
| 環境 | Bundle ID |
|---|---|
| 本番 | com.myapp |
| 開発/テスト | com.myapp.dev |
アプリ登録手順
プラットフォームの設定
登録手順
- アプリに移動： Singularプラットフォームで、Settings → Appsに移動し、Add New Appをクリックします。
- アプリ名の入力： 開発アプリのアプリ名を入力します（明確性のためBundle IDの使用を推奨）。
- プラットフォームの選択： アプリプラットフォームに対応するOS（iOSまたはAndroid）を選択します。
- Bundle IDの設定： Bundle IDオプションを選択し、Bundle Identifierの開発バージョンを入力してからアプリを保存します。
-
iOSのみ - 詳細設定： アプリを保存した後、アプリ名の横の矢印をクリックして詳細を表示します。
- Show Advanced Settingsオプションを切り替えます。
- Team IDを追加します（Universal Linksに必要）。
- Schemeを追加します（ディープリンクに必要）。
開発後の更新
開発とテストを完了した後：
- Bundle IDの更新： アプリ設定でBundle IDを本番バージョンに変更します。
- 本番アプリの設定： マーケティングチームがApp Configuration FAQの指示に従って本番アプリを追加します。
重要： App StoreまたはPlay Storeにアプリをリリースする前に、Bundle IDが本番の値に更新されていることを確認してください。Bundle IDが一致しない場合、適切なアトリビューションとトラッキングができなくなります。
ステップ3：リンクドメインの作成
ブランドキャンペーンURLとディープリンク機能を実現するSingularトラッキングリンク用のカスタムドメインを構築してください。
リンクドメインの構造
Singularリンクの形式
Singular Links（Singularトラッキングリンク）はカスタムサブドメインを使用した標準化された構造に従います：
https://[SUBDOMAIN].sng.link/[PARAMETERS]例：「Jewel Rush」というアプリの場合、jewelrush.sng.linkドメインを作成することで、以下の構造のトラッキングリンクが使用できます：
https://jewelrush.sng.link/[PARAMETERS]ドメイン戦略
単一ドメイン vs 複数ドメイン
組織はすべてのリンクに単一ドメインを使用するか、異なる目的（アプリ、ブランド、キャンペーンなど）に応じて複数のドメインを作成することができます。
要件： Singularトラッキングリンクを使用する前に、少なくとも1つのドメインが必要です。マーケティングキャンペーンやユーザー向け資料に表示されるため、マーケティングチームはドメイン選択に参加する必要があります。
ドメインの使用例：
- 単一ドメイン： アプリとキャンペーン全体のすべてのトラッキングリンクに1つのドメインを使用
- アプリ別： ブランドの明確性のためにアプリごとに別々のドメイン
- キャンペーン別： 異なるキャンペーンタイプに対して異なるドメイン
- 地域別： ローカライズされたキャンペーン用の地域ドメイン
iOSドメインの設定
Associated Domainsの設定
iOSアプリにSingular SDKを連携する際は、Universal LinksをサポートするためにXcodeのAssociated Domain Settingsにリンクドメインを追加してください。
Associated Domainの形式：
applinks:[DOMAIN].sng.link例：
applinks:jewelrush.sng.link追加リソース： ドメイン設定と構成の完全な手順については、Singular Links前提条件をご参照ください。
ステップ4：連携テストの計画
Singularのテストツールと検証手順を使用して、アプリをリリースする前にSDK/S2S連携の機能を検証してください。
テスト戦略
テストフェーズ
包括的なテストは2つのフェーズで行われます：リアルタイム検証のための実装中と完全な連携検証のための実装後。
リアルタイム検証ツール
即時フィードバックを提供するリアルタイム検証ツールを使用して、実装された機能をテストしてください。
Testing Console
Testing Consoleを使用して、実装中にさまざまなSDK機能をリアルタイムで手動テストしてください。
Testing Consoleのメリット：
- リアルタイムフィードバック： SDKコールとデータ送信の即時検証
- 機能別： 開発中に個別機能を段階的にテスト
- デバッグサポート： 設定の問題やデータの問題を即時特定
- セッショントラッキング： セッションの初期化とイベントトラッキングを確認
サードパーティのデバッグツール
トラフィックの検査と検証のためにプロキシツールを使用した代替テスト手法。
Charles Proxyの設定：
- Charles Proxyまたは同様のネットワーク検査ツールをインストールしてください。
- HTTPSトラフィック検査のためにSSLプロキシを有効にしてください。
- 正しいタイミングで正しいパラメーターでSingularデータがトリガーされることを確認してください。
- APIエンドポイントのコールとレスポンスコードを検証してください。
包括的な検証ツール
実装を完了した後、完全な連携検証のために自動化および手動ツールを使用してください。
SDK監査レポート
SDK監査レポートを実行して、連携の問題を自動的に特定し、推奨ソリューションを受け取ってください。
監査レポートの機能：
- 自動検出： 欠落または誤設定されたSDK機能を特定します。
- ベストプラクティス検証： Singularの推奨事項に対して実装を検証します。
- 実用的な推奨事項： 特定された問題に対する具体的なソリューションを提供します。
- 包括的なカバレッジ： すべてのSDK機能と設定を確認します。
Export Logsの検証
Export Logsページを使用してユーザーレベルデータをダウンロードし、アプリからSingularに正常に送信されたすべてのデータを確認してください。
Export Logsの詳細：
- データ形式： 完全なユーザーレベルデータを含むCSVファイル
- タイミング： データが利用可能になるまで約30分
- 検証： イベント、セッション、アトリビューションデータを確認してください。
- デバッグ： 欠落したイベントや不正なデータを特定してください。
ディープリンクのテスト
「Singular SDK連携のテスト方法」の指示に従ってディープリンクをテストしてください。
ディープリンクのテストケース：
- Universal Links： iOS Universal LinksとAndroid App Linksのテスト
- カスタムスキーム： カスタムURLスキームの処理を確認
- ディファードディープリンク： アプリインストール前にクリックされたリンクのテスト
- キャンペーンパラメーター： パラメーターの受け渡しとアトリビューションの検証
アトリビューションの検証
テスト後、Attribution Details APIを使用してデバイスのアトリビューション詳細をクエリしてください。アトリビューションデータはイベントから約4〜6分後に利用可能になります。
Attribution Details Endpointを使用したアトリビューション検証方法を確認してください。
アトリビューション検証手順：
- テストの実行： アプリをインストールしてテストユーザーのジャーニーを完了してください。
- 処理の待機： アトリビューション処理のために4〜6分待機してください。
- APIのクエリ： デバイス識別子でAttribution Details APIを使用してください。
- 結果の確認： 正しいキャンペーンとソースへのアトリビューションを確認してください。
テストに関する追加リソース
完全なテストガイド
包括的なテスト手順、ベストプラクティス、トラブルシューティングについては、Singular SDK連携のテスト方法をご参照ください。
テストチェックリスト：
- Testing ConsoleでリアルタイムのSDKコールを検証する。
- SDK監査レポートで完全な連携を確認する。
- Export Logsでデータ送信を確認する。
- ディープリンクがすべてのシナリオで正しく機能する。
- アトリビューションが予想されるキャンペーンソースと一致する。
- イベントが正しい名前と属性でトラッキングされる。
- 収益イベントが金額と通貨を取得する。
次のステップ
前提条件を完了した後、プラットフォーム固有のSDK連携またはS2S実装に進んでください。
SDK連携ガイド
追加リソース
- App Configuration FAQ - 本番アプリの設定と構成
- Singular Links前提条件 - リンクドメインとディープリンクの設定
- 標準イベントリファレンス - 完全な標準イベントと属性リスト
- SDK連携のテスト - 完全なテスト手順と検証