連携 & APIキー - Ad Control Help Center

概要

コンソールの**[管理]** > **[連携]**メニューでは、Adrop外部連携に必要な設定をすべて管理します。

APIキー: Open API呼び出し、リワード広告SSVコールバックの復号に使用
リワード広告SSV: 報酬完了時にサーバーへ送信されるコールバックURLの設定 — リワード広告SSVドキュメントを参照

連携メニューは、プロジェクトの**オーナー（owner）**権限を持つメンバーのみアクセスできます。

APIキーの発行

連携メニューへ移動

コンソールの**[管理]** > **[連携]**メニューに移動します。

キー情報の入力

APIキーセクションで**[APIキーを作成]**ボタンをクリックし、以下の情報を入力します。

項目	説明
キー名	用途を識別できる名前（例：「レポート連携」）。1文字以上を入力してください。
スコープ	1つ以上の選択が必須です。許可された権限の範囲のみ呼び出せます。

キーのコピーと保管

生成されたAPIキーをコピーし、安全に保管します。

APIキーは生成直後に1回だけ確認できます。ウィンドウを閉じると再表示できないため、必ずコピーして安全な場所に保管してください。

権限範囲（Scope）

権限	説明
`report:read`	キャンペーンレポートおよびバックフィル収益データの照会
`campaign:read`	キャンペーン情報の閲覧
`campaign:write`	キャンペーンの作成・変更
`webhook:read`	Webhookコールバックデータの閲覧
`webhook:write`	Webhookイベントの送信
`auth:delegate`	委任認証コードの作成

現在Open APIで呼び出し可能なエンドポイントはレポートAPIです。権限の一覧はコンソールによって一部のみ表示される場合があります。

Open API呼び出し

基本情報

項目	値
Base URL	`https://lake.adrop.io`
プロトコル	HTTPS
認証方式	API Key（`x-api-key`ヘッダー）

認証

すべてのAPIリクエストにx-api-keyヘッダーを含める必要があります。

curl -X POST https://lake.adrop.io/report \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{...}'

APIキーは外部に共有しないでください。キーが漏洩した場合は、直ちに廃棄して新しいキーを発行してください。

APIキーの管理

キー一覧の確認

連携メニューのAPIキーセクションで、発行済みのAPIキー一覧を確認できます。

表示項目	説明
キー名	キー作成時に入力した名前
APIキー	prefix（例：`adrop_7kF2`）のみ表示、以降はマスキング
スコープ	付与された権限の数（ツールチップで全体を確認）
作成日	キーが作成された日付

キーの廃棄

使用しなくなったキーは、右側メニューの**[取り消し]**で即座に廃棄できます。

廃棄されたAPIキーは即座に認証がブロックされます。そのキーを使用中のシステムでAPI呼び出しが失敗する可能性がありますので、廃棄前に連携中のサービスがないか確認してください。

リワード広告SSVに連携されたAPIキーは廃棄できません。SSVで別のAPIキーに変更するか、SSV設定を削除してから再度お試しください。

リワード広告SSV

報酬完了時にサーバーへ送信されるSSVコールバックURLの登録とペイロードの復号

レポートAPI

キャンペーン成果およびバックフィル収益データをAPIで照会する方法

​概要

​APIキーの発行

​権限範囲（Scope）

​Open API呼び出し

​基本情報

​認証

​APIキーの管理

​キー一覧の確認

​キーの廃棄

​関連ドキュメント

リワード広告SSV

レポートAPI

概要

APIキーの発行

権限範囲（Scope）

Open API呼び出し

基本情報

認証

APIキーの管理

キー一覧の確認

キーの廃棄

関連ドキュメント