広告収益を自社で記録する場合は、このデータをサーバー間（S2S）で共有することで、Adjustで計測したその他の全ての指標と共に閲覧することができます。これにより、キャンペーンパフォーマンスの全体像が得られ、ユーザー生涯価値を計算し、キャンペーンの広告費用回収率（ROAS)と投資利益率（ROI）を最適化することができます。
広告収益データをAdjustサーバーに送信して、ダッシュボードのレポートとコホートで表示します。
https://s2s.adjust.com/ad_revenue事前準備
事前準備として、以下の内容をご確認ください。
- S2Sで送信された広告収益は、広告収益KPIおよびLTVとROASのコホート計算に追加されます。
ご利用の条件
- 広告収益パッケージにご契約していること
サーバー間 (S2S) 広告収益を送信
/ad_revenueエンドポイントは、S2S広告費用に対して以下のリクエストを受信します：
- URLパラメーターを使用したGET
- URLパラメーターを使用したPOST（bodyなし）
- Content-Typeとしてbody指定を含むPOST
application/x-www-form-urlencoded
S2Sセキュリティの設定
S2Sセキュリティを設定して、サーバー間 (S2S) 広告収益のセキュリティを保証し、スプーフィングされたリクエストからアプリを保護します。そのためには、受信するリクエストごとに、Adjustダッシュボードで生成されたトークンが付与されている必要があります。トークンが付与されていないリクエスト、または不正なトークンが付与されたリクエストは、Adjustのサーバーによって拒否されます。設定するには、 S2Sセキュリティに関する記事の手順に従ってください。
必須パラメーター
Adjustに広告収益を送信するには、以下のパラメーターを渡す必要があります。
| パラメーター | 説明 | 例 |
|---|---|---|
idfa; gps_adid など | プラットフォームに依存するデバイスID。一覧を参照してください。 |
|
app_token | ダッシュボードで取得できるAdjustアプリトークン。 | app_token=4w565xzmb54d |
s2s | 1に設定されたS2Sパラメーター。 | 1 |
revenue または amount | デバイスによって得た広告収益の金額。 | 4.99 |
currency | 収益を表す通貨。 イベントリクエストに、値が追加された {revenue}または{amount}パラメーターが含まれている場合は、 {currency}も送信する必要があります。このパラメーターがない場合は、Adjustがリクエストを拒否します。 | USD |
ad_impressions_count | 収益が関連付けられているインプレッションの数。 | 100 |
source | 常にpublisherであること。 | publisher |
以下のパラメーターは必須ではありませんが、 推奨されていません 。
| パラメーター | 説明 | 例 |
|---|---|---|
adid | Adjust デバイスID (全てのプラットフォーム) | 18546f6171f67e29d1cb983322ad1329 |
created_at_unix （推奨）または created_at | 広告インプレッションがユーザーに配信された正確な時間（28日以内である必要があります）。 | created_at_unix=1484085154 created_at=2017-01-02T15:04:05.000+0000 |
environment | 現在のSDKの環境設定。 | production またはsandbox。 |
コールバックに推奨されるその他のパラメーター
| パラメーター | 説明 | 例 |
|---|---|---|
callback_params | コールバックパラメーターをJSONオブジェクトとして渡すために使用します。 エスケープ された string:stringペアとしてフォーマットされています。 | 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 |
例
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"