AppsFlyer SDKの実装テスト – ヘルプセンター

SDK実装テストとデバッグ

AppsFlyer SDKを実装後は、アプリストアでアプリを公開する前にSDKの実装テストを行ってください。

テストとデバッグの特殊なケース

AppsFlyerはAndroidベースのスマートテレビやApple TV(tvOS)と互換性があります。このガイドの手順に従って、Android TVやApple TV用アプリのSDK実装テストを行ってください。
未公開のtvOSアプリについては、公開前に行うtvOS実装テストを参照してください。
Amazon Fire TV向けアプリについては、そのほかのAndroidストアのテストを参照してください。

なぜデバッグとテストが必要ですか？

慎重にテストされた実装は、正確で包括的なデータ収集が保証されます。
SDK実装をテストすることで、インストールとアプリ内イベントが正しいキャンペーンの成果として記録されるかを確認できます。

SDK実装テストとデバッグ

次のいづれかのメソッドを使用して、SDK実装のテストとデバッグを実施ください。

基本的なテスト - 計測リンクを使用した実装テスト

AppsFlyerのアトリビューションモデルでは、計測リンクを使用します。計測リンクを使用してテストを行うことをお勧めします。

計測リンクを利用してSDK実装テストを行うと、AppsFlyerアトリビューションモデルを詳しく理解できるようなります。AppsFlyerアトリビューションモデルや機能に関する知見は、マーケティングの運用と分析を最適化する機会を提供します。

高度なテスト - 開発環境からの直接デバッグ

SDK実装テストセクションでは、限られた一連機能のテストのみが行われます。購入検証、コンバージョンデータ、SDK設定時のエラーについては扱いません。デバッグログを使用して、開発環境下でこれらをテストすることができます。

アドネットワークの方で、AppsFlyerまたは広告主と連携テストを行いたい場合は、アドネットワーク連携テストガイドを参照ください。

AppsFlyerでは、アプリへのiOS SDKとAndroid SDKの実装をテストするための専用のSDK実装テスト ページを提供しています。

SDK 実装テストのページを使用することで、SDK実装の問題を見つけることができます。インストール、アプリ内イベント、ディープリンクをテストできます。

SDK実装のテスト

そのアプリをインストールしていないiOSまたはAndroid端末を使用してください。アプリが既にインストールされている場合には、最初にアプリをアンインストールしてください。
SDK実装テストは、ホワイトリスト登録されたテスト端末で行う必要があります。テスト端末をホワイトリスト登録するには、こちらの手順に従ってください。

ヒント

iOS: TestFlightを使用してアプリをインストールする場合、端末をホワイトリストに登録する必要はありません。
AppsFlyerの管理画面を開き、テストするアプリを選択してください。左メニューにある SDK実装テスト を選択してください。
テストするための3つの選択肢が表示されます。

以下の手順に従って、必要なSDK実装をテストします。

オーガニックインストールのテスト

テスト端末登録済みの端末にてアプリをインストールしてください。
インストールしたアプリを起動します。
アプリ管理画面では、新規のオーガニックインストールが表示されます。

非オーガニックインストールのテスト

Non-Organic Installの下にあるRun testをクリックしてください。
ドロップダウンメニューから予めホワイトリスト登録したテスト端末を選択してください。
アプリをインストールする場所を選択してください。
- Android:
  - Google play
  - その他（out-of-store)
- iOS:
  - App Store
  - XCode
  - TestFlight
ホワイトリスト登録されたテスト端末でQRコードをスキャンし、表示された指示に従ってください。
テストが成功したことを示す、 SDK 実装テスト ページに非オーガニックインストールが記録されるまで待ちます。これには最大2分程度かかります。

時間内に非オーガニックインストールが記録されなかった場合には、 SDK 実装テスト ページにあるトラブルシューティングの箇所を参照してください。

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

In-app eventsの下にあるRun testlをクリックしてください。
ドロップダウンメニューから予めホワイトリスト登録したテスト端末を選択し、Nextをクリックしてください。
アプリを起動し、実装したアプリ内イベントを発火させてください。
これらのイベントはリアルタイムで記録されるため、イベントログが表示されます。

ディープリンクのテスト

ディープリンクをテストするには、アプリのOneLink設定が完了している必要があります。こちらのOneLinkガイド (参照)を確認してください。ディープリンク実装ガイドに概説されているように、SDKディープリンクの実装を強くお勧めします。
"アプリ設定"内でリターゲティング広告測定を有効にするがOnになっていることを確認してください。
Deeplinkingの下にあるRun testをクリックしてください。
ドロップダウンメニューから予めホワイトリスト登録したテスト端末を選択し、Nextをクリックしてください。
Test Typeを選択します。
- OneLink - [OneLinkの選択]ドロップダウンからテストするOneLinkを選択します。
- URIスキーム - テストするURIスキームを指定します。例：greatapps://cars
ホワイトリスト登録されたテスト端末でQRコードをスキャンし、表示された指示に従ってください。
これら2つのテストが完了すると、ディープリンクテストは成功として記録されます。

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

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

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

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

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

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

Androidのテストアプリを作成する

Androidアプリを複製する

Androidプロジェクトフォルダのコピーを作成し、名前を変更する
Androidスタジオで新しくコピーしたプロジェクトを開く
Android Studioでは、パッケージに到達するまでフォルダを展開する
パッケージ名を右クリックし、Refactor を選択してから Renameを選択する
パッケージの名前を変更する
アプリレベル build.gradeで、applicationId を新しいパッケージ名に変更する

AndroidテストアプリをAppsFlyer管理画面に追加する

手順に従って、AppsFlyerの管理画面に新しいアプリを追加します。パッケージ名が、元のアプリのパッケージ名ではなく、新しく作成されたテストアプリのパッケージ名と同じであることを確認してください。また、アプリステータスを 「承認待ち」または「未公開」に設定ください。

新しいテストアプリでテストを実行できるようになりました。

iOSのテストアプリを作成する

iOSアプリを複複製する

ファインダーでプロジェクトフォルダを開く
フォルダを複製する
XCodeで複製プロジェクトを開く
AppDelegate クラスの didFinishLaunchingWithOptions メソッド内で、新しいアプリケーションIDを設定する:
Objective C

Swift

注意

アプリIDは、アプリストアに公開されるとアプリに与えられるIDです。ただし、これはテストアプリであるため、別のアプリで利用されていない限り、任意のIDを指定できます。フォーマットは11111**** にする必要があります。例：111117538

IDは9桁であることを確認してください。5つの1でIDを開始します。残りの数字はランダムでなければなりません。上記のIDの例を参照してください。

AppsFlyerの管理画面にiOSテストアプリを追加する

手順に従って、AppsFlyerの管理画面に新しいアプリを追加します。アプリIDが新しく作成されたテストアプリのアプリIDと同じであることを確認します。また、アプリステータスを 「承認待ち」または「未公開」に設定ください。

新しいテストアプリでテストを実行できるようになりました。

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

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

はじめに：

テストに使用するテスト端末
リアトリビューションをテストするときは、テスト端末から利用するデバイスを削除してください。

アプリがまだ承認待ち（Google PlayやApple Storeに表示されていない）の状態でも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パラメータをAndroidアプリIDに変更します。

c パラメータには、キャンペーンの名前を指定します。
pid パラメータには、インストールが紐づくメディアソースの名前を指定します。

Andoridの場合はGAID (Google Advertising ID)、iOSの場合は IDFA を追加します。

ステップ 2：

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

注意

iOSでは、iMessengerまたはEメールを使用して、デバイスにリンクを送信します。リンクを破損する可能性があるため、リンクをiOS Notesアプリに貼り付けてからクリックしないでください。

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

ステップ 3：

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

より精巧な検証をするためには、インストールローデータレポートをダウンロードください。

AppsFlyer管理画面において、レポート＞ データエクスポート画面に進んでください。
ローデータレポートセクションでインストールローデータをダウンロードください。

詳細については、インストールローデータレポートに関する記事を参照してください。

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

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

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

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

より詳細な確認を行うには、アプリ内イベントのローデータレポートをダウンロードできます。

管理画面で レポートセクションのデータエクスポートをクリックしてください。ローデータレポートセクションからアプリ内イベントのローデータレポートをダウンロードください。

詳細については、アプリ内イベントのローデータレポートに関する記事を参照してください。

OneLinkのテスト

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

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

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

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

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

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

Android iOS
ホワイトリストに登録されていないデバイス

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

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

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

リンクマネジメント画面で、計測リンクをみつけます。
右側のアクションの下の３つの点をクリックします。
リンク詳細を表示をクリックします。
ロングリンクをコピーします。

重要：

リターゲティング（リアトリビューションとリエンゲージメント）をテストするときは、デバイスID（GAIDまたはIDFA）を計測リンクのURLに指定する必要があります。デバイスをテスト端末登録するときに、デバイスIDを取得できます。

最終的に生成される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>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Androidのデバッグ

SDKをデバッグすると、アプリの実装状況を詳しく見ることができます。デバッグは、アプリ内イベント計測、コンバージョンデータ、購入検証などの問題解決に役立ちます。

Android SDKのデバッグモードを有効にする

Android SDKのデバッグを開始するには、AFApplicationクラスに次の行を追加します。:

AppsFlyerLib.getInstance().setDebugLog(true);

重要！

デバッグは開発段階時のみに限定する必要があります。デバッグを有効にしたまま、アプリをアプリストアに公開しないように注意ください。これは、重大なセキュリティとプライバシーのリスクをもたらします。

デバッグ出力の確認方法

デバッグ出力を表示するには、AndroidスタジオでLogcat terminal を開きます。デバッグ可能なプロセスとしてアプリのパッケージ名を選択し、ログレベルをDebugに設定し、 "AppsFlyer_"でフィルタします。

Android SDKのよくある問題

インストールが常にオーガニックとして計測される

状況

計測リンクを使用したテストをしています。SDKコンバージョンリスナーを実装しましたが、ログではインストールが全てオーガニックであると表示されます。管理画面上でも非オーガニックインストールが記録されていません。

よくあるエラー要因

DevKeyが正しくありません。正しくないDevKeyを利用すると、インストールは計測されません。
利用している計測リンクが間違っています。計測リンクに関するガイドを参照ください。
テストしている端末がホワイトリストされていることをご確認ください。
マニフェストに不適切なチャネルが定義されていないか確認してください。

インストールが検出されなかった、または計測されなかった

状況

インストールテスト行ったが、ログにはインストールタイプや初回起動などのインストールに関するデータが表示されない。

よくあるエラー要因

startTrackingとinitメソッドが AFApplicationクラスで呼び出されていることを確認してください。
テストしている端末がホワイトリストされていることをご確認ください。

次の行を追加ください：

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

モジュール（アプリ）レベルのbuild.gradleファイル

iOSのデバッグ

iOS SDKのデバッグモードを有効にする

iOS SDKのデバッグを開始するには、didFinishLaunchingWithOptions メソッドに次の行を追加します：

AppDelegate.mに次の行を追加します：

[AppsFlyerTracker sharedTracker].isDebug = true;

AppDelegate.swiftに次の行を追加します：

AppsFlyerTracker.shared().isDebug = true

重要！

デバッグは開発段階にのみ実施ください。デバッグを有効にしたまま、アプリストアでアプリを公開しないでください。これは、重大なセキュリティとプライバシーのリスクをもたらします。

デバッグ出力の確認方法

デバッグ出力を表示するには、XCodeでデバッグターミナルを開き、 "AppsFlyer"でフィルタします。

iOS SDKのよくある問題

インストールとアプリ内イベントが計測されない

インストールとアプリ内イベントが計測されない理由はいくつかあります：

間違ったフォーマットで指定すると、インストールとイベントは計測されません。delegateファイルにアプリIDを設定するときに、数字のみで構成されたアプリIDであることをご確認ください。

AppsFlyer管理画面のアプリ設定画面にて、dev keyを取得できます。

正しいフォーマット：

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

間違ったフォーマット：

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

間違ったフォーマット：

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

アプリIDのフォーマットが間違っている場合、ログに次のエラーが表示されます：

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

アカウントに存在しないアプリIDを指定すると、インストールとイベントは計測されません。ログには次のエラーが表示されます：

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

404エラーは、SDKがアカウント内でアプリを見つけつることができなかったことを示します。

正しくないdev keyを設定すると、インストールやアプリ内イベントは記録されません。ログには次のエラーが表示されます：

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

400エラーは、インストールやイベントを計測するためのリクエストをSDKで認証できないことを示します。正しいdev keyを設定しているかご確認ください。dev keyは英数字のみで構成されています。

アプリIDとDevKeyは正しいが、インストールが計測されない

状況

正しいアプリIDとDevKeyがアプリに設定されていますが、インストールが計測できません。

よくあるエラー要因

SDKの初期化が正しく行われていません。applicationDidBecomeActivでtrackAppLaunchメソッドを呼び出すようにしてください：

- (void)applicationDidBecomeActive:(UIApplication *)application { 
	[[AppsFlyerTracker sharedTracker] trackAppLaunch]; 
}

func applicationDidBecomeActive(application: UIApplication) { 
	AppsFlyerTracker.shared().trackAppLaunch() 
}

ログに"AppsFlyer dev key missing or empty. aborting”と表示される

状況

ログ内でインストールとアプリ内イベントのテストを試みましたが、ログに"AppsFlyer dev key missing or empty. Aborting”と表示されます。

よくあるエラー要因

dev keyが設定されていません。app DelegateのdidFinishLaunchingWithOptionsメソッド内で必ず設定ください：

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

AppsFlyerTracker.shared().appsFlyerDevKey = "YOUR_DEV_KEY"

インストールが常にオーガニックとして計測される

状況

よくあるエラー要因

利用している計測リンクが間違っています。計測リンクに関するガイドを参照ください。
テストしている端末がホワイトリストされていることをご確認ください。

収益が正しく計測できていない

状況

収益値を含むアプリ内イベントのテストをしています。イベントは管理画面に表示されますが、収益値は計測されません。

よくあるエラー要因

インストールまたはイベント計測で404エラーが表示される

状況

インストールやアプリ内イベントが正しいメディアソースにアトリビュートされるかテストしようとしています。しかし、インストールもアプリ内イベントも404エラーが表示されます。インストールもアプリ内イベントも管理画面に表示されません。

よくあるエラー要因

404エラーは、アプリIDが正しくないことを示します。インストールとイベントが計測されませんを参照ください。

インストールまたはアプリ内イベントのテストをすると400エラーになる

状況

ログ内のアプリ内イベントをテストしようとしています。イベントをトリガーすると、ログに400エラーが表示されます。

よくあるエラー要因

dev keyに問題がある可能性がございます。正しいdev keyを設定しているかご確認ください。dev keyは英数字のみで構成されています。インストールとイベントが計測されませんを参照ください。

Unityのデバッグ

Unityのデバッグモードを有効にする

Unity SDKのデバッグをするには、AF GameObject内のstartメソッドに次の行を追加ください：

AppsFlyer.setIsDebug (true);

重要！

デバッグ出力の確認方法

デバッグ出力はAndroid StudioまたはXCodeで行えます。

Unity SDKのよくある問題

UnityはAndroidアプリもiOSアプリも作成できます。プラットフォーム毎のよくある問題については以下を参照ください：

Android SDKのよくある問題
iOS SDKのよくある問題

注意

SDK 実装のテストとデバッグが完了したら、SDK logsをオフにしてください。