SDK実装のテスト方法

SDK 実装テストのページを使用することで、SDK実装における問題点を見つけることができるので、インストール、アプリ内イベント、ディープリンクのテストにご利用ください。

SDK実装のテスト

SDK実装をテストするには：

1. まず、アプリがインストールされていない端末(iOS / Android)を準備してください。事前に、アプリは端末からアンインストールしておいてください。
2. 端末をテスト端末として登録してください。 注意！iOS：TestFlightを使用してアプリをインストールする場合には、反当m津をテスト端末に登録する必要はありません。
3. AppsFlyerの管理画面上で、テストするアプリを選択してください。
4. 管理画面左メニューの設定 > SDK実装テスト をクリックしてください。
   SDK実装テストのページが表示されます。
   
5. テストする内容を選択してください：
   • 非オーガニックインストール
   • アプリ内イベント
   • ディープリンク
6. 選択したテストタイプに応じて、以下のテスト手順を実施してください。

テストアプリを使用したSDKの実装テスト

計測リンクを使用してテストを行うと、計測されたデータがアプリの管理画面上に表示されます。一度記録されると、そのデータを削除することはできません。本番アプリの実際のデータとテストデータを混在させたくない場合は、デバッグアプリを使ってSDK実装をテストできます。 

テストアプリを必要としない場合やテストデータが実際のデータと混ざることを気にしない場合は、 このセクションをスキップください。

デバッグアプリは、アプリストアに公開されているアプリと全く同一のコピーとなります。テストアプリでSDK実装テストすることで、実際のデータとテストデータが混ざることを防ぐことができます。

デバッグアプリは、次の点で本番アプリと異なります。

• アプリIDが異なる
• 独自の管理画面がある
• アプリストアに公開されていない

計測リンクを使用したテスト

このセクションでは、計測リンクを利用して実装確認をする方法を紹介します。

はじめに：

• 使用する端末を、テスト端末として登録してください。
• リアトリビューションのテストを実施する際には、テストに使用する端末を事前にテスト端末のリストから削除してください。
• サードパーティのAndroidアプリストアで利用可能なアプリのアトリビューションテストを実施する場合には、特定のアプリストアへ遷移させるために計測リンクにaf_rのパラメータを追加設定する必要があります。 

アプリが承認待ち（Google PlayやAppStoreに表示されていない）の状態でも、SDKの実装テストは実施可能です。

このセクションでは、次のトピックについて説明します。：

• インストールのテスト
• アプリ内イベントのテスト
• リターゲティング計測のテスト (リアトリビューション / リエンゲージメント)

インストールアトリビューションのテスト

インストールのテストでは、AppsFlyerのSDKがインストールを各種メディアソースに正しく紐づけることができるかどうかを確認できます。

ステップ 1：

以下のリンクをコピーしてください：

https://app.appsflyer.com/<app_id>?pid=Test&c=Test&advertising_id=<GAID>

https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfa=<IDFA>

app_idのパラメータをあなたのアプリIDに変更してください。 (頭文字のidを含んだ状態で設定してください。例：id0123456789)

• c パラメータには、キャンペーンの名前を指定します。
• pid パラメータには、インストールが紐づくメディアソースの名前を指定します。
• サードパーティの Androidアプリストアで利用可能なアプリをテストする場合：計測リンクに af_rのパラメーターを追加してください。 

PCからクリックをテストする場合には、Android用のGAID (Google Advertising ID)、またはiOS用のIDFAを計測URLに追加してください。

ステップ 2：

リンクをコピーしてテストデバイスに送信し、ブラウザを使用してリンクに移動します。

• アプリが公開されている場合は、インストールに進みます。
• アプリが承認待ちの場合、開発環境からアプリをインストールします：
  --Android：Android StudioまたはADB shellからインストール
  --iOS：XCodeからインストール

ステップ 3：

インストールがアプリの管理画面に表示されるまで2分ほどかかります。メディアソース名Test キャンペーン名Testとしてインストールが計測されていることを確認できます。

アプリ内イベントのテスト

アプリ内イベントをテストし、イベントが関連付けられている収益の表示、またインストール時のメディアソースに成果が紐づいていることを確認できます。

計測リンクを使用してアプリをインストール後、アプリ内イベントをいくつか発火させてください。管理画面にイベントが表示されるまでには最大2分かかります。アプリ管理画面を開き、左メニューの アプリ内イベント をクリックしてください。

アプリ内イベント、収益（収益が関連付けられている場合）、および関連付けられているメディアソースが表示されます。

OneLinkのテスト

OneLink™を使用すると、iOSとAndroidの両方に単一の計測リンクを設定できます。OneLinkがユーザーの端末を認識し、該当するアプリストアにユーザーをリダイレクトします。

OneLinkはディープリンクも可能にします。ディープリンクを使用すると、カスタマイズコンテンツを配信するために、特定のアプリアクティビティをアプリで開くことができます。

詳細については、OneLink URLのテストに関するガイドを参照してください。

リターゲティングのテスト

リターゲティングをテストするための前提条件

1. OneLinkテンプレート：OneLinkテンプレート設定を参照してください。
2. アプリ設定で、リターゲティングを有効にする

   アプリ管理画面で、アプリ設定をクリックし、リターゲティング広告測定を有効にするを必ずオンに切り替えてください。

   Android iOS

   

   

3. テスト端末に登録していない端末

リターゲティングのテストは簡単です。OneLinkテンプレートからカスタム計測リンクを作成してください。リターゲティングキャンペーンの項目をオンに設定してください。

カスタム計測リンク設定が完了すると、以下の画面が表示され、ロングリンクを取得できます。

リンクマネジメント画面から、ロングURLを取得することも可能です。

1. リンクマネージメントの画面で、計測リンクを見つけてください。
2. 右側のアクションの下の３つの点をクリックしてください。
3. リンク詳細を表示をクリックしてください。
4. ロングリンクをコピーしてください。

最終的に生成されるOneLinkは下記のようになります。：

https://go.onelink.me/2rAD?pid=Test&c=Test&is_retargeting=true&advertising_id=<GAID>

https://go.onelink.me/2rAD?pid=Test&c=Test&is_retargeting=true&idfa=<IDFA>

リアトリビューションのテスト

リアトリビューションをテストで、過去にアプリをアンインストールしたユーザーのアプリ再インストールを計測することができることを確認できます。

1. 使用している端末がテスト端末に登録されていないことを確認してください。
2. アプリがインストールされたばかりの場合は、数分お待ちください。
3. デバイスからアプリをアンインストールします。
4. インストール計測をするために、上記のOneLinkのフォーマットを利用して、同じ手順を繰り返します。
5. リターゲティングされたインストールが管理画面に表示されるまで最大2分程度お待ちください。
6. アプリの管理画面を開き、左メニューよりリターゲティング画面を開きます。
7. リアトリビューションの結果として、メディアソースTestキャンペーン名Testの下にインストールが表示されます。

より詳細な確認を行うには、コンバージョンローデータレポートをダウンロードできます。

管理画面で レポートセクションのデータエクスポートをクリックしてください。リターゲティングレポートセクションで、コンバージョンのローデータレポートをダウンロードします。

リエンゲージメントのテスト

リエンゲージメントは、アプリをインストールしているユーザーがリターゲティングキャンペーンを経てアプリを起動したときに発生します。

アプリ起動経由のリエンゲージメントのテスト

アプリ起動からのリエンゲージメントとは、ユーザーがアプリストアにリダイレクトされ、ストアページ上の「アプリを開く」のボタンが表示されるようなフローが該当します。「アプリを開く」のボタンをクリックしアプリを起動すると、リエンゲージメントが記録されます。

リエンゲージメントをテストするには、以下の手順に従ってください：

1. アプリがテストデバイスにインストールされ、数回起動されていることを確認する
2. アプリがインストールされたばかりの場合は、数分お待ちください。
3. リアトリビューションのテストに使用したものと同じOneLinkを使用する
4. リンクにデバイスIDを追加し、モバイルデバイスに送信します。
5. ブラウザを使用してリンクに移動します
6. アプリストアまたはデバイスのローンチパッドにて、「開く」ボタンをクリックしてアプリを開きます。

メディアソースTestキャンペーン名Testの下にリエンゲージメントが表示されます。

Android iOS

ディープリンク経由のリエンゲージメントのテスト

ディープリンクによるリエンゲージメントを行うと、ユーザーが計測リンクをクリックした直後にアプリが起動できます。ディープリンクによるリエンゲージメントのメリット：

1. より良い方法：ユーザーはストアにリダイレクトされることなく、アプリが自動的に開きます。
2. 推奨：広告キャンペーンの内容に沿ったアクティビティが開くように設定することで、リターゲティングキャンペーンの効果を最大化することができます。

ディープリンクを使用してリエンゲージメントアトリビューションをテストできます。これは計測リンクによるリエンゲージメントのテストと同じ手順ですが、唯一の違いはユーザーをアプリ内の特定のアクティビティにリダイレクトさせるパラメータである、af_dpが計測リンクに含まれていることです。

ディープリンクによるリエンゲージメントをテストするには、以下の手順に従ってください：

1. ディープリンクの設定が完了していることを参照してください。
2. アプリがテストデバイスにインストールされ、数回起動されていることを確認する
3. アプリがインストールされたばかりの場合は、数分お待ちください。
4. デバイスIDを含むリターゲティング用のリンクを生成します。
5. af_dpパラメーターを追加し、ステップ1で生成したスキームを入力します。
6. ブラウザを使用してリンクに移動します
7. アプリがインストールされている場合、アプリが起動され、リンク内で指定したアクティビティが開きます。

メディアソースTestキャンペーン名Testの下にリエンゲージメントが表示されます。

詳細については、ディープリンクのテストのガイドを参照してください。

その他のSDK実装テストの方法

SDKの実装テストは、以下の2つの方法でも可能です。：

1. テストアプリを利用したAndroid SDKの実装テスト
2. アプリ管理画面からのiOS SDK実装テスト

このセクションでは、SDKのでデバッグ方法について説明します。このセクションを参照して、高度なテストを行い、SDKの実装に関する問題のトラブルシューティングを行いましょう。

AppsFlyerLib.getInstance().setDebugLog(true);

implementation 'com.google.android.gms:play-services-base:15.0.1'
implementation 'com.google.android.gms:play-services-ads:15.0.1'

[AppsFlyerLib shared].isDebug= true;

AppsFlyerLib.shared().isDebug= true

[AppsFlyerTracker sharedTracker].appleAppID = @"340954503";

[AppsFlyerTracker sharedTracker].appleAppID = @"id340954503";

[AppsFlyerTracker sharedTracker].appleAppID = @"com.appslyer.sampleapp";

[ERROR] AppsFlyer: -[AppsFlyerTracker validateAppID] 
AppsFlyer Error: appleAppID should be a number!

AppsFlyer: -[AppsFlyerHTTPClient sendRequestEventToServer:isRequestFromCache:appID:isDebug:
completionHandler:]_block_invoke sent information to server, status = 404

AppsFlyer: -[AppsFlyerHTTPClient sendRequestEventToServer:isRequestFromCache:appID:isDebug:completionHandler:]
_block_invoke sent information to server, status = 400

[AppsFlyerTracker sharedTracker].appsFlyerDevKey = @"YOUR_DEV_KEY";

AppsFlyerTracker.shared().appsFlyerDevKey = "YOUR_DEV_KEY"

AppsFlyer.setIsDebug (true);