パートナー広告費用APIを使用して、キャンペーンに関連する広告費用情報をAdjustに送信します。Adjustは、エンゲージメントの発生から 最大7日間 の間、広告費用データを受信します。
コストIDを設定する
- コストID
-
12〜256字 の長さの一意のコストエンゲージメント識別子の値。
パートナー広告費用APIを呼び出す全てのコールには、キャンペーンに関連付けられた一意の コストID を含める必要があります。AdjustはコストIDを使用して、送信された広告費用データをクリックまたはインプレッションとマッチングします。
コストIDは一意である必要があります。UUID（Universally Unique Identifier / 汎用一意識別子）を使用するか、IDの前に会社名を付与することをお勧めします。例： network_name_848dsf4939fgwjn028erg4
既存のclick_idまたはimpression_idを使用できます。クリックIDやインプレッションIDを作成しない場合は、2つ以上のプレースホルダーを組み合わせてIDを作成することができます。たとえば、インプレッション単価 (CPI) の場合、ユーザーのIDFA（広告ID）とアプリIDを組み合わせることが可能です。
Adjustを使用してCPMを計測する
CPM（1000回表示あたりの広告費用）データをAdjustに送信するには、パートナー広告費用APIコールで送信するcost_idと同じ値を持つcost_idをインプレッションURLに追加してください。CPMを計測する際は、インプレッション ごと にCPMを送信する必要があります。
広告費用データを送信する
POST https://app.adjust.com/costAdjustに広告費用情報を送信するには、 /costエンドポイントにPOSTリクエストを送信します。
パラメーター
各リクエストごとに以下のパラメーターを送信する必要があります。全てのパラメーターは、小文字の クエリパラメーター である必要があります。
cost_type（String）-
課金モデル。例：
cpc、cpi、cpe。 cost_currency（String）-
広告費用情報の通貨コード。ISO 4217の通貨コードでフォーマットされなければなりません。Adjustがサポートしている全ての通貨のリストをご覧ください。
cost_id（String）-
一意のコストID。詳細については、上記のコストIDのセクションを参照してください。
tag（String）-
ログの記録やデバッグに使用するラベル。この値は最大128文字で設定可能です。
例
$ curl -X POST https://app.adjust.com/cost \-d "cost_type=cpi&cost_currency=usd&cost_amount=2&cost_id=abc123_company_name_test_1&tag=company_name_test"レスポンス
200 Success-
広告費用情報がAdjustに送信されました。
400 Bad request-
リクエストが正しくフォーマットされていません。全ての必須パラメーターを含めるようにしてください。
401 Unauthorized-
必要な認証情報が提供されなかったため、リクエストを処理できませんでした。パートナー認証情報の設定については、wizards@adjust.comまでお問い合わせください。
403 Forbidden-
指定された認証情報には、送信された情報を投稿する権限がありません。問題を解決するには、wizards@adjust.comにお問い合わせください。
連携をテストする
必要なパラメーターを送信するようサーバーを設定したら、wizards@adjust.comまでご連絡ください。Adjustでは、お客様に一連のテストを提供しています。連携を有効化する前に、異なるコストタイプに乖離が生じていないか、他に問題がないかどうかを確認できます。Adjustはまた、API連携が期待通りに機能していることを確認するため、Adjust APIのテストも実施しています。
テストが完了すると、Adjustは連携された広告費用パートナーのリストにお客様を追加します。