サーバーコールバックの設定

サーバーコールバックを設定して、広告ID、アトリビューションの詳細、アプリデータなどをサーバーにローデータとして直接送信できます。

事前準備

はじめに、以下の設定手順をご覧ください。

要件​

  • 管理者、編集者およびカスタム編集者のユーザー権限
  • コールバックリクエストを受信するためには、独自のビジネスインテリジェンスソリューションまたはデータウェアハウスが必要です。サーバーが全てのパラメーターを受信し、全ての着信データを保存できることを確認してください。アプリ内のユーザー数によって、サーバーに必要な処理速度が変わります。「登録」など1回限りのイベントを計測する場合、コンバージョンに至ったユーザーごとに1回、コールバックを受信します。コンバージョンイベントのコールバックがサーバー帯域幅に大きく影響することはありません。
  • Adjustからのデータのみを受信するには、AdjustのサーバーIPを許可リストに登録してください。

コールバックのタイプ

コールバックは、以下のトリガーに対して設定できます。

利用可能なトリガー

グローバルコールバック

グローバルコールバックは、クリック、インストール、セッションなど、Adjustが計測する全てのトリガーのメインのコールバックです。URLが複数ではなく1つしか存在しないため、Adjustが計測する各アクティビティで同じデータポイントを取得する最も速い方法となります。

注意:
グローバルコールバックは以下のアクティビティを含みません。
  • 広告収益（Ad revenue）
  • API 連携パートナーのクリック（SAN clicks）
  • API 連携パートナーのインプレッション（SAN impressions）
  • SKAdNetworkインストール（SKAdNetwork installs）
  • SKAdNetworkイベント（SKAdNetwork events）
これらのアクティビティには、単一のアクティビティコールバックを設定してください。

単一のアクティビティコールバック

単一のアクティビティコールバックは、1つの特定のアクティビティ（クリックなど）に対するコールバックです。これは特定のアクティビティのデータのみが必要な場合に最適なオプションです。場合によっては、グローバルコールバックによって大量のデータ、特にインプレッションとクリックが生成されることがあります。Adjustからビジネスインテリジェンスシステムに送信するデータ量を減らす必要がある場合は、単一のアクティビティコールバックを設定してください。

注意:
グローバルと単一のアクティビティコールバックの両方を設定する場合、そのアクティビティに対してそれぞれのコールバック（各エンドポイントに対して1つのコールバック）を受信します。

同じアクティビティに対する複数のコールバック

Adjustでは、単一のアクティビティコールバックを必要な数のエンドポイントに送信できます。これを行うには、各URLを1つのスペース ( )で区切ってください。

サーバーコールバックの設定

サーバーコールバックは、ガイド設定またはクラシックモード設定を使用して作成できます。Adjustは、ガイド設定を使用してコールバックURLを作成することを推奨します。

トリガーに使用可能なプレースホルダーについては、推奨プレースホルダーを参照してください。

ガイド設定

  1. アプリカードまたはアプリ設定の データ管理（Data management）​ タブから、サーバーコールバック設定にアクセスします。

    • （管理者、編集者、カスタム編集者のアクセス権限があるユーザーのみ）アプリカードからサーバーコールバックを設定するには、 AppView​ にて 全てのアプリ（All apps）​ を選択します。アプリを見つけたら、 サーバーコールバック（Server callbacks）​ を選択します。
    • アプリ設定の データ管理（Data management）​ タブからサーバーコールバックを設定するには、 AppView​ にて 全てのアプリ（All apps）​ を選択し、 データ管理（Data management）​ タブを選択します。

  2. サーバーコールバック（Server callbacks）​ で、 コールバックの追加（Add callback）> ガイド設定（Guided setup）​ を選択します。

  3. コールバックトリガー（Callback trigger）​ リストで、コールバックをトリガーするアクティビティまたはイベントを選択します。

  4. サーバーエンドポイント（Server endpoint）​ フィールドで、データを受信するエンドポイントURLを入力します。

  5. （オプション） コンディションを追加（Add a condition）​ を選択し、プレースホルダーと値を組み合わせて条件を追加します。コールバックは、コンディションが満たされた場合にのみトリガーされます。

  6. リクエストメソッド（Request method）​ フィールドで、コールバックがGETまたはPOSTのどちらを使用するかを選択します。デフォルトはGETです。

    • POSTを選択すると、key=value形式を使用して、リクエストボディとしてキーと値のペアを入力できます。Adjustはボディをエンコードし、フラットなJSONオブジェクトとして送信します。

  7. プレースホルダーを追加（Add a placeholder）​ を選択して、コールバックにユーザーまたはエンゲージメントデータを動的に含めます。この時点では複数のプレースホルダーを追加できます。

  8. コールバックURLを作成（Create callback URL）​ を選択し、エンコードされたコールバックを生成します。

クラシックモード設定

クラシック設定を使用すると、コールバック文字列全体を直接編集できます。システムで、GETとPOSTの両方の形式が認識されるようになります。

  • <method>,<conditions>,<url>[,<body>]
  • POSTのボディはkey1=value1&key2=value2を使用し、AdjustはそれらをフラットなJSONに変換します。

コールバックは、1つのスペースで区切ることで複数入力できます。明示的にPOSTを指定しない限り、デフォルトのリクエストメソッドはGETになります。

コールバックを管理する

コールバックURLを構築したら、 サーバーコールバックオーバービュー（Server callbacks overview）​ ページで閲覧できます。コールバックで次のタスクを実行することが可能です。

  • （コピーアイコン）を選択してコールバックURLをコピーします。
  • （複製アイコン）を選択してコールバックを複製し、クラシック設定を開きます。
  • （削除アイコン）を選択してコールバックを削除します。
  • （編集アイコン）を選択し、クラシック設定を使用してコールバックURLを編集します。