ネットワーク ビデオ分析レポートを使用して、ネットワーク メンバーのビデオ イベント メトリックを表示できます。 特定の広告主またはパブリッシャーについてより詳細な分析を掘り下げるには、 ネットワーク ビデオ広告主の分析 レポートとネットワーク ビデオ パブリッシャー分析 レポートを参照してください。
注:
- ビデオ メトリックは、VAST クリエイティブに対してのみ記録されます。
- レポートを取得する手順については、「 Report Service 」または以下の 例 を参照してください。
時間枠
report_interval フィールドは、次のいずれかに設定できます。
- 今日
- yesterday
- last_hour
- last_24_hours
- last_48_hours
- month_to_date
- month_to_yesterday
- last_2_days
- last_7_days
- last_14_days
- last_30_days
- last_7_available_days
- last_14_available_days
- last_30_available_days
- last_365_days
データ保持期間
このレポートのデータの保持期間は次のとおりです。
- 時間単位のリテンション期間: 100 日
- 1 日あたりのリテンション期間: 500 日
注:
カスタムの時間枠でレポートを実行するには、レポート要求の start_date フィールドと end_date フィールドを設定します。 これらのフィールドの詳細については、「 Report Service」を参照してください。
Dimensions
| 列 | 種類 | フィルター? | 例 | 説明 |
|---|---|---|---|---|
hour |
time | はい | "2010-02-01 06:00:00" |
オークションの時間。 注: 100 日よりも前のインプレッションの場合は、時間ではなく日が返されます。 |
day |
time | はい | "2010-02-01" |
オークション当日。 |
month |
time | 不要 | "2010-02" |
オークションの月。 |
buyer_member_id |
int | はい | 123 |
購入メンバーの ID。 インプレッションが購入されていない場合、このフィールドには次のいずれかの値が表示されます。 229 = PSA 0 = 空白 319 = 既定値 |
buyer_member_name |
文字列 | いいえ | "My Network" |
購入メンバーの名前。 |
buyer_member |
文字列 | いいえ | "My Network (123)" |
非推奨です (2016 年 10 月 17 日現在)。 |
split_id |
int | はい | 342 |
このデータ セットのインプレッションを購入した分割の ID。 分割は、拡張広告申込情報にのみ適用されます。 キャンペーンを含むレポートでは、 split_id (含まれている場合) が nullされます。 |
split_name |
string | はい | "Mobile Split A" |
このデータ セットのインプレッションを購入した分割の名前。 分割は、拡張広告申込情報にのみ適用されます。 キャンペーンを含むレポートでは、 split_name (含まれている場合) が nullされます。 |
creative_id |
int | はい | 554 |
クリエイティブの ID。 注: 外部クリックまたはインプレッション トラッカーの場合、 creative_id は "External Clicks" または "External Imps"になります。 |
creative_name |
文字列 | いいえ | "Q1 2010 728x90" |
クリエイティブの名前。 注: 外部クリックまたはインプレッション トラッカーの場合、 creative_id は "External Clicks" または "External Imps"になります。 |
creative |
文字列 | いいえ | "Q1 2010 728x90 (554)" |
非推奨です (2016 年 10 月 17 日現在)。 |
member_id |
int | はい | 767 |
メンバーの ID。 |
seller_member_id |
int | はい | 456 |
販売メンバーの ID。 |
seller_member_name |
文字列 | いいえ | "That Seller" |
販売メンバーの名前。 |
seller_member |
文字列 | いいえ | "That Seller (456)" |
非推奨です (2016 年 10 月 17 日現在)。 |
advertiser_id |
int | はい | 789 |
広告主の ID。 値が 0 の場合は、インプレッションが外部購入者によって購入されたか、既定または PSA が表示された場合です。 |
advertiser_name |
文字列 | いいえ | "Verizon Wireless" |
広告主の名前。 |
advertiser |
文字列 | いいえ | "Verizon Wireless (789)" |
非推奨です (2016 年 10 月 17 日現在)。 |
advertiser_currency |
string | はい | "USD" |
広告主の通貨。 |
publisher_id |
int | はい | 321 |
発行元の ID。 |
publisher_name |
文字列 | いいえ | "Test" |
発行元の名前。 |
publisher |
文字列 | いいえ | "Test (123)" |
非推奨です (2016 年 10 月 17 日現在)。 |
publisher_currency |
string | はい | "USD" |
発行元の通貨。 |
site_id |
int | はい | 194 |
サイトの ID。 注: 100 日を超えるインプレッションの場合、 site_id は 0されます。 |
site_name |
文字列 | いいえ | "Site Name" |
サイトの名前。 |
site |
文字列 | いいえ | "Site Name (194)" |
非推奨です (2016 年 10 月 17 日現在)。 |
placement_id |
int | はい | 456 |
配置の ID。 注: 100 日を超えるインプレッションの場合、プレースメントは -1 を placement_idとして 1 つの行に集約されます。 |
placement_name |
文字列 | いいえ | "Ivillage 160x600" |
プレースメントの名前。 注: 100 日を超えるインプレッションの場合、プレースメントは "All placement data older than 100 days" を placement_nameとして 1 つの行に集約されます。 |
placement_code |
文字列 | いいえ | "Ivillage Code" |
配置のカスタム コード。 |
insertion_order_id |
int | はい | 321 |
広告掲載オーダーの ID。 |
insertion_order_name |
文字列 | いいえ | "Insertion Order" |
広告掲載オーダーの名前。 |
insertion_order |
文字列 | いいえ | "Insertion Order (321)" |
非推奨です (2016 年 10 月 17 日現在)。 |
line_item_id |
int | はい | 111 |
品目の ID。 |
line_item_name |
文字列 | いいえ | "Default Line Item" |
明細行品目の名前。 |
line_item |
文字列 | いいえ | "Default Line Item (111)" |
非推奨です (2016 年 10 月 17 日現在)。 |
line_item_code |
文字列 | いいえ | "Default Line Item Code" |
品目のカスタム コード。 |
campaign_id |
int | はい | 222 |
キャンペーンの ID。 |
campaign_name |
文字列 | いいえ | "Default Campaign" |
キャンペーンの名前。 |
campaign |
文字列 | いいえ | "Default Campaign (222)" |
非推奨です (2016 年 10 月 17 日現在)。 |
size |
string | はい | "728x90" |
配信されるプレースメント/クリエイティブのサイズ。 |
brand_id |
int | Tes | 3 |
クリエイティブに関連付けられているブランドの ID。
imp_type_id = 6については、このレポートの brand_id フィールドに情報はありません。 代わりに 、販売者ブランドレビューレポート をご覧ください。 |
brand_name |
文字列 | いいえ | "Ace Hardware" |
クリエイティブに関連付けられているブランドの名前。
imp_type_id = 6については、このレポートの brand_name フィールドに情報はありません。 代わりに 、販売者ブランドレビューレポート をご覧ください。 |
brand |
文字列 | いいえ | "Ace Hardware (3)" |
非推奨です (2016 年 10 月 17 日現在)。 |
geo_country |
string | はい | "US" |
対象の国/地域のコード。 |
geo_country_name |
文字列 | いいえ | "United States" |
対象の国/地域の名前。 |
deal_code |
文字列 | いいえ | External seller deal code |
取引のカスタム コード。 外部供給パートナーとの取引の場合、通常、この文字列が取引を識別します。 |
deal_id |
int | はい | 2345 |
取引の ID。 買い手と売り手の間で交渉された取引の詳細については、「 取引サービス 」と「 取引購入者アクセス サービス」を参照してください。 |
deal_name |
文字列 | いいえ | "Private deal for buyer 1085 with floor of $2.50" |
取引の名前。 |
deal |
文字列 | いいえ | "Private deal for buyer 1085 with floor of $2.50 (45)" |
非推奨です (2016 年 10 月 17 日現在)。 |
trafficker_for_insertion_order |
string | はい | "Maurice Truman" |
広告掲載オーダーのトラッカー。 詳しくは、広告掲載オーダー サービスの ["labels"] フィールドを参照してください。 |
salesrep_for_insertion_order |
string | はい | "Beverly Heller" |
広告掲載オーダーの営業担当者。 詳しくは、広告掲載オーダー サービスの ["labels"] フィールドを参照してください。 |
creative_recency_bucket_id |
string | いいえ | "4" |
クリエイティブの最新性バケットの ID。 可能な値については、以下の クリエイティブ最新性バケット を参照してください。 |
creative_recency_bucket |
string | はい | "15-30 minutes" |
クリエイティブが表示された期間のバケット。 可能な値については、以下の クリエイティブ最新性バケット を参照してください。 |
creative_frequency_bucket |
string | はい | "11-20" |
クリエイティブが表示された頻度のバケット。 可能な値については、以下の クリエイティブ頻度バケット を参照してください。 |
creative_frequency_bucket_id |
string | いいえ | "3" |
クリエイティブ フリークエンシー バケットの ID。 可能な値については、以下の クリエイティブ頻度バケット を参照してください。 |
site_domain |
string | いいえ | bestsiteever.com |
インプレッションが発生したドメイン。 モバイル アプリケーションの場合、これはアプリ ストア内のアプリの場所の URL にすることができます。 ドメインの代わりに表示される可能性のある追加の値、具体的には "deals.unknown" または "managed.unknown" の 2 つがあります。 これらは、参照元として有効なドメインを受け取っていないことを意味します。 たとえば、ドメインが空白であったり、形式が正しくないなどです。 |
mobile_application_id |
int | はい | 343200656 |
ターゲット可能な Apple App Store ID、Android アプリケーション ID、または Windows アプリケーション ID。 |
supply_type |
string | はい | "mobile_web" |
販売者分類チャネル。ウェブ、モバイルに最適化された Web、モバイル アプリのインプレッション数の観点から供給を単位的に分類します。 使用可能な値は次のいずれかです: - "web" - "mobile_app" - "mobile_web" |
video_playback_method |
string | はい | "1" |
クリエイティブの再生方法。 可能な値については、以下の ビデオ再生方法 を参照してください。 |
video_context |
string | はい | "3" |
ビデオ クリエイティブのタイプ。 可能な値については、以下の ビデオ コンテキスト を参照してください。 |
video_player_size_id |
string | はい | "2" |
ビデオ プレーヤーの幅の ID。 可能な値については、以下の プレイヤー サイズ を参照してください。 |
imp_type_id |
int | はい | 3 |
関連付けられているインプレッション タイプの ID。 使用可能な値: 次のように変換される整数値:0 = ビデオ イベント エラー1 = 空白: "200 OK" 応答 (空白) が提供されました。2 = PSA : 他に対象となるクリエイティブがなかったため、公共広告が配信されました。3 = 既定のエラー: タイムアウトの問題により提供される既定のクリエイティブ。4 = 既定: キャンペーンの入札がなかったか、対象となる他のクリエイティブがなかったため、提供された既定のクリエイティブ。5 = 保持: 管理対象広告主の 1 つがクリエイティブを配信しました。6 = 転売: インプレッションはサード パーティの購入者に販売されました。7 = RTB: サードパーティのインベントリで提供されるクリエイティブ。8 = PSA エラー: タイムアウトの問題により配信された公共サービスアナウンス。9 = 外部インプレッション: インプレッション トラッカーからのインプレッション。10 = 外部クリック: クリック トラッカーからのクリック。 |
bidder_id |
int | はい | 45 |
関連付けられている入札者の ID。 |
creative_duration |
int | はい | 30 |
ビデオ クリエイティブの長さ (秒単位)。 |
video_delivery_type |
文字列 | いいえ | "vod" |
ストリーミング コンテンツ配信の種類。 たとえば、Video On Demand (VOD) および Live などです。 |
video_content_genre |
文字列 | いいえ | "action" |
広告が再生される番組の主なジャンル。 たとえば、 Action、 Adventure、 Biography、 Business、 Comedy などです。 |
video_program_type |
文字列 | いいえ | "series" |
広告が再生されるビデオ プログラム フォーマットの上位レベルの分類。 たとえば、 Movie、 Series、 Special、 Show、 Event、 Clip などです。 |
video_content_rating |
文字列 | いいえ | "teens" |
パブリッシャーが特定した、コンテンツのレーティング対象のオーディエンス グループ。 たとえば、 All、 Children (7+) 、 Teens (13+)、 Young Adults (14+)、 Adults (18+) などです。 |
content_duration_secs |
int | はい | 480 |
ビデオ コンテンツの長さ (秒単位)。 |
device_type |
string | はい | - Desktops & Laptops- Mobile Phones- Tablets- TV- Game Consoles- Media Players- Set Top Box- Other Devices |
クリエイティブを再生するために設定されたデバイスの種類。 |
video_content_duration |
int | はい | 100 |
ビデオ コンテンツの長さ (秒単位)。 |
video_content_language |
文字列 | いいえ | "Spanish" |
広告が再生されるビデオ プログラムの言語。 たとえば、「 Spanish 」のように入力します。 |
video_content_network |
文字列 | いいえ | "AMC" |
ビデオ コンテンツを配信するネットワーク。 たとえば、 9 Story、 CBC、 Disney、 AMC、 Fox などです。 |
code_1 |
文字列 | いいえ | "Code A" |
配置オブジェクトに追加されたエイリアス。配置のサブディメンションとして報告できます。 このレポートには、エイリアスの現在の値が表示されますが、過去の値は反映されません。 この情報は出品者にのみ報告されます。 |
code_2 |
文字列 | いいえ | "Code B" |
配置オブジェクトに追加されたエイリアス。配置のサブディメンションとして報告できます。 このレポートには、エイリアスの現在の値が表示されますが、過去の値は反映されません。 この情報は出品者にのみ報告されます。 |
code_3 |
文字列 | いいえ | "Code C" |
配置オブジェクトに追加されたエイリアス。配置のサブディメンションとして報告できます。 このレポートには、エイリアスの現在の値が表示されますが、過去の値は反映されません。 この情報は出品者にのみ報告されます。 |
is_takeover |
ブール値 | はい | "Yes" |
マルチ広告要求の広告の少なくとも 1 つが引き継ぎであったために、インプレッションが Blanked か Defaulted かを示します。 インプレッションが引き継ぎ要求の一部である場合は true を返し、それ以外の場合は false を返します。 |
注:
次のディメンションのデータは、パブリッシャーが動画分類を実装している場合にのみ使用できます。
video_delivery_typevideo_content_genrevideo_program_typevideo_content_ratingvideo_content_durationvideo_content_languagevideo_content_network
指標
| 列 | 型 | 例 | 式 | 説明 |
|---|---|---|---|---|
imps |
int | 2340 |
imps | インプレッションの合計数 (配信と再販)。 |
ad_requests |
int | 1234 |
ad_requests | プレースメントに関連付けられている広告要求の数。 |
ad_responses |
int | 2340 |
ad_responses | ユーザーのブラウザー (または仲介サーバー) に配信された応答の数。 応答により、インプレッション、プレイヤーのエラー、またはインプレッション イベントのないオークションが発生する可能性があります。 注: インプとは、ビデオ プレーヤーがビデオを読み込んで最初のフレームを開始するタイミングを指します。 Videos Served(提供されるビデオ) とは、ビデオ プレーヤーからの要求に応答して提供される VAST ドキュメントを指します。 |
clicks |
int | 1 |
クリック数 | すべてのインプレッションに対するクリックの総数。 |
cost |
金銭 | 16.833378 |
cost | 直接パブリッシャーと購入したリアルタイム インベントリのメディア コストの合計金額。 |
revenue |
金銭 | 25.767257 |
booked_revenue + reseller_revenue | 予約収益とリセラー収益の合計。 |
profit |
金銭 | 0.084102 |
booked_revenue - total_cost | booked 収益から総コストを差し引いた金額。 |
cpm |
金銭 | 1.66051685393258 |
(コスト/インプ) x 1000 | インプレッション 1,000 回あたりのコスト。 |
total_convs |
int | 5 |
total_convs | 表示後とクリック後のコンバージョンの合計数。 |
convs_rate |
double | 0.000221877080097626 |
total_convs / imps | インプレッションに対するコンバージョン率。 |
ctr |
double | 0.000221877080097626 |
クリック数/インプ | クリック数対インプレッション数の割合。 |
rpm |
金銭 | 2.60548314606741 |
(収益/IMPS) x 1000 | インプレッション 1,000 回あたりの収益。 |
rpm_including_fees |
金銭 | 2.60548314606741 |
(revenue_including_fees / imps) x 1000 | 非推奨です。 収益から 1,000 インプレッションあたりの手数料を差し引いた金額。 |
total_network_rpm |
金銭 | 2.60548314606741 |
(収益/IMPS) x 1000 | インプレッション 1,000 回あたりの収益。 |
ppm |
金銭 | 0.944966292134831 |
(利益/ imps) x 1000 | 非推奨です。 インプレッション 1,000 回あたりの利益。 |
ppm_including_fees |
金銭 | 0.662460674157303 |
(profit_including_fees / imps) x 1000 | 非推奨です。 インプレッション 1,000 回あたりの追加料金を含む利益。 |
cpm_including_fees |
金銭 | 2.60548314606741 |
(cost_including_fees / imps) x 1000 | 非推奨です。 インプレッション 1,000 回あたりの追加料金を含む費用。 |
errors |
int | 5 |
エラー | エラーが発生した合計回数。 |
starts |
int | 360 |
starts | ビデオ クリエイティブの最初のセグメントがダウンロードされて開始された合計回数。 |
start_rate |
double | 25.85 |
開始 / INPS | 動画の開始回数をインプレッション数で割った値。 |
skips |
int | 20 |
スキップ | ユーザーが動画をスキップした合計回数。 |
skip_rate |
double | 20.5 |
スキップ / インプ | 動画のスキップ回数をインプレッション数で割った値。 |
25_pcts |
int | 780 |
25% 完了 | 動画クリエイティブが動画を完成した合計回数 (動画全体の 25%)。 |
50_pcts |
int | 654 |
50% 完了 | 動画が全時間の 50% を再生した合計回数。 |
75_pcts |
int | 567 |
75% 完了 | 動画が視聴した総回数 (全時間の 75%)。 |
completions |
int | 989 |
100% 完了 | 動画が全時間再生された合計回数。 |
completion_rate |
double | 85.45 |
完了数/IMP | 動画の完成回数をインプレッション数で割ったものです。 |
render_rate |
double | 60% |
render_rate | ユーザーのブラウザーに配信された広告応答の数に基づいて配信された動画の割合。 (インプレッション数/広告応答数) |
revenue_per_video_complete |
double | 15.869 |
収益/完了数 | ビデオの完了あたりの収益。 |
cost_per_video_complete |
double | 2.056 |
コスト/完了数 | ビデオの完了あたりのコスト。 |
imps_viewed |
int | 30,450 |
imps_viewed | IAB の視認性定義に従って、測定されたインプレッション数。IAB 視認性の定義に従って、ピクセルの 50% が連続して 2 秒間に表示されている場合にインプレッションは表示可能であることを示します。 |
view_measured_imps |
int | 10,120 |
view_measured_imps | 視認性について測定されたインプレッションの合計数。 |
view_rate |
double | 58% |
view_rate | 視認性について測定されたインプレッションの総数のうち、視認可能なインプレッションの割合。 (表示されたインプ/測定されたインプの表示) |
view_measurement_rate |
double | 45% |
view_measurement_rate | インプレッションの総数に対する視認性について測定されたインプレッションの割合。 (測定されたインプ/インプを表示) |
started_video_completion_rate |
double | 85.45 |
完了数/video_starts | 動画の視聴完了回数を動画再生開始回数で割った値。 |
total_cost |
金銭 | 123.45 |
total_cost = media_cost + data_costs + partner_fees + コミッション + serving_fees + publisher_revenue | 報告された期間に発生したコストの合計金額。 これには通常、予算コスト (メディア コスト、データ コスト、パートナー料金、サービス料金、手数料) とプラットフォームでパブリッシャーの支払いを追跡する場合のパブリッシャー収益の 2 種類のコストが含まれます。 注: 重大な変更期間中にサードパーティの手数料が二重にカウントされないようにするためのロジックを追加しました。 |
total_cost_ecpm |
金銭 | 123.45 |
(total_cost/imps) * 1,000 | 1,000 インプあたりの合計コスト。 |
total_cost_ecpc |
金銭 | 123.45 |
total_cost/クリック数 | クリック単価の合計。 |
total_cost_ecpa |
金銭 | 123.45 |
total_cost/コンバージョン | コンバージョンあたりの総コスト。 |
network_profit |
金銭 | 123.45 |
(booked_revenue + reseller_revenue) - total_cost | booked 収益とリセラー収益の合計から総コストを差し引いたもの。 |
network_profit_ecpm |
金銭 | 123.45 |
(network_profit/imps) * 1,000 | 1,000 imps あたりのネットワーク利益。 |
network_profit_ecpc |
金銭 | 123.45 |
network_profit/クリック数 | クリックあたりのネットワーク利益。 |
network_profit_ecpa |
金銭 | 123.45 |
network_profit/コンバージョン | コンバージョンあたりのネットワーク利益。 |
network_profit_margin |
金銭 | 123.45 |
network_profit/(booked_revenue + reseller_revenue) | ネットワークの利益率。 |
profit_ecpm |
金銭 | 123.45 |
((booked_revenue - total_cost)/imps) * 1,000 | 1,000 インプあたりの利益。 |
profit_ecpc |
金銭 | 123.45 |
(booked_revenue - total_cost)/クリック数 | クリックあたりの利益。 |
profit_ecpa |
金銭 | 123.45 |
(booked_revenue - total_cost)/コンバージョン | コンバージョンあたりの利益。 |
profit_margin |
金銭 | 123.45 |
(booked_revenue - total_cost)/booked_revenue | 購入者の利益率。 |
Average View Time |
int | 28 |
sum (creative_duration * ((0.125 ×開始) + (0.25 × first_quartiles) + (0.25 × second_quartiles) + (0.25 × third_quartiles) + (0.125 × の完了)) / sum (開始)) | 表示されたクリエイティブの平均時間 (秒単位) の推定値 (小数点以下 0 桁を四捨五入)。 これは、視聴された時間を動画イベント間の中間点として概算することによって計算されます (たとえば、開始イベントではクリエイティブの 12.5% が視聴されたと推定されます)。 |
Average View Time Percent |
パーセンテージ | 89% |
sum (((0.125 ×開始) + (0.25 × first_quartiles) + (0.25 × second_quartiles) + (0.25 × third_quartiles) + (0.125 × 完了))∕開始) | 平均視聴時間のことです。視聴可能な合計時間に対する割合で表されます。 |
fill_rate |
double | 85.00 |
(imps_resold+imps_kept)/total_ad_requests | オークションのために Xandr に送信された広告要求の総数に対するインプレッションの総数 (転売とリテンション) の割合。 |
クリエイティブ頻度バケット
| バケット ID | バケット名 |
|---|---|
-2 |
"no-cookie-date" |
-1 |
"no-cookie" |
0 |
"0" |
1 |
"1" |
2 |
"2-5" |
3 |
"6-10" |
4 |
"11-20" |
5 |
"21-40" |
6 |
"41-60" |
7 |
"61-100" |
8 |
"101-150" |
9 |
"151-250" |
10 |
"251-500" |
11 |
"500+" |
クリエイティブ最新性バケット
| バケット ID | バケット名 |
|---|---|
-2 |
"no-cookie-date" |
-1 |
"no-cookie" |
0 |
"< 1 minute" |
1 |
"1-5 minutes" |
2 |
"5-15 minutes" |
3 |
"15-30 minutes" |
4 |
"30-60 minutes" |
5 |
"1-4 hours" |
6 |
"4-12 hours" |
7 |
"12-24 hours" |
8 |
"1-2 days" |
9 |
"2-7 days" |
10 |
"8-14 days" |
11 |
"14-30 days" |
ビデオの再生方法
| メソッド ID | メソッド |
|---|---|
0 |
不明 |
1 |
自動再生、サウンド オン |
2 |
自動再生、サウンド オフ |
3 |
クイック再生 |
4 |
マウス オーバー |
5 |
自動再生、不明音 |
ビデオのコンテキスト
| メソッド ID | メソッド |
|---|---|
0 |
不明 |
1 |
ロール前 |
2 |
ロール中 |
3 |
ロール後 |
4 |
アウトストリーム |
プレイヤーのサイズ
| ID | 名前 |
|---|---|
0 |
small |
1 |
medium |
2 |
large |
例
JSON 形式のレポート要求を作成する
JSON ファイルには、取得する列 (ディメンションとメトリック) とreport_intervalだけでなく、"video_analytics_network"のreport_typeを含める必要があります。 また、特定のディメンションをフィルター処理したり、粒度 (year、 month、 day) を定義したり、データを返す形式 (csv、 excel、 html) を指定したりすることもできます。 JSON ファイルに含めることができるフィールドの詳細については、「 レポート サービス」を参照してください。
$ cat video_analytics_network
{
"report":
{
"report_type":"video_analytics_network",
"columns":[
"hour",
"seller_member_id",
"buyer_member_id",
"advertiser_id",
"publisher_id",
"imps",
"ad_requests",
"ad_responses",
"25_pcts",
"completions",
"completion_rate",
"convs_rate"
],
"report_interval":"last_48_hours",
"format":"csv"
}
}
POST レポート サービスへの要求
$ curl -b cookies -c cookies -X POST -d @video_analytics_network 'https://api.appnexus.com/report'
{
"response":{
"status":"OK",
"report_id":"097f59fc3ab7d02c5d60db42081d9b69"
}
}
GET レポート サービスからのレポートの状態
レポート ID を使用して GET 呼び出しを行い、レポートの状態を取得します。
execution_statusが"ready"されるまでこの呼び出しを続けます。 次に、 レポート ダウンロード サービスを使用して、レポート データをファイルに保存します (次の手順で説明します)。
$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=097f59fc3ab7d02c5d60db42081d9b69'
{
"response":{
"status":"OK",
"report":{
"name":null,
"created_on":"2010-05-25 19:19:53",
"json_request":"{\"report\":{\"report_type\":\"video_analytics_network\",\"columns\":[\"hour\",\"seller_member_id\",
\"buyer_member_id\",\"advertiser_id\",\"publisher_id\",\"imps\",\"25_pcts\",\"completions\",\"completion_rate\",\"convs_rate\"],
\"row_per\":[\"hour\",\"seller_member_id\",\"buyer_member_id\",\"advertiser_id\",\"publisher_id\"],
\"report_interval\":\"last_48_hours\"}}",
"url": "report-download?id=b97897a7864dd8f34e7457226c7af592"
},
"execution_status":"ready"
}
}
GET レポート ダウンロード サービスからのレポート データ
レポート データをファイルにダウンロードするには、レポート ID を使用して別の GET 呼び出しを行います。今回は レポート ダウンロード サービスに対して呼び出します。 サービスとレポート ID は、前のGET応答の url フィールドにあります。 保存するファイルを特定する際は、最初のPOSTで指定した"format"のファイル拡張子を使用してください。
注:
ダウンロード中にエラーが発生した場合、応答ヘッダーには HTTP エラー コードとメッセージが含まれます。 呼び出しで -i または -v を使用して、応答ヘッダーを公開します。
$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/video_analytics_network.csv
注:
XLSX および Excel ファイルとしてダウンロードする場合、レポートごとに 100,000 行の制限があります。