特異なSDKの統合:計画と前提条件

以下は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_typesng_attr_content_idsng_attr_content の属性を渡します。

Singularに送信されるイベントのリスト(付随する属性付き)は、マーケティングKPIに基づいてUA/マーケティング/ビジネスチームが作成する必要があります。イベント戦略の構築には、以下のガイドが参考になります:

重要: Singular SDKをアプリに統合する場合、開発チームは開発プラットフォームに応じてイベント名や属性名を若干変えて使用する必要があります(全角、下線なしなど)。iOSAndroidUnityReactFlutterの イベント名と属性名のリストをご覧ください。

カスタムイベント

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を本番バージョンに戻すことができます。

アプリを登録する手順

  1. Singularプラットフォームで、設定 > アプリと進み、新しいアプリを追加をクリックします。
  2. 開発アプリのアプリ名を入力します。バンドルIDを使用することをお勧めします。
  3. アプリのプラットフォームに対応するOSを選択します。
  4. バンドルIDオプションを使用してアプリを識別し、バンドルIDの開発バージョンを入力します。 アプリを保存します。
  5. iOSアプリの場合: アプリを保存した後、アプリ名の横にある矢印をクリックしてアプリの詳細を表示し、[詳細設定を表示]オプションを切り替えます。TeamIDと Schemeを追加します。 これはユニバーサルリンクとディープリンクに必要です。

アプリの開発とテストが完了したら、バンドルIDを本番バージョンに更新し、アプリ構成FAQの指示に従ってマーケティングチームに本番アプリを追加させます。

3

リンクドメインの作成(まだお持ちでない場合)

シングラーリンク(シングラートラッキングリンク)は次のような構造になっており、[SUBDOMAIN]はお客様が選択します:

https://[SUBDOMAIN].sng.link/[PARAMETERS]

例えば、Jewel Rushというアプリを販売するキャンペーンの場合、"jewelrush.sng.link "というドメインを作成します。そして、このドメインを使用して、次のような構造のトラッキングリンクを作成することができます:

https://jewelrush.sng.link/[PARAMETERS]

1つのドメインをすべてのリンクに使用することもできますし、複数のドメインを作成して目的別に使用することもできます。いずれにしても、Singular Tracking Linksを使用する前に、少なくとも1つのドメインが必要です。

リンクのドメインはマーケティングキャンペーンで公開されるため、組織のマーケティングチームが決定に関与する必要があります。

iOSアプリにSingular SDKを統合する場合、Xcodeの関連ドメイン設定にリンクドメインを追加する必要があります:

applinks:[DOMAIN].sng.link

参照:Singular Links Prerequisites.

4

統合のテスト方法を学ぶ

Singular SDK/S2Sをアプリに統合する場合、アプリの新バージョンを公開する前に正しく動作することを確認することが重要です。

Singularは統合をテストするためのツールを提供しています:

実装中のテスト

  • 実装中のテスト:実装するさまざまな機能をリアルタイムで実装しながら手動でテストできるテスティングコンソールを使用しましょう。
  • または、SSLプロキシを有効にしたCharles Proxyなどのサードパーティツールを使用して、Singularのデータが正しいデータポイントで正しい時間にトリガーされることを検証します。

実装後のテスト

  • SDKauditレポートを実行して、統合における問題を自動的に特定し、試行錯誤を重ねたソリューションを推奨します。
  • Export Logsページを使用してユーザーレベルのデータをダウンロードしますCSVファイルには、アプリからSingularに正常に送信されたすべてのデータが表示されます。このツールでデータが利用できるようになるまで約30分かかります。
  • Singular SDKインテグレーションをテストする方法」の指示に従って、ディープリンクをテストしてください。
  • Attribution Details APIを使用して、テスト後にデバイスの詳細を照会します。アトリビューションデータが利用可能になるまで、約4~6分かかります。詳細はこちら。

テストのヒントについては、Singular SDKインテグレーションをテストする方法をご覧ください。