ネットワーク ビデオ分析

ネットワーク ビデオ分析レポートを使用して、ネットワーク メンバーのビデオ イベント メトリックを表示できます。 特定の広告主またはパブリッシャーについてより詳細な分析を掘り下げるには、 ネットワーク ビデオ広告主の分析 レポートとネットワーク ビデオ パブリッシャー分析 レポートを参照してください。

注:

  • ビデオ メトリックは、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_id0されます。
site_name 文字列 いいえ "Site Name" サイトの名前。
site 文字列 いいえ "Site Name (194)" 推奨です (2016 年 10 月 17 日現在)。
placement_id int はい 456 配置の ID。

: 100 日を超えるインプレッションの場合、プレースメントは -1placement_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" 広告が再生される番組の主なジャンル。 たとえば、 ActionAdventureBiographyBusinessComedy などです。
video_program_type 文字列 いいえ "series" 広告が再生されるビデオ プログラム フォーマットの上位レベルの分類。 たとえば、 MovieSeriesSpecialShowEventClip などです。
video_content_rating 文字列 いいえ "teens" パブリッシャーが特定した、コンテンツのレーティング対象のオーディエンス グループ。 たとえば、 AllChildren (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 StoryCBCDisneyAMCFox などです。
code_1 文字列 いいえ "Code A" 配置オブジェクトに追加されたエイリアス。配置のサブディメンションとして報告できます。 このレポートには、エイリアスの現在の値が表示されますが、過去の値は反映されません。 この情報は出品者にのみ報告されます。
code_2 文字列 いいえ "Code B" 配置オブジェクトに追加されたエイリアス。配置のサブディメンションとして報告できます。 このレポートには、エイリアスの現在の値が表示されますが、過去の値は反映されません。 この情報は出品者にのみ報告されます。
code_3 文字列 いいえ "Code C" 配置オブジェクトに追加されたエイリアス。配置のサブディメンションとして報告できます。 このレポートには、エイリアスの現在の値が表示されますが、過去の値は反映されません。 この情報は出品者にのみ報告されます。
is_takeover ブール値 はい "Yes" マルチ広告要求の広告の少なくとも 1 つが引き継ぎであったために、インプレッションが BlankedDefaulted かを示します。 インプレッションが引き継ぎ要求の一部である場合は true を返し、それ以外の場合は false を返します。

注:

次のディメンションのデータは、パブリッシャーが動画分類を実装している場合にのみ使用できます。

  • video_delivery_type
  • video_content_genre
  • video_program_type
  • video_content_rating
  • video_content_duration
  • video_content_language
  • video_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を含める必要があります。 また、特定のディメンションをフィルター処理したり、粒度 (yearmonthday) を定義したり、データを返す形式 (csvexcelhtml) を指定したりすることもできます。 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 行の制限があります。