3.1.2. 広告枠レポートを取得する

[※]のついているものは必須パラメータです。

広告枠別レポートを取得する

[URL]
http://api.adlantis.jp/api/mobile/zone/report/list

[メソッド]
GET

[引数]
sd[※] : レポートを取得する期間の開始日。

ed[※] : レポートを取得する期間の終了日。

q : キーワードで広告枠を絞り込みます。検索対象は広告枠名、サイト名、サイトの説明になります。

zone_ids : 文字列。 広告枠IDの一覧をコンマ区切りで指定します。

[戻り値]
                 list :
                    total :
                        impression : 対象期間の合計インプレッション数。

                        click : 対象期間の合計クリック数。

                        ctr : 対象期間のCTR。

                        cost : 対象期間の合計収益。

                        ecpm : 対象期間のeCPM。

                    zones :
                        zone :
                            id : 広告枠ID

                            name : 広告枠名

                            impression : 
対象期間のインプ レッション数。

                            click : 対象期間のクリック数。

                            ctr :  対象期間のCTR。

                            cost : 対象期間の収益。

                            ecpm : 対象期間のecpm。

広告枠×日別レポートを取得する

[URL]
http://api.adlantis.jp/api/mobile/zone/report/matrix

[メ ソッド]
GET

[引数]
zone_id[※] : レポートを取得する広告枠IDを指定します。

report_format[※] : "zone"

sd[※] : レポートを取得する期間の開始日。

ed[※] : レポートを取得する期間の終了日。

daily[※] : 結果を日別に出力するかどうか。
  • 1 : 日別に出力する。
  • それ以外 : 合計を出力する。
[戻り値]
- 日別表示の場合 -

zone_stats :
zone_stat :
target_date : レポート表示対象日。

total:
impression : 3キャリア+その他のキャリアの合計インプレッション数。

click : 3キャリア+その他のキャリアの合計クリック数。

cost : 3キャリア+その他のキャリアの合計収益。

ctr : 3キャリア+その他のキャリアのCTR。

ecpm : 3キャリア+その他のキャリアのeCPM。

au(softbank/docomo/others)_imp : au/Softbank/DoCoMo/その他のキャリアのインプレッション数。

au(softbank/docomo/others)_click : au/Softbank/DoCoMo/その他のキャリアのクリック数。

au(softbank/docomo/others)_cost : au/Softbank/DoCoMo/その他のキャリアの収益。

au(softbank/docomo/others)_ctr : au/Softbank/DoCoMo/その他のキャリアのCTR。

au(softbank/docomo/others)_ecpm : au/Softbank/DoCoMo/その他のキャリアのeCPM。

campaign:
指定した広告枠へ対象日に配信された、アドサーバーのキャンペーンに関するレポート。
小 要素はtotalと全て同じ。

exchange:
指定した広告枠へ対象日に配信された、アドサーバーのキャンペーンに関するレポート。
小要素はtotalと全て同じ。

default:
指定した広告枠へ対象日に配信された、アドサーバーのキャンペーンに関するレポート。
小要素はtotalと全て同じ。

- 合計表示の場合 -

zone_stat
total:
impression : 3キャリア+その他のキャリアの合計インプレッション数。

click : 3キャリア+その他のキャリアの合計クリック数。

cost : 3キャリア+その他のキャリアの合計収益。

ctr : 3キャリア+その他のキャリアのCTR。

ecpm : 3キャリア+その他のキャリアのeCPM。

au(softbank/docomo/others)_imp : au/Softbank/DoCoMo/その他のキャリアのインプレッション数。

au(softbank/docomo/others)_click : au/Softbank/DoCoMo/その他のキャリアのクリック数。

au(softbank/docomo/others)_cost : au/Softbank/DoCoMo/その他のキャリアの収益。

au(softbank/docomo/others)_ctr : au/Softbank/DoCoMo/その他のキャリアのCTR。

au(softbank/docomo/others)_ecpm : au/Softbank/DoCoMo/その他のキャリアのeCPM。

campaign:
指定した広告枠へ対象日に配信された、アドサーバーのキャンペーンに関するレポート。
小 要素はtotalと全て同じ。

exchange:
指定した広告枠へ対象日に配信された、アドサーバーのキャンペーンに関するレポート。
小要素はtotalと全て同じ。

default:
指定した広告枠へ対象日に配信された、アドサーバーのキャンペーンに関するレポート。
小 要素はtotalと全て同じ。

広告枠×キャンペーンレポートを取得する

[URL]
http://api.adlantis.jp/api/mobile/zone/report/matrix

[メソッド]
GET

[引数]
zone_id[※] : レポートを取得する広告枠IDを指定します。

report_format[※] : "zone_campaign"で固定。

sd[※] : レポートを取得する期間の開始日。

ed[※] : レポートを取得する期間の終了日。

daily[※] : 結果を日別に出力するかどうか。
  • 1 : 日別に出力する。
  • それ以外 : 合計を出力する。
[戻り値]
- 日別表示の場合 -

zone_stats:
zone_stat:
campaign_name : キャンペーン名。

status : キャンペーンのステータス。
    定数一覧の「キャンペーン及びクリエイティブのステータス」を参照して下さい。

stats:
stat:
target_date : レポート表示対象日。

impression : 3キャリア+その他のキャリアの合計インプレッション数。

click : 3キャリア+その他のキャリアの合計クリック数。

cost : 3キャリア+その他のキャリアの合計収益。

ctr : 3キャリア+その他のキャリアのCTR。

conversion : 3キャリア+その他のキャリアの合計成果数。

au(softbank/docomo/others)_imp : au/Softbank/DoCoMo/その他のキャリアのインプレッション数。

au(softbank/docomo/others)_click : au/Softbank/DoCoMo/その他のキャリアのクリック数。

au(softbank/docomo/others)_cost : au/Softbank/DoCoMo/その他のキャリアの収益。

au(softbank/docomo/others)_ctr : au/Softbank/DoCoMo/その他のキャリアのCTR。

au(softbank/docomo/others)_ecpm : au/Softbank/DoCoMo/その他のキャリアのeCPM。

au(softbank/docomo/others)_cvr : au/Softbank/DoCoMo/その他のキャリアの成果率。

- 合計表示の場合 -

zone_stat:
zone_stat:
campaign_name : キャンペーン名。

status : キャンペーンのステータス。
    定数一覧の「キャンペーン及びクリエイティブのステータス」を参照して下さい。

stats:
target_date : レポート表示対象日。

impression : 3キャリア+その他のキャリアの合計インプレッション数。

click : 3キャリア+その他のキャリアの合計クリック数。

cost : 3キャリア+その他のキャリアの合計収益。

ctr : 3キャリア+その他のキャリアのCTR。

conversion : 3キャリア+その他のキャリアの合計成果数。

cvr : 3キャリア+その他のキャリアのCVR。

au(softbank/docomo/others)_imp : au/Softbank/DoCoMo/その他のキャリアのインプレッション数。

au(softbank/docomo/others)_click : au/Softbank/DoCoMo/その他のキャリアのクリック数。

au(softbank/docomo/others)_cost : au/Softbank/DoCoMo/その他のキャリアの収益。

au(softbank/docomo/others)_ctr : au/Softbank/DoCoMo/その他のキャリアのCTR。

au(softbank/docomo/others)_ecpm : au/Softbank/DoCoMo/その他のキャリアのeCPM。

au(softbank/docomo/others)_cvr : au/Softbank/DoCoMo/その他のキャリアの成果率。

 広告枠×キャンペーン×クリエイティブ別レポートを取得する

[URL]
http://api.adlantis.jp/api/mobile/zone/report/matrix

[メソッド]
GET

[引数]
zone_id[※] : レポートを取得する広告枠IDを指定します。

report_format[※] : "zone_campaign_creative"で固定。

sd[※] : レポートを取得する期間の開始日。

ed[※] : レポートを取得する期間の終了日。

daily[※] : 結果を日別に出力するかどうか。
  • 1 : 日別に出力する。
  • それ以外 : 合計を出力する。
[戻り値]
- 日別表示の場合 -

zone_stats:
zone:
type : "MobileZone"で固定

campaigns:
campaign:
type : "MobileCampaign"で固定。

campaign_id : キャンペーンID。

ads:
ad:
ad_id : クリエイティブID。

ad_type : クリエイティブの種類。
    定数一覧の「モバイル版クリエイティブの種類」を参照して下さい。

stats:
stat:
ad_id : クリエイティブID。

target_date : レポート表示対象日。

impression : 3キャリア+その他のキャリアの合計インプレッション数。

click : 3キャリア+その他のキャリアの合計クリック数。

cost : 3キャリア+その他のキャリアの合計収益。

ctr : 3キャリア+その他のキャリアのCTR。

conversion : 3キャリア+その他のキャリアの合計成果数。

au(softbank/docomo/others)_imp :
    au/Softbank/DoCoMo/その他のキャリアのインプレッション数。

au(softbank/docomo/others)_click :
    au/Softbank/DoCoMo/その他のキャリアのクリック数。

au(softbank/docomo/others)_cost :
    au/Softbank/DoCoMo/その他のキャリアの収益。

au(softbank/docomo/others)_ctr :
    au/Softbank/DoCoMo/その他のキャリアのCTR。

au(softbank/docomo/others)_conv :
    au/Softbank/DoCoMo/その他のキャリアの成果数。

au(softbank/docomo/others)_cvr :
    au/Softbank/DoCoMo/その他のキャリアの成果率。


- 合計表示の場合 -

zone_stat:
zone:
type : "MobileZone"で固定。

campaigns:
campaign:
type : "MobileCampaign"で固定。

campaign_id : キャンペーンID。

ads:
ad:
ad_id : クリエイティブID。

ad_type : クリエイティブの種類。
    定数一覧の「モバイル版クリエイティブの種類」を参照して下さい。

stats:
stat:
ad_id : クリエイティブID。

start_date : 表示期間の開始日。

end_date : 表示期間の終了日。

impression : 3キャリア+その他のキャリアの合計インプレッション数。

click : 3キャリア+その他のキャリアの合計クリック数。

cost : 3キャリア+その他のキャリアの合計収益。

ctr : 3キャリア+その他のキャリアのCTR。

conversion : 3キャリア+その他のキャリアの合計成果数。

cvr : 3キャリア+その他のキャリアの成果率。

au(softbank/docomo/others)_imp :
    au/Softbank/DoCoMo/その他のキャリアのインプレッション数。

au(softbank/docomo/others)_click :
    au/Softbank/DoCoMo/その他のキャリアのクリック数。

au(softbank/docomo/others)_cost :
    au/Softbank/DoCoMo/その他のキャリアの収益。

au(softbank/docomo/others)_ctr :
    au/Softbank/DoCoMo/その他のキャリアのCTR。

au(softbank/docomo/others)_conv :
    au/Softbank/DoCoMo/その他のキャリアの成果数。

au(softbank/docomo/others)_cvr :
    au/Softbank/DoCoMo/その他のキャリアのCVR。


Comments