Show Menu
トピック×

V3 による獲得のテスト

この情報は、Android デバイスでバージョン 3 の獲得キャンペーンリンクをラウンドトリップする場合に役立ちます。
V3 での獲得とは、Adobe Mobile Services UI でダウンロード計測ビルダーを使用して作成したダウンロード計測用リンクを指します。この機能を使用するには、Experience Cloud ソリューション 4.6.0 以降用の Android SDK 4.x にアップグレードする必要があります。
モバイルアプリがまだ Google Play に登録されていない場合は、マーケティングリンクを作成するときに任意のモバイルアプリをリンク先として選択できます。これは、ダウンロード計測用リンクのクリック後に獲得サーバーによってリダイレクトされるアプリにのみ影響を与えます。リンクのテスト機能には影響を与えません。クエリ文字列パラメーターは、Google Play ストアに渡されます。これらのパラメーターは、キャンペーンのブロードキャストの一環としてインストール時にアプリに渡されます。モバイルアプリでの獲得のラウンドトリップテストには、このタイプのブロードキャストのシミュレーションが必要です。
テストを実行するたびに、アプリを新しくインストールするか、アプリのデータを​ 設定 ​でクリアする必要があります。そうすることで、アプリが最初に起動したときに、キャンペーンクエリ文字列パラメーターに関連付けられている初期ライフサイクル指標が送信されます。
  1. モバイルアプリの獲得 」の前提条件のタスクを実行し、 INSTALL_REFERRER のブロードキャストレシーバーが正しく実装されていることを確認します。
  2. Adobe Mobile Services UI で、 獲得 マーケティングリンクビルダー ​をクリックし、Google Play を Android デバイスのリンク先として設定する獲得マーケティングリンク URL を生成します。
    詳しくは、 マーケティングリンクビルダー を参照してください。
    例: https://c00.adobe.com/v3/<appid>/start?a_i_id=iostestapp&a_g_id=com.adobe.android&a_dd=g&ctxa.referrer.campaign.name=name&ctxa.referrer.campaign.trackingcode=trackingcode
    ダウンロード計測用リンクで Android アプリと iOS アプリの両方を参照する場合、Google Play をデフォルトのストアとして使用します。
  3. デスクトップのブラウザーで、生成されたリンクを開きます。
    次の例のような URL のページにリダイレクトされます。 https://play.google.com/store/apps/details?id=com.adobe.android&referrer=utm_campaign%3Dadb_acq_v3%26utm_source%3Dadb_acq_v3%26utm_content%3D91b52ce097b1464b9b47cb2995c493cc6ab2c3a3
  4. utm_content%3D の後ろにある一意の ID をコピーします。
    前の例では、ID 91b52ce097b1464b9b47cb2995c493cc6ab2c3a3 です。
  5. 手順 3 の一意の ID を使用して、次の形式の獲得エンドリンクを作成します。
    https://c00.adobe.com/v3/<appid>/end?a_ugid=<unique id>
    例: https://c00.adobe.com/v3/<appid>/end?a_ugid=91b52ce097b1464b9b47cb2995c493cc6ab2c3a3
  6. デスクトップのブラウザーでリンクを開きます。
    JSON 応答に contextData が表示されます。
    {"fingerprint":"228d7e6058b1d731dc7a8b8bd0c15e1d78242f31","timestamp":1457989293,"appguid":"","contextData":{"a.referrer.campaign.name":"name","a.referrer.campaign.trackingcode":"trackingcode"}}.
    contextData が表示されない場合、または文字列の一部が表示されない場合、獲得 URL が、 手作業によるダウンロード計測用リンクの作成 の形式に従っていることを確認します。
  7. 手順 3 を繰り返して、新しい一意の ID を取得します。
  8. 設定ファイルの次の設定が正しいことを確認します。
    設定
    acquisition
    サーバーは c00.adobe.com である必要があります。また、** appid がダウンロード計測用リンクの appid と同じである必要があります。
    analytics
    テストのために、ブロードキャストを手動で送信するのに十分な時間(60 秒以上)に送信タイムアウトを設定します。テスト後に元のタイムアウト設定に復元できます。
  9. デバイスをコンピューターに接続し、アプリをアンインストールしてからインストールし直します。
  10. ADB Shell を起動し、デバイスでアプリケーションを起動します。
  11. 次の adb コマンドを使用して、ブロードキャストを送信します。
    am broadcast -a com.android.vending.INSTALL_REFERRER -n com.adobe.android/com.adobe.android.YourBroadcastReceiver --es "referrer" "utm_source=adb_acq_v3&utm_campaign=adb_acq_v3&utm_content=<unique id get on step 5>"
  12. 次の手順を完了します。
    1. com.adobe.android をアプリケーションのパッケージ名に置き換えます。
    2. 受信者リファレンスを、アプリ内のキャンペーン追跡受信者の場所の受信者リファレンスに更新します。
    3. utm_content に関連付けられた値を置き換えます。 ブロードキャストが成功すると、次の例のような応答が返されます。
    Broadcasting: Intent { act=com.android.vending.INSTALL_REFERRER cmp=com.adobe.adms.tests/.ReferralReceiver (has extras) } Broadcast completed: result=0
  13. (オプション)SDK のデバッグログを有効にして、追加の情報を取得することができます。
    すべて正しく機能していれば、ログは次のようになります。
"Analytics - Received referrer information(<referrer content>)" "Analytics - Trying to fetch referrer data from (acquisition end url)"; "Analytics - Received Referrer Data(<A JSON Response>)"
これらのログが表示されない場合は、手順 6 ~ 12 が完了していることを確認してください。
次の表には、考えられるエラーに関する追加の情報を示します。
エラー
説明
Analytics - Unable to decode response( String ).
応答の形式が正しくありません。
Analytics - Unable to parse response ( a JSON Response ).
JSON 文字列の形式が正しくありません。
Analytics - Unable to parse acquisition service response (no contextData parameter in response).
応答に contextData パラメーターがありません。
Analytics - Acquisition referrer data was not complete (no a.referrer.campaign.name in context data), ignoring.
contextData に a.referrer.campaign.name が含まれていません。
Analytics - Acquisition referrer timed out.
referrerTimeout で定義された時間内に応答を取得できませんでした。値を増やしてもう一度試してください。また、アプリのインストール前にダウンロード計測用リンクを開いたことも確認してください。
次の情報に留意してください。
  • アプリから送信されたヒットを監視するには、HTTP 監視ツールを使用して、獲得アトリビューションを確認します。
  • INSTALL_REFERRER のブロードキャスト方法について詳しくは、Google Developers ガイドの Google Play キャンペーン測定のテスト を参照してください。
  • Android 4.8.2 での獲得に関して、バグの修正がリリースされました。
    テストをおこなう前に、SDK を最新バージョンにアップグレードしてください。
  • アドビが提供する acquisitionTest.jar Java ツールを使用して、一意の ID を取得し、インストールリファラーをブロードキャストできます。そのため、手順 3 ~ 12 における情報の取得に役立ちます。
    Java ツールのインストール
この Java ツールをインストールするには:
  1. acquisitionTester.zip ファイルをダウンロードします。
  2. .jar ファイルを抽出します。
    コマンドラインでファイルを実行できます。
    以下に例を示します。
    java -jar acquisitionTester.jar -a com.adobe.test -r com.adobe.test.ReferrerReceiver -l "https://c00.adobe.com/v3/appid/start?a_i_id=123456&a_g_id=com.adobe.test&a_dd=i&ctxa.referrer.campaign.name=name&ctxa.referrer.campaign.trackingcode=1234