本文へスキップ

開発者API

プラットフォームAPIを使用すると、管理パネルにあるすべての機能を自動化することができます。

1.広告主は何を自動化できるのか？
  • キャンペーン/グループ、バリエーション、オファー、広告フォーマット
  • ターゲティング・オプション、カテゴリーのターゲティング／ブロック
  • 目標
  • アドブロックユーザーのデータを含む統計情報の取得
  • 日々の予算、口座資金、支払いタイプ
  • ランディングページ名、URL、トラフィックシェアアルゴリズム
2.出版社は何を自動化できるのか？
  • 広告フォーマットと広告ゾーン
  • サイト、URLの検証
  • 広告の種類と商品カテゴリーをブロックする
  • アドブロックユーザーのデータを含むすべての統計情報を取得する
  • 広告フォーマット/GEOごとの入札価格、価格設定モデル
  • 支払いの種類
3.APIの使い方
  • APIのインターフェースは高速で使いやすい
  • パラメータを選択し、Try It Outボタンを押すだけで、コードが自動生成されます。
4.技術資料ダウンロード

プラットフォームAPIの使用方法​

プラットフォームAPIをバージョン2に更新しました。この最新バージョンでは、管理パネル内のすべての機能を自動化することができます。繰り返しの作業を自動化して時間を節約するような簡単なプロセスから、バナークリエイティブをその場で変更するような複雑なプロジェクトまで、APIを使用することができます。

特徴​

パブリッシャーと広告主の両方が利用可能な機能の巨大な範囲を持っています。以下は、自動化できる機能の概要です：

広告主​

  • 個別/グループキャンペーン、バリエーション、オファー、広告フォーマット。
  • ターゲティング・オプション、カテゴリー、デイ・パーティングのターゲティング／ブロック。
  • 目標だ。
  • アドブロックのユーザーデータを含む統計情報を引き出す。
  • 日々の予算、口座資金、支払の種類。
  • ランディングページ名、URL、トラフィックシェアアルゴリズム。

出版社​

  • 広告フォーマットと広告ゾーン
  • サイト、URLの検証。
  • 広告の種類と製品カテゴリをブロックします。
  • アドブロックユーザーのデータを含むすべての統計情報を取得する。
  • 広告フォーマット/GEOごとの入札価格、価格設定モデル。
  • 支払いの種類
始める前に​

APIインターフェースには、グループタイトルのリストが表示されます。グループをクリックすると、利用可能なすべてのオプションがドロップダウンします。

list api

HTTP動詞​

APIは、以下のHTTP動詞のサブセットをサポートしています。すべての機能がすべての動詞をサポートするわけではないことに注意してください。

API uses

始めよう！

セッティング​

制限されたAPIリクエストにアクセスするには、セッション・トークンが設定されている必要があります。トークンを設定するには、有効なアカウントが必要です。

API Tokenの作成は、My Profileメニューから行うことができます。APIトークンを選択します。

my profile

New API Token**をクリックします。

api tokens

トークンの名前を入力します。このチュートリアルでは「testToken」とします。

トークンIDが作成される。

token id

APIへのログイン​

APIインターフェイスで、画面右上のログインボタンをクリックし、ユーザー名とパスワードを入力するか、APIトークンを提供します。Send**をクリックすると、有効なセッショントークンを取得するためのログインリクエストがAPIに送信されます。このトークンは、セッション中に行うすべてのAPIリクエストを検証するために使用されます。

api login

api login

APIへのリクエスト方法​

キャンペーングループを例に説明します。グループをクリックすると、利用可能なリクエストが一覧表示されます：

自動化したいリクエストをクリックしてください。この例では、CID 1923724のデータをリクエストします：

get campaign

キャンペーンを取得する**をクリックするとウィンドウが開きます。フィールドにキャンペーンID番号を入力してください：

campaign id

次に、Try It Now ボタンをクリックします。レスポンス・ボディが自動的にコードを生成します。

response body

レスポンスコードが200であれば、使用しても問題ない。

キャンペーンの一時停止方法​

別の例を示します。まず、キャンペーングループから正しい機能を選択します：

campaign pause

1つまたは複数のキャンペーンの一時停止をクリックします。開いた後、例値をクリックし、黄色のボックスをクリックすると、自動的に本文ボックスにjson構造が貼り付けられます。

pause

現在の値はゼロなので、ゼロを一時停止にしたいCIDに変更してください。次に、Try it outボタンをクリックして、必要なコードを生成します。

campaign id

キャンペーン価格の更新方法​

正しい機能を選択してください：

campaign id

キャンペーンを更新する**をクリックし、ウィンドウを開きます。キャンペーンIDフィールドにCIDを追加し、Example Valueをクリックし、黄色のボックスをクリックします。

このコードにはいくつかの異なる関数が含まれていますが、私たちはキャンペーン価格コードが欲しいので、以下のようにキャンペーン価格コードをボックス内に残して必要ない部分を削除します：

campaign id

ここで、ボディボックスのモデル（以下は、どの価格モデルに関連する値のリストである）を2つ変更する必要がある。


CampaignPricing {
model (integer, optional): Campaign pricing model (1: CPC, 2: CPM, 3: CPA, 4: Smart CPM, 5: CPV) = [‘1’, ‘2’, ‘3’, ‘4’, ‘5’],
price (number, optional): Campaign price
}

私たちはCPCに留まるつもりなので、モデルを1のままにしておく。

ここで、価格をゼロから希望の価格に変更する必要がある。つまり、新しい価格は200セントまたは2ユーロになる。

campaign id

そして、Try it outボタンをクリックするだけで、コードが生成されます。簡単です！

APIには自動化するための機能が満載されており、自動化のパワーを解き放つための想像力だけが唯一の限界であることがお分かりいただけるだろう。

最後に、APIインターフェイスの下部にあるAPIニュースレターを購読して、最新のニュースやアップデートを入手してください。