テスト端末の登録

概要: アトリビューションテストを行う際は、テスト端末を登録し、各インストールが新規インストールとして記録されるようにしてください。登録済みのテスト端末では、インストールが再インストールと記録されることはありません。

テスト端末を登録する理由

アトリビューションテストを行う場合、リアトリビューション期間により、インストールのアトリビューションは90日間に1回に制限されます。したがって、同じ端末を繰り返し利用してインストールのアトリビューションをテストすると、何も記録されません。端末をテスト端末として登録すると、その端末での繰り返しインストールが再インストールとして記録されなくなります。

テスト端末の登録方法

テスト端末を登録する際には、端末のオペレーティングシステム(Android、iOS、またはWindows)を選択し、端末IDを追加します。

登録には、以下の方法が使用できます:

  • AppsFlyerのMy Device 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

テスト端末登録の管理

AppsFlyerMy Device IDアプリで端末を登録する

AppsFlyerMy Device IDアプリのダウンロード方法:

  1. QRコード(Google Playストア)または提供されたリンクからアプリをダウンロードしてインストールします。

    Android

    iOS

    Windows

  2. iOS 14.5以降の端末でIDFAの収集を許可するには、ATTプロンプトが表示された際に 許可を押下してください。
  3. Android/iOS/Windows画面で登録をタップして端末を登録します。

    Android

    iOS

    Windows

  4. AppsFlyerのログイン資格情報を入力してください。端末が登録されました。
  5. 端末ID情報を共有するには、共有をタップします。

端末を手動で登録

アカウントユーザーは端末を手動で登録可能です:

  1. AppsFlyer管理画面サイドメニューから、設定 -> テスト端末を選択します。
  2. テスト端末を選択します。
  3. +端末を追加をクリックします。

  4. 以下を完了してください。
    • 名前(英語のみ使用): 端末の一意の識別名を入力します。
    • OS: オペレーティングシステムを選択してください。
    • 端末IDタイプ: 端末識別子を選択してください。
    • 端末ID: オペレーティングシステムに応じて端末IDを指定します。

      iOS

      IDFAまたはIDFV識別子の取得方法:

      • IDFA:IDFAを取得するには、テスト端末にAppsFlyerMy Device IDアプリをインストールしてください。詳しくは次を参照してください:上記のAppsFlyerのMy Device IDアプリを使用して端末を追加します(管理者のみ)。
      • IDFV:IDFVを取得するには、開発者にテスト端末にIDFVテストツールアプリをインストールしてもらってください。インストールおよび起動後にツールアプリでIDFVを確認できます。注:テストツールは、開発者がX-Codeで予備手順を実行した後にのみインストールできます。

      IDFAやIDFVの使用時期については、iOSテスト端末の登録を確認してください。

      Android

      識別子は、AppsFlyerMy Device IDアプリを利用するか、端末にコードを入力して取得してください。

      識別子 取得方法 Google Play その他
      AID (GAID または OAID) AppsFlyerMy Device IDアプリを使用 必須  
      IMEI *#06#* 適用外 開発者:IDを収集するためにSDKでsetCollectImeiを実装していることを確認してください。
      Android ID *#*#8255#*#*(新しい端末では動作しない場合があります) 適用外 開発者:setCollectAndroidIDを利用してSDKでIDを収集していることを確認してください。
  5. 保存をクリックします。 登録済み端末のリストに端末が表示されます。 :端末は登録済みリストにすぐ表示されますが、システムに完全に登録されて意図通りに機能するまでには数分かかる可能性があります。

複数の識別子を追加

テスト端末に複数の識別子を追加したい場合もあります。例えば、同じ端末にIDFAとIDFVの両方が必要です。

追加の識別子を追加するには:

  1. 端末の追加をクリックします。
  2. テスト端末に同じ名前を利用し、2番目の識別子を追加します。
  3. 保存をクリックします。

 

端末の登録解除

1アカウントにつき最大200台の端末を登録できます。 

リストから端末を削除する:

  1. AppsFlyerで、右上のメールアドレスをクリックします。
  2. テスト端末を選択します。
  3. 削除アイコンをクリックして端末を削除します。

iOSテスト端末の登録

以下のフローチャートは、iOSテスト端末登録の選択肢を示しています。

iOSテスト端末の登録時に次のオプションを選択してください:

IDFAでテスト端末を登録

テスト端末の登録にIDFAを利用するタイミングはいつ?

アプリにAppTransparency Tracking(ATT)が実装されている場合、同意したユーザーとしてテストを行う際はIDFAに登録可能です。テストアプリを初めて起動する際は、必ずATTプロンプトで許可をクリックしてください。

テスト端末をIDFAで登録するには?

IDFAを用いて端末を登録するには、AppsFlyerMy Device IDアプリを利用します。

テスト端末をIDFVで登録

テスト端末の登録にIDFVを利用するのはどのような場合ですか?

IDFAが利用できないときはIDFVが唯一の選択となります。以下の場合には、必ずIDFVを使用してください。

  • ATTが実装されているが、非同意ユーザーとしてテストを実行したい場合。アプリを初回起動する際、ATTプロンプトで許可しないを選択必須です。
  • アプリにATTが全く実装されていない状態。

IDFVで端末を登録する手順

  1. 端末をIDFVで登録するために、開発者はまずテスト端末にIDFVテストツールアプリをインストールする必要があります。開発者向けの詳細手順は、この記事を参照してください。
  2. 開発者がIDFVテストツールアプリをインストールした後、それを起動し表示されたIDFVをコピーします。
  3. IDFVを利用してテスト端末を手動で登録してください。

IDFVテストツールアプリをインストールする目的 

  • このツールは、端末登録に必要なIDFVを取得するために使用されます。
  • 開発者アカウントに紐付いた別のアプリがテスト端末にインストールされていない場合に利用します。iOSはこの場合、アプリを再インストールするたびに新しいベンダーIDを割り当てます。テストにおいてはアプリの再インストールが伴う場合があるため、その都度iOSはIDFVをリセットします。このユーティリティアプリはiOSが新しいIDFVを再インストールごとに生成しないようにしつつ、ベンダーとして動作します。

未登録端末を用いたテスト

IDFAまたはIDFVでの端末登録ができない場合に限り、このオプションを利用します。この場合、アトリビューションには確率論的モデリングを使用します。すべてのインストールはテスト端末における新規インストールとして記録されます。この方法は、以下のいずれかの場合に、同じ端末の繰り返しテストインストールを支援します:

  • AppsFlyer iOS SDKがv6.8.0以下の場合
  • アプリの再インストール検出が無効の場合(本番アプリには推奨されません)。
  • テスト計測リンクに is_retargeting="true" が含まれている場合この場合、インストール(再インストール)は「リアトリビューションCV」として記録され、リターゲティングレポートで利用できるようになります。
  • iOSのみ:Protect360がクリックを不正と判断しないようにするには、テストアトリビューションリンクにクエリパラメータpid="ios_testing"を追加してください。