サーバー間(S2S)広告収益
広告収益を自社で計測する場合は、データをサーバー間(S2S)連携することで、Adjustで計測したその他全てのKPIと確認することができます。これにより、キャンペーンのパフォーマンスやユーザーLTV、広告収益などを包括的に確認し、キャンペーンのROASとROIを最適化できます。
広告収益データをAdjustサーバーに送信して、ダッシュボードのレポートとコホートで表示します。
事前準備
事前準備として、以下の内容をご確認ください。
ご利用の条件
- 広告収益パッケージのご契約
参考
- S2Sで送信された広告収益は、広告収益KPIおよびLTVとROASのコホート計算に追加されます。
サーバー間 (S2S) 広告収益を送信
サーバー間 (S2S) 広告収益には、Adjustは以下のタイプのリクエストを受信することができます。
- URLパラメーターを使用したGET
- URLパラメーターを使用したPOST(bodyなし)
- Content-Type
application/x-www-form-urlencoded
としてbodyパラメーターを使用したPOST
サーバー間(S2S)セキュリティの設定
サーバー間(S2S)セキュリティを設定することで、サーバー間での広告収益の計測における偽装リクエストを防止します。これには、受信するリクエストごとにAdjustダッシュボードで生成されたトークンが付与されている必要があります。トークンが付与されていないリクエストや、誤ったトークンが付与されているリクエストは、サーバーによって拒否されます。AdjustのS2Sセキュリティを設定するには、この記事の手順に従ってください。
必要なパラメーター
Adjustに広告収益を送信するには、常に次のパラメーターを https://s2s.adjust.com/ad_revenue に渡してください。
パラメーター | 説明 | 例 |
---|---|---|
idfa ; gps_adid ; など. | プラットフォームに依存するデバイスID(全リストを参照) | idfa=D2CADB5F-410F-4963-AC0C-2A78534BDF1E |
app_token | ダッシュボードで取得できるAdjustアプリトークン | app_token=4w565xzmb54d |
s2s | 1に設定されたS2Sパラメーター | 1 |
revenue もしくは amount | デバイスによって得た広告収益の金額 | 4.99 |
currency | 収益を表す通貨イベントリクエストに{revenue} や {amount}のパラメーターが付与されている値を含む場合は、{currency}を追加することが重要です。このパラメーターがない場合は、Adjustのサーバーがリクエストを拒否します。 | USD |
ad_impressions_count | 収益が関連付けられているインプレッション数 (int > 0) | 100 |
source | 常にpublisher | publisher |
推奨 (任意): | ||
adid | Adjust デバイスID (全てのプラットフォーム) | 18546f6171f67e29d1cb983322ad1329 |
created_at_unix
(推奨)
もしくは
created_at | 広告インプレッションがユーザーに配信された正確な時間を示します (28日以内である必要があります)。 | created_at_unix=1484085154 or created_at=2017-01-02T15:04:05.000+0000 |
environment | 現在のSDKの環境設定 | production またはsandbox |
コールバックに推奨されるその他のパラメーター
パラメーター | 説明 | 例 |
callback_params | コールバックパラメーターをJSONオブジェクとして渡すために使用します (適切にエスケープされ、文字列から文字列へ) | callback_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D |
ad_revenue_network | 広告収益に関するその他のデータ | ad_revenue_network=Admob |
ad_revenue_unit | 広告収益に関するその他のデータ | ad_revenue_unit=rewarded_video |
ad_revenue_placement | 広告収益に関するその他のデータ | ad_revenue_placement=home_screen |
トークンが追加されたPOSTリクエストの例:
curl -X POST -H "Authorization: Bearer b9eb9d6228842aeb05d64f30d56b361e" "https://s2s.adjust.com/ad_revenue?app_token=abc123abc123&idfa=FAD135C7-C5F8-4DCC-9478-2203956B0870&source=publisher&ad_impressions_count=1&revenue=0.01¤cy=USD&s2s=1"
成功レスポンスの例:
{"status":"OK"}
エラーのレスポンスの例:
{"error":"Ad revenue request failed (wrong authentication token) (app_token:abc123abc123)"}