本文へスキップ

cURLの例

概要​

このガイドでは、ExoClick API 経由でキャンペーンを認証および作成するための、すぐに使える cURL コマンドを提供します。すべての例では、エンドポイントの要件に応じて、標準のJSONまたはForm-Data形式を使用します。

認証（ログイン）​

アカウントの認証情報または永続的な API トークンを使用して認証できます。どちらも、以降のリクエストで使用する一時的なベアラ・トークンを返します。

A - ユーザー名とパスワードでログイン​

curl -X POST "https://api.exoclick.com/v2/login" \
     -H "Content-Type: application/json" \
     -d '{
       "username": "YOUR_USERNAME",
       "password": "YOUR_PASSWORD"
     }'

B - APIトークンでログイン​

ExoClick ダッシュボード（Profile > API Tokens）でトークンを生成した場合に使用します。

curl -X POST "https://api.exoclick.com/v2/login" \
     -H "Content-Type: application/json" \
     -d '{
       "api_token": "YOUR_API_TOKEN"
     }'

300x250バナーキャンペーン制作フロー​

以下のステップを正確に順番通りに行ってください。最後のステップでJSONからForm-Dataに移行することに注意してください。

ステップ1：ランディングページURLの作成（ライブラリ）​

目的地のURLを登録します。

フォーマット： JSON

curl -X POST "https://api.exoclick.com/v2/library/url" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "url": "https://your-landing-page.com"
     }'

Result: 返された "id" (例えば 6512406) を保存する。

ステップ2：画像（ライブラリ）のアップロード​

クリエイティブアセットを登録します。画像は正確に300x250でなければなりません。

フォーマット: フォームデータ

curl -X POST "https://api.exoclick.com/v2/library/file" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -F "file=@/path/to/your/image_300x250.jpg" \
     -F "type=image"

結果: 返された "id" (例えば 6884966) を保存する。

ステップ3：キャンペーンシェルの作成​

ターゲティング、予算、img_banner テンプレートを設定する。

フォーマット： JSON

curl -X POST "https://api.exoclick.com/v2/campaigns" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Banner 300x250",
  "status": 0,
  "advertiser_ad_type": 0,
  "media_storage_template": "img_banner",
  "size": "300x250",
  "categories": { "type": "targeted", "elements": [97, 98, 99] },
  "countries": {
    "type": "targeted",
    "elements": [{ "country": "USA", "regions": [0] }]
  },
  "pricing": { "model": 4, "price": 300 },
  "start_date": "2026-03-02",
  "daily_limit_type": 1,
  "max_daily_budget": 2000,
  "budget_delivery_mode": 1,
  "run_on_responsive_zones": 1
}'

結果: 返された "id" (例えば 8140060) を保存する。

ステップ4：バリエーションを加える​

URL（ステップ1）と画像（ステップ2）をキャンペーン（ステップ3）にリンクします。

フォーマット: フォームデータ

curl -X POST "https://api.exoclick.com/v2/campaigns/8140060/variation" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -F "id_library_url=6512406" \
     -F "id_library_file=6884966" \
     -F "active=1"

各ステップで返されたIDはすべて保存し、以降のリクエストで使用する必要がある。YOUR_TOKEN`、ファイルパス、および ID は、実際の値に置き換えることを忘れないでください。