AppsFlyer Android SDK実装とリターゲティングのテスト方法 - Testing AppsFlyer’s Android SDK Integration and Re-Targeting

 AppsFlyer Android SDKバージョン4.4.0以上の場合のみ

AppsFlyerではAndroid SDKがアプリに正しく実装されているかをテストするためのシンプルなツールを提供しています。

Android SDK実装テストアプリを使うことで、プロジェクト内の実装ミスを確認し、非オーガニックインストールを管理画面で確認するためのクリック・インストールの自動テストを実施することができます(アプリ公開前後にテストが可能です)。

SDKテストアプリをダウンロード

この記事では以下の内容について説明しています。

  1. アプリ概要と設定のテスト
  2. 非オーガニックインストールのテスト
  3. リターゲティングアトリビューションのテスト
  4. SDK実装エラーの識別

アプリ概要と設定のテスト

  1. AppsFlyerのAndroid SDKをアプリに実装し、端末にインストールします。
  2. Google Playからテストアプリをダウンロードし、アプリを開きます。
    以下の画面が表示されます:


  3. をクリックして、テスト端末のホワイトリストパラメータ値(IMEI、Android ID、Google Advertising ID)を表示します。
  4. Send Valuesをクリックして、値をメールで送信します。
    これらの値はアカウントのホワイトリストページに登録されます。ホワイトリストへ登録済みの端末でSDKテストアプリを実施するようにして下さい。
  5. アプリのパッケージ名またはアプリ名を検索バーに入力します(例: android.appsflyer.sampleappまたは「Sample App」)。
  6. Start Testingをクリックし、選択したアプリのテストを開始します。

 

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

テストの実行が完了し、実装にエラーが無い場合は、以下の画面が表示されます:

このテストの結果、これは公開前、公開後のアプリにてリファラブロードキャストがシュミレートされます。Play Storeに公開済みの場合は、アトリビューションはPlay Storeリファラを用いて行われ、公開前の場合は、デバイスIDマッチにより行われます。

  1. AppsFlyer管理画面のオーバービュー画面を開きます。
  2. メディアソース:AppsFlyer_Testを検索します。

このメディアソースから非オーガニックインストールが管理画面に表示されます。

これでSDK導入は完了で、広告配信を開始できます!

 

リターゲティングアトリビューションのテスト方法

インストールアトリビューションに加え、このテストアプリはリターゲティングとディープリンクのテストも可能です。

Re-Targeting Testを実施する前に、Integration Test を最低1回実施していることを確認してください。

  1. ホームページにてRe-Targeting Testをクリックします。

以下の画面が表示されます:

  1. アプリのディープリンクschemehost(AndroidManifestの設定の通りに)を入力します。「Http://」チェックボックスをクリックし、検索バーに「http://」を追加します。
  2. schemeが見つかったら、テストアプリにてディープリンクアクティビティへリダイレクトされるトラッキングリンクが生成されます。

ディープリンクのアクティビティが「AppsFlyerLib.getInstance().getDeepLinkData(this)」を含む場合は、テストアプリは以下の画面を表示します:

 注記:テストアプリは、試行をタイムアウトするまでに6秒間待ちます。よって、インターネット接続が遅いと、テストが失敗する可能性があります。

管理画面上でRe-Engagementアトリビューションを計測テストが可能です。正確にテストをするために、管理画面上でリターゲティングが有効になっており、リターゲティングテスト以前にアプリが最低でも3回起動されていることを確認してください。

テストが成功すると、Re-EngagementアトリビューションがメディアソースAppsFlyer_Test、キャンペーン名Testから以下のコンバージョンが確認できます。

 

SDKの実装エラーを識別する

テストアプリを使うことで、一般的なSDK実装エラーを素早く識別することができます。

AppsFlyerのBroadcastReceiverを直接使っていず、カスタムBroadcastReceiverを使っている場合は、以下の警告メッセージが表示されます:

カスタムBroadcastReceiverを使っていないにもかかわらず上記エラーが表示される場合は、実装ガイドに従ってレシーバーを実装してください。

実装エラーがある場合は以下のエラーメッセージが表示されます:
注記:エラーメッセージはエラー詳細によって異なります。

エラーが表示される場合は、プロジェクト内で修正後、再度ビルドをしてテストを実施してください。

エラー

以下がエラーメッセージと解決策の一覧です。

エラー# 

エラーメッセージ

原因/解決策

1

This app cannot be monitored. Please make sure you are using a supported AppsFlyer SDK version

(このアプリはテストできません。対応しているAppsFlyer SDKバージョンを実装しているか確認してください)

テストアプリに対応していないSDKバージョン:

4.3.9以下、4.6.1, 4.6.3, 4.6.4

2

Your_PackageName is not installed

(このパッケージ名のアプリがインストールされていません)

SDK実装済みのアプリをインストールし再度テストを実施してください。

3

android.permission.INTERNET is missing from the AndroidManifest.xml

(android.permission.INTERNET がAndroidManifest.xmlに含まれていません)

Internet permissionをアプリのmanifestに追加してください。これがないとSDKは機能しません。

4

Please make sure you have added your app to the AppsFlyer's dashboard

(AppsFlyer管理画面にアプリが追加されているか確認してください)

パッケージ名(アプリ)をAppsFlyer管理画面へ追加してください。

5

AppsFlyer’s BroadcastReceiver is missing from the AndroidManifest.xml

(AppsFlyerのBroadcastReceiverがAndroidManifest.xmlに含まれていません)

アプリでリファラーが取得できません(公開前のアプリにもこのエラーは適用されます)。BroadcastReceiverが正確に実装されているか確認してください。

6

Google Services is not integrated correctly

(Google Servicesが正確に実装されていません)

アプリでAdvertising IDが取得できていません。計測に影響がでる可能性がありますので、アプリにGoogle Play Servicesが実装できているか確認してください。

7

Dev Key could not be verified. Please check your dashboard for your account’s Dev Key

(Dev Keyが検証できませんでした。正しいDev Keyを管理画面上で確認してください)

正しいDev Keyが設定されていることを確認してください。管理画面の「SDKインテグレーション」ページにて正しいDev Keyが確認できます。

8

This app can not be monitored. Please make sure that you have and active internet connection, and that sendDeepLinkData() is presend in your deeplinked activity

(このアプリはテストできません。インターネットに接続されていること、sendDeepLinkData()がディープリンクアクティビティに設定されていることを確認してください)

アプリがブラウザ経由で起動され、インターネット接続が悪いためテストがタイムアウトした可能性があります。

Activity内で「sendDeepLinkData()」を使用していない場合は、ディープリンク経由の起動は計測ができません。

古いSDKバージョンを使っている場合は、古いテストアプリを使ってください。詳細はこちらをご確認ください。

この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています
他にご質問がございましたら、リクエストを送信してください
Powered by Zendesk