Test mobile SDK integration with the app – ヘルプセンター

At a glance: Test your Android/iOS app integration with AppsFlyer.

SDK実装テストとデバッグ

Test SDK integration before submitting an app to the app store. In this article, SDK refers to both the AppsFlyer iOS and Android SDKs.

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

Smart TV: The SDK is compatible with Android-based Smart TVs and Apple TV (tvOS). Test smart TV apps using the instruction in this guide.
Unpublished tvOS apps: see Testing tvOS integration before publishing.
Amazon Fire TV: see Testing alternate Android stores.

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

Carefully tested integration ensures accurate and comprehensive data collection. By testing the SDK integration, you ensure that installs and in-app events are recorded and attributed correctly.

SDK実装テストとデバッグ

Use one of the following methods to test and debug SDK integration:

Basic testing:
- Testing the integration using attribution links
- The AppsFlyer attribution model utilizes attribution links. Conducting tests using attribution links is recommended.
- When you test SDK integration using attribution links you get an in-depth insight into the AppsFlyer attribution model. This gives you the opportunity to optimize your marketing operation and analysis.
Advanced testing:
- Debugging directly from the development environment.
- The SDK integration test section only tests a limited set of features. Test the following in the development environment using the debug log:
  - Purchase validation
  - Conversion data
  - Errors in SDK setup. You can test these in the development environment with the help of the debug log.

Related reading for ad networks: Ad network integration testing.

Using the SDK Integration Tests page, to locate integration issues in your project. Use it to test installs, in-app events, and deep linking.

SDK実装のテスト

To test SDK integration:

Prepare a device (iOS or Android) that does not have the app installed. If needed uninstall (delete) the app from the device.
Register the device as a test device. Note! iOS: If you use TestFlight to install the app, there is no need to register the device.
In AppsFlyer, select the app.
Go to Integration > SDK Integration Tests.
The SDK integration tests page opens.
Select a testing option:
- Non-organic installs
- In-app events
- Deep linking
Use the testing procedure that follows according to the selected test type.

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

Install the app on a registered test device.
Launch the app.
The app dashboard displays a new organic install.

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

Select Non-Organic Install.
Select a listed device.
Select the app source:
- Android:
  - Google play
  - その他（out-of-store)
- iOS:
  - App Store
  - XCode
  - TestFlight
Scan the QR code with the registered test device and follow the instructions on the device.
Wait until the non-organic install is registered in the SDK Integration Tests page indicating the test is successful. This can take up to 2 minutes.

If the app does not record a non-organic install by that time, refer to the troubleshooting section that appears in the SDK Integration Tests page.

To test LAT installs:

Enable LAT mode on your device.
Perform a non-organic install test.

To test no ATT consent (without IDFA) installs:

In the ATT consent dialog, click Ask App Not to Track.
Perform a non-organic install test.

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

In-app eventsの下にあるRun testlをクリックしてください。
Select a registered test devices from the drop-down menu, click Next.
アプリを起動し、実装したアプリ内イベントを発火させてください。
You will see a log of these events as they are registered in real-time.

ディープリンクのテスト

ディープリンクをテストするには、アプリのOneLink設定が完了している必要があります。こちらのOneLinkガイドを確認してください。ディープリンク実装ガイドでも解説されているように、SDKのディープリンク実装を強くお勧めします。
"アプリ設定"内でリターゲティング広告測定を有効にするがOnになっていることを確認してください。
Deeplinkingの下にあるRun testをクリックしてください。
Select a registered test device from the drop-down menu and click Next.
Test Typeを選択します。
- OneLink - [OneLinkの選択]ドロップダウンからテストするOneLinkを選択します。
- URI scheme - specify the URI scheme that you want to test. For example, greatapps://cars.
Scan the QR code with your registered test device and follow the instructions on your device.
これら2つのテストが完了すると、ディープリンクテストは成功として記録されます。

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

When performing tests using attribution links, data is recorded in the app dashboard. Once data is recorded, it can't be deleted. If you don't want test data to be recorded as part of a real app, you can test the SDK integration using debug apps.

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

Debug apps are exact copies of apps that are published in the app stores. By running SDK integration tests on debug apps, you don't pollute real data with test data.

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

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

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

Androidアプリを複製する

Androidプロジェクトフォルダのコピーを作成し、名前を変更する
Androidスタジオで新しくコピーしたプロジェクトを開く
Android Studioでは、パッケージに到達するまでフォルダを展開する
Right-click on the package name, choose Refactor and then Rename
パッケージの名前を変更する
In the app level build.grade change the applicationId to the new package name

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と同じであることを確認してください。また、アプリステータスは 「承認待ち」または「未公開」に設定してください。

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

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

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

はじめに：

Register devices that you use for testing
When testing re-attributions, make sure to remove the registered device from the allowlist.
If you are testing attribution of apps available vai third-party Android app stores you must set the af_r parameter on the attribution link to reference the specific app store.

You can test the SDK integration even if the app is still pending (meaning, not listed in Google Play or Apple Store)

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

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

インストールのテストでは、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>

Change the app_id parameter to your app id (including the id prefix. For example: id0123456789).

c パラメータには、キャンペーンの名前を指定します。
pid パラメータには、インストールが紐づくメディアソースの名前を指定します。
If you are testing an app available via a third-party Android store: add the af_r parameter to the attribution link.

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

ステップ 2：

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

注意

In iOS, use iMessage or email to send the link to the device. Don't paste the link in the iOS Notes app and then click on it because it might break the link.

アプリが公開されている場合は、インストールに進みます。
If the app is pending, install the app from your development environment:
-- For Android - install from Android Studio or ADB shell
-- For iOS - install from XCode

ステップ 3：

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

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

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

Refer to our article about installation raw data report for more information.

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

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

After installing the app using the attribution link, trigger a few in-app events. Allow up to two minutes for the events to appear in the dashboard. Open the app's dashboard and go to Events in the left-hand side menu.

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

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

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

Refer to our article about in-app events raw data report for more information.

OneLinkのテスト

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

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

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

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

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

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

Android iOS
A non-registered device

Testing retargeting is straightforward. Create a custom attribution link out of a OneLink template. Make sure to toggle on Re-Targeting Campaign.

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

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

In the Link Management page, locate the attribution link.
In the right-hand side, click the three dots under Actions.
Click View Link Details.
Copy the Long Link.

重要：

When testing retargeting (re-attribution and re-engagement), the advertising ID must be specified in the attribution link URL.
Retargeting reinstalls (AKA reattribution) can't be tested using registered test devices. Meaning, user devices which are listed in the test device list. You can use any other device for this purpose.
To view GAID or IDFA, follow the instructions in the registering a test device article. Note!

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

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

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

Make sure your test device in NOT registered
アプリがインストールされたばかりの場合は、数分お待ちください。
デバイスからアプリをアンインストールします。
インストール計測をするために、上記の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_"でフィルタします。

Troubleshooting common issues with Android SDK

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

状況

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

よくあるエラー要因

DevKeyが正しくありません。正しくないDevKeyを利用すると、インストールは計測されません。
the attribution link you are using is incorrect. Refer to our guide on attribution links.
Make sure that the device you are testing on is registered.
マニフェストに不適切なチャネルが定義されていないか確認してください。

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

状況

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

よくあるエラー要因

startTrackingとinitメソッドが AFApplicationクラスで呼び出されていることを確認してください。
Make sure that the device you are testing on is registered.

次の行を追加ください：

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

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

インストール / アプリ内イベントのテストをすると、403のエラーレスポンスを受け取ってしまう

状況

log内でインストールやアプリ内イベントのテストを行おうとしている場合、log内でそれらのイベントを発火させると403のエラーレスポンス(forbidden/禁止)が表示されます。

よくあるエラー要因

このエラーは、インプレション数とクリック数のみを計測し、その後のアトリビューション情報の計測をプランに含んでいない、ゼロパッケージを使用されている場合に起こる可能性があります。アトリビューションデータの受け取りを開始するには、様々なAppsFlyerのパッケージプランの詳細を確認し、必要に応じてパッケージを更新してください。パッケージプランに関するご質問がある場合には、、お気軽に弊社カスタマーエンゲージメントチーム：hello@appsflyer.com までお問い合わせください。

iOSのデバッグ

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

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

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

[AppsFlyerLib shared].isDebug = true;

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

AppsFlyerLib.shared().isDebug = true

重要！

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

デバッグ出力の確認方法

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

Troubleshooting common issues with 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がアプリに設定されていますが、インストールが計測できません。

よくあるエラー要因

The SDK is not initiated correctly. Make sure to call trackAppLaunch method in applicationDidBecomeActive:

- (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"

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

状況

よくあるエラー要因

the attribution link you are using is incorrect. Refer to our guide on attribution links.
Make sure that the device you are testing on is registered.

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

状況

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

よくあるエラー要因

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

状況

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

よくあるエラー要因

A 404 response indicates that the app ID is incorrect. Refer to Installs and Events are not recorded.

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

状況

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

よくあるエラー要因

This might indicate an issue with the dev key. Check that the dev key is the correct one. Also, make sure that the dev key contains only alphanumeric characters. Refer to Installs and Events are not recorded.

インストール / アプリ内イベントのテストをすると、403のエラーレスポンスを受け取ってしまう

状況

よくあるエラー要因

Unityのデバッグ

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

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

AppsFlyer.setIsDebug (true);

重要！

デバッグ出力の確認方法

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

Troubleshooting common issues with Unity SDK

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

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

注意

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