テストデバイスの広告 ID をリセットする

モバイルデバイスを以前に Singular のアトリビューションテストで使用したことがある場合、または Singular Device Assist アプリがインストールされている場合は、再度テストする前にデバイスのデータを消去する必要があります。Singular Device Assist アプリを初めて使用する場合は、このステップを省略できます。

デバイスデータを消去する手順：

1. デバイスから Singular Device Assist アプリをアンインストール／削除します。

2. デバイスの広告識別子をリセットします： 

   • Apple デバイスの場合：
     • 次を開きます： 設定 > プライバシーとセキュリティ
     • 次を選択します： トラッキング、そして Appからのトラッキング要求を許可 をオフにしてから、再度オンにします。 
   • Android デバイスの場合：
     • 次を開きます： 設定 > Google > 広告
     • 次を選択します： 広告 ID をリセット

新しい広告 ID を確認する

デバイスの広告 ID をリセットしたら、新しい ID を確認する必要があります。Singular の Device Assist テストアプリ（iOS、Android）などのサードパーティ製アプリを使用するか、デバイスの設定から直接確認できます：

Apple デバイスの場合：

• 最近の iOS バージョンでは、広告 ID（IDFA）はサードパーティ製アプリを通じてのみ確認できます。
• 以前の iOS バージョンでは、設定 > プライバシー > 広告 に移動して IDFA を確認できます。

Android デバイスの場合：

• 次に移動します： 設定 > Google > 広告 — ここで AAID / AIFA（Android 広告 ID、GAID（Google 広告 ID）とも呼ばれます）を確認できます。

Singular リンクを使用する（Singular から提供）

Singular チームから、以下の例に近いトラッキングリンクを受け取っているはずです。

トラッキングリンクの主なポイント：

• リンクには「aifa」「idfa」「cl」「pcid」などのパラメータが含まれます。
• {波かっこ} 内の値は マクロ です。広告配信時にメディアパートナーが実際の値に置き換えるプレースホルダーです。

重要なリマインダー：

値が入らないマクロは、トラッキングリンクから必ず削除してください。

• 実際の値の代わりにマクロがそのまま送信された場合、Singular はクリックを記録せず、アトリビューションは行われません。 

https://singularassist.sng.link/D59c0/tpa9?aifa={google_advertising_id}
&idfa={idfa}&cl={click_id}&pcid={campaign_id}&pcn={campaign_name}
&pshid={publisher_id}&psn={publisher_site_name}&psid={publisher_site_id}
&pcrid={creative_id}&pcrn={publisher_creative_name}

アトリビューションのテスト方法：トラッキングリンクの準備

確定的（Deterministic）：リンクに広告 ID を挿入する

1. 広告 ID のプレースホルダーを置き換えます：
   
   • Apple デバイスの場合：IDFA マクロ（例：{idfa}）をデバイスの実際の IDFA に置き換えます。 
   • Android デバイスの場合：Android 広告 ID（例：{google_advertising_id}）をデバイスの実際の AIFA に置き換えます。
2. その他のプレースホルダーを削除または置き換えます：
   • ポストバック URL に必須の場合を除き、使用しないプレースホルダーはすべて削除します。
   • たとえば、プラットフォームで Click ID または Transaction ID が必要な場合は、該当するパラメータ（例：cl）を有効な値に置き換えます。
3. 完成したリンクの例（Android の場合）： 

https://singularassist.sng.link/D59c0/tpa9?aifa=0f9f9e46-df3b-
4012-8b1e-639ebc39a20f&idfa=&cl=123&pcid=&pcn=&pshid=&psn=&psid=
&pcrid=&pcrn=

確率的（Probabilistic）：広告 ID が利用できないチャネルの場合

1. デバイスのアトリビューションをリセットします：
   • 次の手順に従って デバイスのリセットとインストールアトリビューションの消去 を実施し、デバイスが正しくリセットされていることを確認します。
2. トラッキングリンクを修正します：
   • トラッキングリンクを再度コピーし、デバイス ID を含むすべてのマクロの値を削除します。以下の例のように、すべてのマクロを空にしてください：

   • https://singularassist.sng.link/D59c0/tpa9?_smtype=3&aifa=
     &idfa=&cl=&pcid=&pcn=&pshid=&psn=&psid=&pcrid=&pcrn=

3. リンクを送信してテストします：
   • 修正したトラッキングリンクをモバイルのテストデバイスに送信します。
   • デバイスからリンクをクリックし、前のテストと同じ手順に従って結果を確認します。 

これらの手順に従うことで、広告 ID が利用できないチャネルについて、確率的アトリビューション手法によるアトリビューションプロセスをテストできます。

トラッキングリンクを実行する

1. トラッキングリンクをテストデバイスに送信します。
2. モバイルデバイスでリンクをクリックして開きます。

リンクをクリックすると、デバイスに応じて Apple App Store または Google Play Store にリダイレクトされます。

アプリのインストール、起動、テスト

1. アプリのダウンロードとインストール
   • アプリストアにアクセスし、Singular Device Assist アプリをダウンロードします。
   • テストデバイスにアプリをインストールします。
2. アプリの起動
   • アプリを開いて Singular のアトリビューションプロセスを実行します。アトリビューションプロセスはアプリを開いたときにのみ開始されます。
3. インストール後イベントの実行
   • アプリ内でインストール後のアクションを実行し、それらのイベントのポストバックをテストします。
   • Singular 連携チームが提供するテストリンクと Singular Device Assist アプリを使用する場合は、アプリ内のボタンでテストイベントを実行します：
     • Copy IDFA/GAID
     • Share IDFA/GAID
     • Start Testing.
   • これらのアクションにより、テストポストバック経由でテストイベントが送信されます。
4. ポストバックで想定されるイベント名：
   • iOS の場合：
     • 「copy IDFA」および／または「share IDFA」（テストイベント）
     • 「start Testing」（テスト収益イベント*）
   • Android の場合：
     • 「Copy GAID」および／または「Share GAID」（テストイベント）
     • 「Start Testing」（テスト収益イベント*）

*収益イベントを使用するには、ポストバックに収益額を含めるよう設定する必要があります。ポストバックで収益値を受け取るには、ポストバックテンプレートに {AMOUNT} マクロ、または Singular のドキュメントにある同等のマクロ が含まれていることを確認してください。 

アトリビューションを確認する

インストールが Singular によって正しくアトリビューションされたことを確認するには：

1. AIFA（Android 広告 ID）または IDFA（Identifier for Advertisers）を Singular の連携エンジニアに共有します。
2. Singular のエンジニアがデータを確認し、関連するテストログを含むフィードバックを提供します。

このプロセスにより、アトリビューション設定の正確性を確保できます。