概要: アトリビューションテストを行う際は、テストデバイスを登録し、各インストールが新規インストールとして記録されるようにしてください。登録済みのテストデバイスでは、インストールが再インストールと記録されることはありません。
テストデバイスを登録する理由
アトリビューションテストを行う場合、リアトリビューション期間により、インストールのアトリビューションは90日間に1回に制限されます。したがって、同じデバイスを繰り返し利用してインストールのアトリビューションをテストすると、何も記録されません。デバイスをテストデバイスとして登録すると、そのデバイスでの繰り返しインストールが再インストールとして記録されなくなります。
テストデバイスの登録方法
テストデバイスを登録する際には、デバイスのオペレーティングシステム(Android、iOS、またはWindows)を選択し、デバイスIDを追加します。
登録には、以下の方法が使用できます。
-
AppsFlyerのMyデバイスIDアプリをダウンロードしてインストール:テストデバイスにアプリをインストールすると、そのデバイスを自動的に登録し、デバイスIDの詳細をAppsFlyerアカウントに共有することができます。デバイスは自動的にテストデバイスページに表示されます。
注意
iOS 14以降のテストデバイスでは、アプリにAppTrackingTransparency (ATT) が実装され、同意を得たユーザーとしてテストを行う場合に限り、この登録方法を使用できます。この条件を満たさない場合は、手動での方法を使用してください。
- テストデバイスを手動で追加: どのアカウントユーザーも、テストデバイスページにデバイスIDを追加することで、テストデバイスを直接登録できます。
次に注意してください。
- 登録されたテストデバイスは、アカウント内のすべてのアプリで利用可能です。
- 広告ネットワークは広告主にデバイス追加を依頼する必要がありますが、代理店は独自のデバイスを追加可能です。
サポートされているデバイス識別子
デバイス識別子には次のものが含まれます。
-
Android: AID(GAIDまたはOAID)、IMEI、Android ID
注意
テストデバイスを登録する際は、アプリがこれらの識別子を収集・使用する場合にのみ、IMEIまたはAndroid IDデバイス識別子を追加してください。
- iOS: IDFA、IDFV
- Windows Phone: Windows 広告ID
テストデバイス登録の管理
AppsFlyerデバイスIDアプリでデバイスを登録する
AppsFlyerデバイスIDアプリのダウンロード方法:
デバイスを手動で登録
アカウントユーザーはデバイスを手動で登録可能です:
- AppsFlyerのサイドメニューから、設定 -> テストデバイスを選択します。
- テストデバイスを選択します。
- +デバイスを追加をクリックします。
- 以下を完了してください。
- 名前(英語のみ使用): デバイスの一意の識別名を入力します。
- OS: オペレーティングシステムを選択してください。
- デバイスIDタイプ: デバイス識別子を選択してください。
-
デバイスID: オペレーティングシステムに応じてデバイスIDを指定します。
IDFAまたはIDFV識別子の取得方法:
- IDFA:IDFAを取得するには、テストデバイスにAppsFlyerデバイスIDアプリをインストールしてください。詳しくは次を参照してください:上記のAppsFlyerデバイスIDアプリ(管理者のみ)を使用してデバイスを追加します。
- IDFV:IDFVを取得するには、開発者にテストデバイスにIDFVテストツールアプリをインストールしてもらってください。インストールおよび起動後にツールアプリはIDFVを表示します。注:テストツールは、開発者がX-Codeで予備手順を実行した後にのみインストールできます。
IDFAやIDFVの使用時期については、「iOSテストデバイスの登録」を確認してください。
識別子は、AppsFlyerデバイスIDアプリを利用するか、デバイスにコードを入力して取得してください。
識別子 取得方法 Google Play その他 AID (GAID または OAID) AppsFlyerデバイスIDアプリを使用します 必須 IMEI *#06#* 適用外 開発者がIDを収集するためにsetCollectImeiを利用したことを確認してください。 Android ID *#*#8255#*#*(新しいデバイスでは動作しない場合があります) 適用外 開発者がsetCollectAndroidIDを利用してIDを収集したことを確認してください。 Windows広告ID Windows広告IDを取得
- [保存]をクリックします。 登録済みデバイスのリストにデバイスが表示されます。 注:デバイスは登録済みリストにすぐ表示されますが、システムに完全に登録されて意図通りに機能するまでには数分かかる可能性があります。
注意
複数の識別子を追加
テストデバイスに複数の識別子を追加したい場合もあります。例えば、同じデバイスにIDFAとIDFVの両方が必要です。
追加の識別子を追加するには:
- [デバイスの追加]をクリックします。
- テストデバイスに同じ名前を利用し、2番目の識別子を追加します。
- [保存]をクリックします。
デバイスの登録解除
1アカウントにつき最大200台のデバイスを登録できます。
リストからデバイスを削除するには
- AppsFlyerで、右上のメールアドレスをクリックします。
- テストデバイスを選択します。
- 削除アイコンをクリックしてデバイスを削除します。
iOSテストデバイスの登録
以下のフローチャートは、iOSテストデバイス登録の選択肢を示しています。
iOSテストデバイスの登録時に次のオプションを選択してください。
IDFAでテストデバイスを登録
テストデバイスの登録にIDFAを利用するタイミングはいつか?
アプリにAppTransparency Tracking(ATT)が実装されている場合、同意したユーザーとしてテストを行う際はIDFAに登録可能です。テストアプリを初めて起動する際は、必ずATTプロンプトで[許可]をクリックしてください。
テストデバイスをIDFAで登録する方法
IDFAを用いてデバイスを登録するには、AppsFlyerデバイスIDアプリを利用します。
テストデバイスをIDFVで登録
テストデバイスの登録にIDFVを利用するのはどのような場合ですか?
IDFAが利用できないときはIDFVが唯一の選択となります。以下の場合には、必ずIDFVを使用してください。
- ATTが実施されていますが、非同意ユーザーとしてテストを実行したい場合。アプリを初回起動する際、ATTプロンプトで[許可しない]を選択必須です。
- ATTが全く実装されていない状態。
IDFVでデバイスを登録する手順
- デバイスをIDFVで登録するために、開発者はまずテストデバイスにIDFVテストツールアプリをインストールする必要があります。開発者向けの詳細手順は、この記事を参照してください。
- 開発者がIDFVテストツールアプリをインストールした後、それを起動し表示されたIDFVをコピーします。
- IDFVを利用してテストデバイスを手動で登録してください。
注意
IDFVテストツールアプリをインストールする目的
- このツールは、デバイス登録に必要なIDFVを取得するために使用されます。
- 開発者アカウントに紐付いた別のアプリがテストデバイスにインストールされていない場合に利用します。iOSはこの場合、アプリを再インストールするたびに新しいベンダーIDを割り当てます。テストにおいてはアプリの再インストールが伴う場合があるため、その都度iOSはIDFVをリセットします。このユーティリティアプリはiOSが新しいIDFVを再インストールごとに生成しないようにしつつ、ベンダーとして動作します。
未登録デバイスを用いたテスト
IDFAまたはIDFVでのデバイス登録ができない場合に限り、このオプションを利用します。この場合、アトリビューションには確率論的モデリングを使用します。すべてのインストールはテストデバイスにおける新規インストールとして記録されます。この方法は、以下のいずれかが発生した場合に、同じデバイスの繰り返しテストインストールを支援します。
- AppsFlyer iOS SDKはv6.8.0以下です。
- アプリの再インストール検出が無効になっています(ライブアプリには推奨されません)。
- テストアトリビューションリンクに
is_retargeting="true"
が含まれています。この場合、インストールは再アトリビューションとして記録され、リターゲティング管理画面とリターゲティングローデータレポートで利用できるようになります。 - iOSのみ:Protect360がクリックを不正と判断しないようにするには、テストアトリビューションリンクにクエリパラメータ
pid="ios_testing"
を追加してください。