マーケティングリンクによる獲得のテスト

この手順は、Android デバイスでマーケティングリンクを使用して獲得キャンペーンをラウンドトリップする場合に役立ちます。

モバイルアプリがまだ Google Play に登録されていない場合は、マーケティングリンクを作成するときに任意のモバイルアプリをリンク先として選択できます。これは、ダウンロード計測用リンクのクリック後に獲得サーバーによってリダイレクトされるアプリにのみ影響を与えます。ダウンロード計測用リンクのテスト機能には影響を与えません。クエリ文字列パラメーターは、Google Play ストアに渡され、キャンペーンブロードキャストの一環としてインストール時にアプリに渡されます。ラウンドトリップモバイルアプリの獲得テストでは、このタイプのブロードキャストのシミュレーションが必要です。

テストを実行するたびに、アプリを新しくインストールするか、アプリのデータを​設定​でクリアする必要があります。そうすることで、アプリが最初に起動したときに、キャンペーンクエリ文字列パラメーターに関連付けられている初期ライフサイクル指標が送信されます。

  1. モバイルアプリの獲得」の前提条件のタスクを実行し、INSTALL_REFERRER のブロードキャストレシーバーが正しく実装されていることを確認します。

  2. Adobe Mobile Services UI で、獲得マーケティングリンクビルダー​をクリックし、Google Play を Android デバイスのリンク先として設定する獲得マーケティングリンク URL を生成します。

    詳しくは、マーケティングリンクビルダーを参照してください。

    以下に例を示します。

    https://c00.adobe.com/v3/da120731d6c09658b82d8fac78da1d5fc2d09c48e21b3a55f9e2d7344e08425d/start?a_dl=573e5bb3248a501360c2890b

  3. 生成されたリンクを Android デバイスで開きます。

    次の例のような 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 です。

    デバイスで一意の ID を取得できない場合、デスクトップで次の CURL コマンドを実行して、応答文字列から一意の ID を取得します。

    curl -A "Mozilla/5.0 (Linux; Android 5.0.2; SAMSUNG SM-T815Y Build/LRX22G) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/44.0.2403.133 Safari/537.36" <Your Marketing Link>

    以下に例を示します。

    curl -A "Mozilla/5.0 (Linux; Android 5.0.2; SAMSUNG SM-T815Y Build/LRX22G) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/44.0.2403.133 Safari/537.36" https://c00.adobe.com/v3/da120731d6c09658b82d8fac78da1d5fc2d09c48e21b3a55f9e2d7344e08425d/start?a_dl=573e5bb3248a501360c2890b

  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":"44b2f88a062df7e727c047f006deb9971304617b","endCallbacks":["***"],"timestamp":1464301282,"appguid":"da120731d6c09658b82d8fac78da1d5fc2d09c48e21b3a55f9e2d7344e08425d","contextData": 
    {"a.launch.campaign.trackingcode":"trymttvm","a.referrer.campaign.name":"Android Demo","a.referrer.campaign.trackingcode":"trymttvm"} 
    ,"adobeData":{"unique_id":"9a2be52764a8db125c29a8c10f3b1b3d5d8ed915","deeplinkid":"57476c26072932ec6d3a470b"}}.
    
  7. 手順 3 を繰り返して、新しい一意の ID を取得します。

  8. 設定ファイルの次の設定が正しいことを確認します。

    設定
    acquisition サーバーは c00.adobe.com で、appid がダウンロード計測用リンクの appid と同じである必要があります。
    analytics テストの目的で、転送者のタイムアウトを設定し、適切な時間(60 秒以上)を経てブロードキャストが手動で送信されるようにします。テスト後に、元のタイムアウト設定に戻すことができます。
  9. デバイスをコンピューターに接続し、アプリをアンインストールしてからインストールし直します。

  10. ADB Shell を起動し、デバイスでアプリケーションを起動します。

    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. com.adobe.android をアプリケーションのパッケージ名に置き換え、受信者リファレンスをアプリ内のキャンペーン追跡受信者の場所のリファレンスに更新します。また、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 ~ 10 を実行したことを確認してください。

    次の表に、考えられるエラーに関する追加情報を示します。

    エラー 説明
    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 キャンペーン測定のテストを参照してください。
  • アドビが提供する acquisitionTest.jar Java ツールを使用して、一意の ID を取得し、インストールリファラーをブロードキャストできます。そのため、手順 3 ~ 10 における情報の取得に役立ちます。

Java ツールのインストール

この Java ツールをインストールするには:

  1. acquistionTester.zip ファイルをダウンロードします。

  2. .jar ファイルを展開します。

    コマンドラインで .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

マーケティングリンクはサーバー側にキャッシュされ、有効期間は 10 分です。マーケティングリストに変更を加えた場合は、リンクを再度使用する前に、変更が適用されるまで約 10 分間待ってください。

このページ