以下はSingular SDKの統合に 必要な事前ステップです。
SDK統合の計画、開発用アプリの登録、トラッキングリンク用ドメインの作成、開発中および開発後の統合テストの計画方法について説明します。
| ガイド | ビジネス/マーケティングチーム |
| 1 |
SDK統合の計画Singular SDKの統合を開始する前に、マーケティング/ビジネスチームは以下の質問にお答えください。これにより、開発チームはどのSDKの特徴と機能を有効にすべきかを知ることができます。 このアプリは子供向けですか？お子様向けのアプリは、お子様のプライバシーを保護するためにPlay StoreとApp Storeのポリシーに準拠する必要があります。SingularのKids Apps SDKを使用することをお勧めします。このSDKはデバイス識別子を取得しないため、これらのポリシーに準拠するのに役立ちます。 アプリはディープリンクを扱えますか？Singular Links Prerequisitesの説明に従い、ディープリンクハンドラを実装してください。 アプリはユーザーイベントを追跡しますか？Singularはアプリ内イベントのデータを収集し、キャンペーンのパフォーマンス分析やKPIの測定に役立てることができます。例えば、ゲームアプリでユーザーのログイン、登録、チュートリアルの完了、レベルアップなどのデータを収集したい場合があります。 標準イベント Singularは様々な 標準イベントをサポートしています。これらのよく使われるイベントは、レポートや最適化のために広告ネットワークでよくサポートされています。もう一つの利点は、標準的なイベント名を使用すると、Singularが自動的に認識し、手動で定義しなくてもイベントリストに追加されることです。可能な限り標準イベントを使用することをお勧めします。 各標準イベントには、標準の推奨属性を渡します。例えば、sng_content_viewイベント（顧客が商品を見た）の場合、sng_attr_content_type、sng_attr_content_id、sng_attr_content の属性を渡します。 Singularに送信されるイベントのリスト（付随する属性付き）は、マーケティングKPIに基づいてUA/マーケティング/ビジネスチームが作成する必要があります。イベント戦略の構築には、以下のガイドが参考になります： 重要： お客様のアプリにSingular SDKを統合する場合、開発プラットフォームによってイベント名や属性名が若干異なる（全角、下線なしなど）場合があります。iOS、 Android、 Unity、 React、 Flutterの イベント名と属性名のリストをご覧ください。 カスタムイベント Singularの標準イベントにはないイベントを測定したい場合は、カスタム名で独自のカスタムイベントを定義できます。 開発チームは任意のカスタム名（最大32文字）を使用できます。最適化のためにSingularからイベントを受け取る可能性のある広告ネットワークパートナーとの互換性のために、英語の名前を使用することをお勧めします。 ヒント： イベントをSingularに送信するのは、マーケティング関連の目的で追跡する必要がある場合のみにしてください。イベントがキャンペーンパフォーマンスやユーザー価値のKPIとして重要でない場合、そのイベントはSingularにトラッキングされるべきではありません。 (iOS） アプリはSKAdNetworkを実装しますか？SDKのメソッドを使用して、マネージドモード（コンバージョン値がSingularによって更新される）またはマニュアルモード（コンバージョン値を自分で更新する）でSKANを有効にすることができます。 (iOS）アプリはトラッキング情報（ATT）を共有する許可をユーザーに求めますか？ATTプロンプトを表示することをお勧めします。なぜなら、ユーザーがデバイスIDを共有することをオプトインした場合、インストールが正しく行われるからです。 ATTプロンプトを表示する場合は、ユーザーが応答するまでアプリのSingularの初期化を遅らせるようにSDKを設定する必要があります。 |
| 2 |
開発/テストアプリの登録アプリバンドル識別子同じSDKキーとシークレットキーを本番アプリとテストアプリで使用します。テスト用/本番用のデータをSingularに保存すると、削除できません。 このことを念頭に置いて、テストアプリには異なるバンドル識別子を使用して、最終的な本番アプリとデータを分けておくことをお勧めします。 例えば、本番アプリがバンドル IDcom.myapp を使っている場合、開発段階ではcom.myapp.dev を使うことができます。その後、アプリストアでアプリをリリースする前に、バンドルIDを本番バージョンに戻すことができます。 アプリを登録する手順
アプリの開発とテストが完了したら、バンドルIDを本番バージョンに更新し、アプリ構成FAQの指示に従ってマーケティングチームに本番アプリを追加させます。 |
| 3 |
リンクドメインの作成（まだお持ちでない場合）シングラーリンク（シングラートラッキングリンク）は次のような構造になっており、[SUBDOMAIN]はお客様が選択します： 例えば、Jewel Rushというアプリを販売するキャンペーンの場合、"jewelrush.sng.link "というドメインを作成します。そして、このドメインを使用して、次のような構造のトラッキングリンクを作成することができます： 1つのドメインをすべてのリンクに使用することもできますし、複数のドメインを作成して目的別に使用することもできます。いずれにしても、Singular Tracking Linksを使用する前に、少なくとも1つのドメインが必要です。 リンクのドメインはマーケティングキャンペーンで公開されるため、組織のマーケティングチームが決定に関与する必要があります。 iOSアプリにSingular SDKを統合する場合、XcodeのAssociated Domain Settingsにリンクドメインを追加する必要があります： こちらもご覧ください：Singular Links 前提条件 |
| 4 |
統合のテスト方法を学ぶSingular SDK/S2Sをアプリに統合する場合、アプリの新バージョンを公開する前に正しく動作することを確認することが重要です。 Singularは統合をテストするためのツールを提供しています： 実装中のテスト：
実装後のテスト：
テストのヒントについては、Singular SDKインテグレーションをテストする方法をご覧ください。 |