本文へスキップ

郵便配達の例

概要​

このガイドでは、Postman を使用して ExoClick API 経由でキャンペーンを認証および作成する手順を説明します。すべての例では、各エンドポイントに必要なリクエストタイプ、ヘッダー、ボディフォーマットを指定しています。

認証（ログイン）​

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

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

*Request Type: POST URL: https://api.exoclick.com/v2/login

ヘッダー:

Content-Type: application/json

*本体（生のJSON）：***。

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD"
}

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

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

*Request Type: POST URL: https://api.exoclick.com/v2/login

ヘッダー:

Content-Type: application/json

*本体（生のJSON）：***。

{
  "api_token": "YOUR_API_TOKEN"
}

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

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

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

リンク先URLを登録します。標準バナーでは id_library_url が必要です。

*Request Type: POST URL: https://api.exoclick.com/v2/library/url

ヘッダー:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

*本体（生のJSON）：***。

{
  "url": "https://your-landing-page.com"
}

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

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

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

*Request Type: POST URL: https://api.exoclick.com/v2/library/file

ヘッダー:

Authorization: Bearer YOUR_TOKEN

*本文（フォームデータ）：***。

キータイプ価値
ファイルファイル画像ファイルを選択してください (300x250)
タイプ`テキストイメージ

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

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

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

*Request Type: POST URL: https://api.exoclick.com/v2/campaigns

ヘッダー:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

*本体（生のJSON）：***。

{
  "name": "Banner 300x250 Production",
  "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）にリンクします。

*Request Type: POST URL: https://api.exoclick.com/v2/campaigns/8140060/variation (8140060 をステップ 3 の実際のキャンペーン ID に置き換えてください).

ヘッダー:

Authorization: Bearer YOUR_TOKEN

*本文（フォームデータ）：***。

キータイプ価値
id_library_url`テキスト6512406` (ステップ1から)。
id_library_file`テキスト6884966` （ステップ2より）。
アクティブテキスト1

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