概要
Adrop REST APIを使用すると、SDKなしでサーバーサイドから直接広告をリクエストできます。Webサーバー、バックエンドサービス、またはSDKをサポートしていないプラットフォームで広告を連携する際に便利です。基本情報
| 項目 | 値 |
|---|---|
| Base URL | https://api-v2.adrop.io |
| プロトコル | HTTPS |
| 認証方式 | App Key（Authorizationヘッダー） |
認証設定
APIを使用するにはApp Keyが必要です。App Keyの取得
- Adropコンソールにログイン
- 管理タブに移動
- アプリメニューからプラットフォーム別の
adrop_service.jsonをダウンロード - JSONファイルでApp Keyを確認
認証ヘッダー
すべてのAPIリクエストにAuthorizationヘッダーを含める必要があります：
共通パラメータ
必須パラメータ
| パラメータ | タイプ | 説明 |
|---|---|---|
unit | STRING | 広告ユニットID |
推奨パラメータ
| パラメータ | タイプ | 説明 |
|---|---|---|
uid | STRING | ユーザー固有識別子 |
pf | STRING | プラットフォーム（android、ios、web） |
lcl | STRING | ロケール（例：ja_JP、en_US） |
任意パラメータ
| パラメータ | タイプ | 説明 |
|---|---|---|
theme | STRING | テーマモード（light、dark） |
adId | STRING | 広告識別子（ADID/IDFA） |
contextId | STRING | コンテキストターゲティングID |
uidパラメータは、ユーザーごとの広告表示頻度制御とターゲティング情報のマッピングに使用されます。提供しない場合、正確なターゲティングが難しくなる可能性があります。サポートされている広告フォーマット
バナー広告
HTML形式で返され、Webで直接レンダリング可能
ネイティブ広告
構造化データで返され、カスタムUI実装が可能
関連ドキュメント
ターゲティング設定
ユーザー属性およびコンテキストターゲティング設定
イベント送信
ユーザー行動イベントの送信およびコンバージョントラッキング
エラーコード
APIエラーコードと解決方法