サードパーティーストアにリリースされているアプリ計測
Adjustでは、Androidのブロードキャスト機能を使用するか、Adjust SDKで設定された事前定義済みのトラッカーURLを使用して、サードパーティストアからのインストールを計測することができます。いずれの方法でも、Adjust管理画面のレポートにこれらのキャンペーンを表示し、サードパーティストアにコールバックデータを自動的に送信することが可能です。アプリの設定方法については、以下をご覧ください。

Androidのリファラーを使用したサードパーティのインストールの計測

サードパーティーストアからのインストールを計測するには、Androidのinstall_referrerインテントを利用する必要があります。(このインテントは、GoogleがAdjust SDKにGoogle Playストアからのアプリのインストールを通知する際にも使用されます)。サードパーティーストア側でこのインテントが正しく設定されていると、アプリのインストール時にインテントが発火されます。アプリがこのインテントを受け取っていることを確認するだけです。

Adjustアカウント管理者の場合

  1. 開発者がAdjust SDKのブロードキャストレシーバーを設定し、INSTALL_REFERRERインテントが受信できることを確認してください。
  2. サードパーティに管理画面へのアクセス権を付与し、トラッカーの作成、またはトラッカーURLの作成や共有が行えるようにします。

 INSTALL_REFERRER ブロードキャストレシーバーが実装され、アプリとトラッカーURLがサードパーティのアプリストアに送信されると、Adjustがインストール情報の受信とAdjust管理画面でのレポートを開始します。キャンペーン構造データは、インテントに含まれるソースおよびキャンペーン情報の下にレポートされます。

サードパーティストア向けの手順

クライアントから必要なトラッカー情報を受け取ったら、サードパーティストアのアプリに以下のような設定を行います。

  1. アプリのインストールを認識できるようにストアを準備します。認識させるには、例えば次のような方法があります。
    • INSTALL_REFERRERのためにブロードキャストレシーバーを実装する
    • インストールを検出できるサードパーティストアアプリを使う
  2. INSTALL_REFERRERインテントのブロードキャストを設定する(下記参照)。
 INSTALL_REFERRERが実装されると、Adjustではインストール情報の受信とAdjust管理画面でのレポートが可能になります。またAdjustは、リファラー内で指定されたエンドポイントにソースおよびキャンペーン情報のコールバックを送信します(以下の例を参照)。

必須パラメーターと任意パラメーターについて

INSTALL_REFERRERインテントでAdjustの重要な情報を転送することにより、アトリビューションデータを適切に分類することが可能になります。ここにはインストールソース(adjust_store)とAdjustトラッカートークンを含める必要があります。また、最大3つのサブレベルまでキャンペーン情報を含めることができます(以下の例を参照)。

サードパーティストアおよびネットワークに対する重要な注意事項

  • referrer=以降の情報はエンコードする必要があります。
  • リファラーに含まれるコールバックURLは、二重にエンコードする必要があります。

必須パラメーター

パラメーター
utm_sourceadjust_store
adjust_trackerAdjustトラッカートークン(abc123など)

:この例では、最も短いトラッカートークンを使用しています。
Adjust管理画面上のキャンペーンウィザードに表示されたトラッカートークン全体を必ず使用してください。

キャンペーンパラメーター(任意)

パラメーター
adjust_campaigncampaign_name
adjust_adgroupadgroup_name
adjust_creativecreative_name

コールバックパラメーター(任意)

パラメーター
adjust_install_callback
adjust_event_callback_123456
adjust_session_callback
adjust_rejected_install_callback
adjust_reattribution_callback

リファラーインテントの例

referrer=adjust_tracker%3Dabc123%26adjust_campaign%3DChristmasCamp59_ChristmasCampId330%26adjust_adgroup%3DAppId48399_SubID%26adjust_creative%3DCreative9383_SubId%26utm_source%3Dadjust_store&adjust_install_callback=www.3rdpartydomain.com%253Fsrc%253Dadjust%2526advertiserId%253D57638%2526password%253D4d13c4dc
:このリファラーインテントには、二重にエンコードされたコールバックが含まれています。

事前定義済みのトラッカーURLを使用したサードパーティのインストールの計測

はじめに、Adjust管理画面でトラッカーURLを作成してください。

手順

Adjust管理画面にて

  1. アプリに移動して、アプリオプションの (▲) ボタンをクリックします。
  2. トラッカーURL(Tracker URL)を選択します。
  3. ウィンドウの下部に移動し、新規トラッカー(NEW TRACKER)を選択します。
  4. 新しいAdjustトラッカーURLの名前を決めて入力し、作成(CREATE)を選択します。
  5. オーガニックストアトラッカーURLに対するAdjustトラッカートークンを取得し、Android開発者に送信して連携を依頼します。

開発者向けの手順

Adjustがインストール済みアプリの計測を行うには、事前定義済みのトラッカーURLにインストールを自動的に割り当てる、特定のAPKバージョンがAdjust SDKに直接書き込まれていることが必要です。

Adjustは、事前に割り当てられたカスタムトラッカートークンを使用して重複するAPKを瞬時に生成できる、小さなrubyコマンドラインを開発しました。設定すると、Adjust SDKがプリセットトラッカートークンを使用して、アプリの初回起動(インストール)をすべてレポートします。これをAdjustがユーザーのアトリビューションに使用します。 

システム要件

  • ruby
  • apktool
  • jarsigner

Adjust SDKの条件

  • Androidバージョン4.11以降

プロセスの概要

  1. システム条件を確認します。
  2. Adjust管理画面で生成されたオーガニックストアトラッカートークンを特定します。
  3. 各サードパーティーのAndroidストアの設定を含む、adjust-config.yamlの設定ファイルを生成します。詳細な手順については、こちらをご覧ください。
  4. ストアとプリインストールトラッカーツールを実行します。
完了すると、ストアとプリインストールトラッカーツールは、特定のストア/プラットフォームのAPKを生成します。これによってAdjustは、各APKのアプリのインストールを個別に計測することができます。 

サードパーティーのAndroidアプリストアで生成された有料インストールに対するAdjustの計測の設定

サードパーティーのAndroidアプリストアで生成されたペイドインストールを計測する場合、ストアやプリインストールトラッカーツールを使用する必要はありません。代わりに、標準のAdjustトラッカーURLを使用することができます。

連携のテスト

AdjustがAPKのパートナーバージョンを適切に計測していることをテストするには、以下の手順を実行します。

  1. 次の条件をすべて満たすAndroidデバイスを使用します。
    • お客様のアプリがインストールされていない
    • Adjustが計測していない。Adjustがテストアプリの起動をインストールとして計測するには、それまで計測されていたすべてのアプリのアクティビティをAdjustのシステムから消去する必要があります。バックエンドからデバイスのアプリ履歴を消去するには、AdjustのForget Device APIを使用してください。デバイスをクリアする手順については、Adjustテストコンソールページをご覧ください。
  2. ハードコーディングされたトラッカートークンを使用して、パートナーのAPKをダウンロードします。
  3. アプリを開きます。
  4. Adjust管理画面で、ハードコーディングされたトラッカートークンに関連付けられたインストールがあるか確認します。

:Adjustはすべてリアルタイムで計測しますが、インストールがAdjust管理画面に表示されるまでに最大20分かかる場合があります。同じデバイスで複数のテストを実行する場合は、テストが終わるたびにデバイスの広告ID(IDFA/gps_adid)をテストコンソールにて削除する必要があります。

このトピックについて