コンテンツ連動広告　アドワイアーズ
→スポンサーサービスログイン　 →メディアサービスログイン

スポンサーサービス
→ログイン
→サービスのご案内
→サービスのお申込み
→ヘルプ
→マニュアル
→チュートリアル

メディアサービス
→ログイン
→サービスのご案内
→サービスのお申込み
→ヘルプ
→マニュアル
→チュートリアル

関連情報
→WebAPI
→広告サンプル
→広告配信方法
→２ティアについて
→クローラーについて

→会社概要
→プライバシーポリシー
→利用規約
→免責事項
→お問い合わせ
→ご意見・ご感想・ご指摘

 

WebAPI＠アドワイアーズ広告

アドワイアーズ広告の新しい広告配信方法としてWebAPIを公開してます。
このWebAPIは行動ターゲティングやコンテンツ連動広告とは異なり、指定のキーワードに連動するキーワード連動広告となっております。
ご利用いただくにはメディアパートナーのアカウント登録が必要になります。登録、ご利用共に無料です。
WebAPI＠アドワイアーズ広告はデベロッパー（開発者）向けのサービスとなっております。REST形式のため、開発言語は問いません。PHP、Perl、JSP（Java）、ASPやFlash、JavaScriptで開発できます。
WebAPI＠アドワイアーズ広告を活用したサイトやウェブアプリ、ブログパーツを開発された方は、ぜひご連絡ください。
弊社サイトにて紹介させていただきます。

WebAPI仕様

概要

このWebAPIは、http通信によるREST形式のWebAPIです。
指定されたキーワードと連動した広告データをXMLで返します。
広告をクリックされるとサイト収益を受け取ることができます。

リクエストURL

http://api.adwires.com/v01.php

GET、POSTパラメータ（入力仕様）

名前 説明 値 必須
mid メディアパートナーID
※ログイン後に表示されるMから始まる9桁のID番号から英字Mを抜いた整数。
例：M00001452の場合、00001452を指定		 整数
○
chid チャンネルID
※ログイン後、チャンネル一覧から取得できます。		 文字列
○
target 0でPC向け広告
1でモバイル向け広告
※指定がないとPC向け広告となります。		 整数
mode 0でキーワード連動広告のみ
1でキーワードに関連する広告がなければランダムに広告を抽出
※指定がないとキーワード連動広告となります。 		整数
limit 取得件数　整数で1～10 整数
q キーワードはUTF８をurlencodeした文字列
※urldecode時に40字以内		 文字列
○
test 0で通常処理、1でテストモード
※テストモードの場合、広告データの取得はできますが、報酬の加算等はされません。テストの際は広告主様に迷惑をかけないように必ず1にしてください。		  
パラメータは、GETあるいはPOSTで指定します。文字コード入力はUTF-8のみ。出力はUTF-8固定となっています。

GETパラメータリクエスト例

パラメータリクエスト例です。このURLをクリックするとXMLデータが返ってきます。

 

http://api.adwires.com/cast/v01.php?mid=1&chid=6cd805831b65bc27ea6213872b98014c
&target=0&mode=0&limit=5&q=%83A%83h%83%8F%83C%83A%81[%83Y&test=1

レスポンスフィールド（XML形式出力仕様）

名前 説明 値
resultset 取得結果のすべてを含みます。  
param 入力されたパラメータのすべてを含みます。  
mid 入力されたメディアIDを返します。 整数
chid 入力されたチャンネルIDを返します。 文字列
q 入力されたキーワード文字列を返します。 文字列
target 入力された対象デバイスを返します。 整数
mode 入力された 検索モード を返します。 整数
limit 入力された取得件数を返します。 整数
test 入力されたテストモードを返します。 整数
result 取得された広告データを含みます。  
title 広告のタイトルを返します。
※取得データのうちtitleは省略不可となっています。		 文字列
comment1 広告のコメント１を返します。
※レイアウトの都合上やむをえない場合のみ省略可となっています。		 文字列
comment2 広告のコメント２を返します。
※レイアウトの都合上やむをえない場合のみ省略可となっています。		 文字列
url 広告の表示用URLを返します。
※レイアウトの都合上やむをえない場合のみ省略可となっています。		 文字列
clickurl 広告のリンク先URLを返します。
※取得データのうちclickurlは省略不可となっています。		 文字列

エラー時のレスポンス

名前 説明 値
resultset 取得結果のすべてを含みます。  
Error エラー内容を含みます。 文字列
Message エラーメッセージを返します。 文字列

エラーメッセージ

エラー番号 説明
E0010 Invailed mid
メディアIDが不正です。
E0020 Invailed chid
チャンネルIDが不正です。
E0030 Invailed mid/chid
メディアIDまたはチャンネルIDが不正です。
E0040 keywords are too long.
キーワード文字列が長すぎます。
W0100 no matches
該当する広告が見つかりませんでした。

条件

広告表示エリアの上下左右32ピクセル以内に文字サイズ9ピクセル以上。可視できる配色で「Ads by ADWIRES」のテキストリンクを表示してください。

 

<a href="http://www.adwires.com/">Ads by ADWIRES</a>

サンプル

PHPで作成したスクリプトをこちらからダウンロードいただけます。
WebAPIによる開発のサンプルとしてご利用ください。

サンプルをダウンロードして拡張子をphpに変更すると実行できます。

利用ガイドライン

  • メディアサービスの利用規約に準じてご利用ください。
  • このサービスは無保証です。いかなる損害も保証いたしかねます。
  • クレジット表記は必ず行ってください。
  • 広告掲載している商用サイト、非商用サイトどちらにも利用可能です。
  • 広告データは必ずリアルタイムにリクエストを行い、帰ってきたレスポンスのみをご利用ください。広告データの保存は行わないようにしてください。
  • 強引なクローリングは、システムの速度低下やサービス停止につながるため、広告を大量にダウンロードするクローラーを利用しないでください。
  • 1つのスクリプトやHTMLからのリクエスト数は1回としてください。
  • 1日100万回以上のリクエストが予測される場合、あらかじめご相談ください。
  • APIはアップグレードすることがあります。なるべく下位互換を保つようにします。
    もし下位互換は保証されない大規模な変更がある場合、移行期間として、旧バージョン、新バージョンの併存期間を設けます。
  • サービス提供者はサービスを中断、終了する権利、サービス利用を停止する権利を有します。