AndroidまたはiOSアプリとAppsFlyerの連携をテストします。
概要
SDKの実装が完了したら、SDKがAppsFlyerサーバーと正常に通信しているか確認できます。マーケターは、次の2つのテスト方法から選べます。
-
[SDK実装テスト(SDK Integration Tests)]ページでは、次のテストを行えます。
-
テスト対象のアプリで発生したイベントをリアルタイムで確認します。
- 非オーガニックインストールのテスト
- ディープリンク(リターゲティング)のテスト
-
- アトリビューションリンクを使ったテスト。
開発者は、開発環境で実装テストを行えます。 Developer Hubの実装テストに関する記事を参照してください。
CTVアプリもテストできます。CTVのテストを参照してください。
「SDK実装テスト」ページを使ったテスト
[SDK実装テスト]ページでは、インストール、広告収益、アプリ内イベントなど、アプリで発生するイベントをリアルタイムで確認できます。非オーガニックインストール、アプリ内イベント、ディープリンク(リターゲティング)のテストを行い、実装上の問題を特定することもできます。イベントのリアルタイム表示ツールは、従来のアプリ内イベントテストツールに代わるものです。
「SDK実装テスト」ページは、SDKがデバイスIDを取得しているアプリでのみ利用できます。
- iOS:IDFAを取得できるよう、ユーザーがApp Tracking Transparency(ATT)でトラッキングを許可していることを確認してください。 ATTに対応していないアプリは、この記事で説明する手順でテストできます。
- Android:通常、デバイスID(GAID)は自動的に取得されますが、SDKが取得できているか確認することを推奨します。
テストデバイスの準備
- 対象アプリがインストールされていないデバイス(AndroidまたはiOS)を用意します。必要に応じて、デバイスからアプリをアンインストールしてください。
- デバイスをテストデバイスとして登録します。
実装テストの実行
[SDK実装テスト]ページでは、次の3つのテストを行えます。
イベントのリアルタイム表示
イベントのリアルタイム表示ツールは、SDKからAppsFlyerに送信されたデータをリアルタイムで表示するテストツールです。インストール、広告収益、ストア収益のイベントや、その他のアプリ内イベントを確認できます。取得されたイベントごとに、イベントログと詳細を確認できます。
このツールは、テストデバイスで発生し、お客様のサーバーに送信された後、S2S APIを通じてAppsFlyerに取り込まれたアプリ内イベントとセッションにも対応しています。 S2Sイベントには、登録済みテストデバイスの識別子(iOSはIDFA、AndroidはGAID)を含めてください。
イベントのリアルタイム表示ツールでイベントを確認するには、次の手順を実行します。
-
AppsFlyerのサイドメニューから、[設定]>[SDK実装テスト]を選択します。
-
[リアルタイムイベント(Live Events)]をクリックします。
- [アプリ]の一覧で、テストするアプリを選択します。
- [テストデバイス]の一覧で、アプリのテストに使用するデバイスを選択します。テストデバイスがない場合は、[テストデバイスを追加]リンクをクリックして登録できます。
- [続行]をクリックすると、アプリのイベントの記録が始まります。
-
アプリを起動して操作し、セッションやアプリ内イベントを発生させます。
- イベントの項目をクリックすると、右側のパネルに詳細が表示されます。
- イベントの記録を停止する場合は、[停止]をクリックします。再開する場合は、[開始]を再度クリックします。
非オーガニックインストールのテスト
非オーガニックインストールをテストするには、次の手順を実行します。
-
AppsFlyerのサイドメニューから、[設定]>[SDK実装テスト]を選択します。
-
[非オーガニックインストール(Non-Organic Installs)]のテストをクリックします。
- [アプリ]の一覧で、テストするアプリを選択します。
- [テストデバイス]の一覧で、アプリのテストに使用するデバイスを選択します。テストデバイスがない場合は、[テストデバイスを追加]リンクをクリックして登録できます。
- テストデバイスに対象アプリがインストールされている場合は、アンインストールします。
- [テストデバイスからアプリを削除しました(I removed the app from the tested device)]のチェックボックスを選択します。
- [続行]をクリックし、画面の案内に従って進めます。
非オーガニックインストールが記録されない場合は、次のような原因が考えられます。
- IDFAは取得できているものの、テストデバイスが[テストデバイス]ページでIDFAを使って登録されていない。
- テスト対象のアプリ以外にも、お客様のアプリが2つ以上テストデバイスにインストールされているものの、テストデバイスが[テストデバイス]ページでIDFVを使って登録されていない。
- オーガニックインストールとして記録された。
- SDKが組み込まれていないバージョンのアプリでテストを行った。
実装に関するエラーは、開発者にお問い合わせください。
ディープリンク(リターゲティング)のテスト
開始前の準備:
- テスト対象のアプリを3回以上起動します。
- ディープリンク(リターゲティング)をテストするには、アプリのOneLinkを設定しておく必要があります。詳しくは、OneLinkの設定ガイドを参照してください。
- リターゲティング が有効になっていることを確認します。
ディープリンクをテストするには、次の手順を実行します。
アトリビューションリンクを使ったテスト
以下では、アトリビューションリンクを使ってインストールをテストする手順を説明します。アプリがまだ保留中の場合(Google PlayストアやApple App Storeで公開されていない場合)でも、テストできます。
インストールのアトリビューションのテスト
インストールをテストすると、AppsFlyer SDKが各メディアソースにインストールを正しく紐付けているか確認できます。
インストールのアトリビューションをテストするには、次の手順を実行します。
-
以下のリンク(AndroidまたはiOS)をコピーし、次のように変更します。
- app_idの値:AppsFlyerに登録したアプリIDを指定します。
- pidパラメータ:インストールを紐付けるメディアソース名を指定します。
- cパラメータ:キャンペーン名を指定します。
- サードパーティのAndroidアプリストアで配信するアプリをテストする場合は、アトリビューションリンクにaf_rパラメータを追加します。
- GAID、IDFA、IDFVを、使用するデバイスの識別子に置き換えます。
Android
iOS
IDFA
IDFV
具体的な値を指定したアトリビューションリンクの例を以下に示します。
Android
iOS
テストデバイスを登録せずにiOSアプリをテストすると、Protect360によってテストのクリックが不正と判定される場合があります。
不正と判定されないように、リンクに次のクエリパラメータを追加します:pid=ios_testing
- 変更したリンクをコピーしてテストデバイスに送信し、リンクをクリックします。
iOSでは、iMessageまたはメールでデバイスにリンクを送信してください。 iOSの「メモ」アプリにリンクを貼り付けてクリックしないでください。この操作によって、リンクが正しく機能しなくなる場合があります。
-
次のいずれかを実行します。
- アプリが公開済みの場合は、そのままインストールします。
- アプリが保留中の場合は、「お探しのアプリはまだストアで公開されていません。」というメッセージが表示されます。これは正常な動作です。アプリが公開されていないため、アトリビューションリンクからアプリストアには移動しません。ただし、リンクはアトリビューションに利用できるため、次の方法でアプリをインストールしてください。
- Androidの場合:APKファイルからインストールします。開発者はAndroid Studioからインストールすることもできます。
- iOSの場合:TestFlightからインストールします。開発者はXcodeからインストールすることもできます。
Testというメディアソースのテストキャンペーンに紐付いたインストールが表示されます。アプリのダッシュボードにインストールが表示されるまで、最大30分かかります。
テスト結果は、次の方法でも確認できます。
- ローデータレポートへのアクセス権がある場合は、インストールのローデータレポートをダウンロードします。レポートのダウンロードには、数分かかります。レポートのダウンロード手順:
- AppsFlyerのサイドメニューから、[レポート]>[ローデータ出力]を選択します。
- [ユーザー獲得(非オーガニック)]の一覧で[インストール]をクリックし、レポートをダウンロードします。
- デバッグログにアクセスできる場合は、コンバージョンデータ取得API(Get the conversion data API)を使って、特定のインストールのアトリビューション結果を取得できます。
アプリ内イベントのアトリビューションのテスト
アプリ内イベントをテストすると、イベントに関連付けられた収益が表示されることと、インストールを獲得したメディアソースにアプリ内イベントが紐付けられていることを確認できます。
アプリ内イベントのアトリビューションをテストするには、次の手順を実行します。
- アプリを起動し、いくつかのアプリ内イベントを発生させます。
- アプリのアクティビティダッシュボードを開き、イベントが表示されていることを確認します。
イベント、イベントに関連する収益(収益がある場合)、紐付けられたメディアソースが表示されます。ダッシュボードにイベントが表示されるまで、最大60~70分かかります。
ヒント:アプリ内イベントのローデータレポートをダウンロードし、イベントが正しく紐付けられているか確認することを推奨します。レポートのダウンロードには、数分かかります。
レポートのダウンロード手順:
- AppsFlyerのサイドメニューから、[レポート]>[ローデータ出力]を選択します。
- [ローデータレポート]セクションで、アプリ内イベントのローデータレポートをダウンロードします。
OneLinkのテスト
OneLinkでは、AndroidとiOSの両方に対応するアトリビューションリンクを1つ作成できます。 OneLinkはユーザーのデバイスを識別し、適切なアプリストアにリダイレクトします。
また、OneLinkはディープリンクにも対応しています。ディープリンクでは、ユーザーに合わせたコンテンツを表示しながら、アプリの特定の画面を開けます。
詳しくは、OneLink URLのテストのガイドを参照してください。
アトリビューションリンクを使ったリターゲティングのテスト
以下では、リターゲティングのアトリビューションをテストする手順を説明します。
リターゲティングテストの概要
ユーザーがリターゲティング用のアトリビューションリンクをクリックしてキャンペーンに接触すると、リターゲティングのアトリビューションが行われます。この結果、リアトリビューションまたはリエンゲージメントのイベントが発生します。詳しくは、リターゲティングのアトリビューションガイドを参照してください。
リターゲティングのテストには、次のものがあります。
- リアトリビューション:アプリをアンインストールし、再インストールします。その後、ダッシュボードでインストールが記録されたことを確認します。
- リエンゲージメント:リターゲティング用のアトリビューションリンクまたはディープリンクをクリックし、正しいメディアソースにリエンゲージメントが紐付けられていることを確認します。
リターゲティングテストの事前準備
リターゲティングをテストする前に、次の設定が必要です。
- テスト対象のアプリで、リターゲティングを有効にします。
- アプリ専用リンクを作成するか、OneLinkのカスタムリンクを取得します。リンクには、リターゲティング用のパラメータを含める必要があります。
リターゲティングテストの設定手順:
-
アプリの設定でリターゲティングを有効にします。
アプリのダッシュボードで[アプリ設定]をクリックし、[リターゲティングのアトリビューションを有効にする]をオンにします。
- 次のいずれかを実行します。
-
アプリ専用のアトリビューションリンクを作成します。リターゲティング用のパラメータ
is_retargeting=trueと広告IDを必ず含めてください。 GAID、IDFA、IDFVの確認方法は、テストデバイスの登録の手順を参照してください。
デバイス識別子として、Android用のパラメータ(GAID)を含むアトリビューションリンクの例を以下に示します。 IDFAやIDFVなど、その他のデバイス識別子のパラメータの追加方法は、アトリビューションリンクの構造とパラメータを参照してください。 -
カスタムリンクのロングURLを、OneLinkテンプレートから取得します。[リターゲティングキャンペーン]を必ず有効にしてください。以下の画像は、カスタムリンクのロングURLの例です。
-
ここまでの設定が完了したら、リアトリビューションとリエンゲージメントをテストできます。
リアトリビューションのテスト
開始前の準備:
- リターゲティングテストの設定手順に従います。
- デバイスがテストデバイスとして登録されていないことを確認してください。
リアトリビューションをテストするには、次の手順を実行します。
- デバイスからアプリをアンインストールします。インストールしたばかりの場合は、数分待ちます。
- 事前に作成したアトリビューションリンク(アプリ専用のアトリビューションリンク、またはOneLinkテンプレートのカスタムリンクのロングURL)をコピーしてテストデバイスに送信し、リンクをクリックします。
iOSでは、iMessageまたはメールでデバイスにリンクを送信してください。 iOSの「メモ」アプリにリンクを貼り付けてクリックしないでください。この操作によって、リンクが正しく機能しなくなる場合があります。
- 次のいずれかを実行します。
- アプリが公開済みの場合は、そのままインストールします。
- アプリが保留中の場合は、次の方法でインストールします。
- Androidの場合:Android StudioまたはAPKファイルからインストールします。
- iOSの場合:TestFlightからインストールします。
- アプリのダッシュボードを開き、[表示タイプ]で[リターゲティング]を選択します。
-
[アトリビューションタイプ]で[リアトリビューション]を選択します。
メディアソースとキャンペーンに紐付いたインストールが表示されます。リターゲティングによるインストールがダッシュボードに表示されるまで、最大30分かかります。
テスト結果は、次の方法でも確認できます。
- ローデータレポートへのアクセス権がある場合は、コンバージョンのローデータレポートをダウンロードします。レポートのダウンロードには、数分かかります。レポートのダウンロード手順:
- AppsFlyerのサイドメニューから、[レポート]>[ローデータ出力]を選択します。
- [リターゲティング]の一覧で[コンバージョン(リエンゲージメントとリアトリビューション)]をクリックし、レポートをダウンロードします。
- デバッグログにアクセスできる場合は、SDK実装テストAPIを使って、特定のインストールのアトリビューション結果を取得できます。
リエンゲージメントのテスト
開始前の準備:
- リターゲティングテストの設定手順に従います。
- テストでは、コンバージョン間の最短間隔を[なし(None)]に設定します。これにより、テスト中のすべてのリエンゲージメントコンバージョンを記録し、紐付けられます。
- テストデバイスにアプリがインストールされ、複数回起動されていることを確認します。インストールしたばかりの場合は、数分待ちます。
リエンゲージメント(直接ディープリンク)をテストする方法:
アプリにディープリンクが設定されていることを確認し、こちらの手順に従ってテストします。
リエンゲージメント(間接ディープリンク)をテストする方法:
- 事前に作成したアトリビューションリンク(アプリ専用のアトリビューションリンク、またはOneLinkテンプレートのカスタムリンクのロングURL)をコピーします。
- リンクをテストデバイスに送信し、クリックします。
-
次のいずれかの方法でアプリを開きます。
- アプリストアで[開く]をクリックします。
- デバイスからアプリを起動します。
ダッシュボードに、メディアソースとキャンペーンに紐付いたリエンゲージメントが表示されます。リエンゲージメントが表示されるまで、最大30分かかります。
ヒント:コンバージョンのローデータレポートをダウンロードし、リエンゲージメントが正しいメディアソースに紐付けられているか確認することを推奨します。レポートのダウンロードには、数分かかります。
レポートのダウンロード手順:
- AppsFlyerのサイドメニューから、[レポート]>[ローデータ出力]を選択します。
- [リターゲティング]セクションで、[コンバージョン(リエンゲージメントとリアトリビューション)]レポートをダウンロードします。
オーガニックインストールのテスト
最初にオーガニックインストールをテストすることを推奨します。
オーガニックインストールをテストするには、次の手順を実行します。
- 登録済みのテストデバイスにアプリをインストールします。
- アプリを起動します。
アプリのダッシュボードに、新しいオーガニックインストールが表示されます。インストールが表示されるまで、最大30分かかります。
CTVのテスト
特殊なテストケースには、次のものがあります。
- Android TV:SDKは、Androidベースのスマートテレビに対応しています。マーケターやチームメンバーは、この記事の手順に従って、これらのテレビ向けアプリをテストできます。
- Apple TV(tvOS):SDKは、Apple TV(tvOS)に対応しています。マーケターやチームメンバーは、この記事の手順に従って、これらのテレビ向けアプリをテストできます。
- 未公開のtvOSアプリ:マーケターと開発者が協力してテストする必要があります。公開前のtvOS実装テストを参照してください。
- Amazon Fire TV:マーケターは、AppsFlyerダッシュボードのAndroid SDKのテスト方法を使って、実装をテストできます。詳しくは、Amazon Fire TVのアトリビューションを参照してください。
- PBAのWebイベント:マーケターと開発者が協力してテストする必要があります。PBAのWeb SDK実装テストを参照してください。
関連記事
- アドネットワーク連携のテスト アドネットワーク連携のテスト
仕様と制限事項
| 項目 | 補足 |
|---|---|
| テスト用リンク | 登録済みテストデバイスを使用する場合は、テスト用リンクからaf_inactivity_windowパラメータを削除してください。削除しないと、テスト用リンクに紐付くはずのインストールが、誤ってオーガニックに紐付けられる場合があります。 |