次の方法で共有

ネットワーク ビデオ分析

  • [アーティクル]

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

注:

  • ビデオ メトリックは VAST クリエイティブに対してのみ記録されます。
  • レポートを取得する手順については、 レポート サービス または以下の 例を 参照してください。

期限

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

データ保持期間

このレポートのデータは、420 日間保持されます。

注:

カスタム時間枠のレポートを実行するには、レポート要求の start_date フィールドと end_date フィールドを設定します。 これらのフィールドの詳細については、「 Report Service」を参照してください。

Dimensions

列 種類 フィルター。 例 説明
hour time はい "2010-02-01 06:00:00" オークションの時間。

注: 100 日を超えるインプレッションの場合、1 時間ではなく日が返されます。
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 日を超えるインプレッションの場合、配置は 1 行に集計され、placement_nameとして"All placement data older than 100 days"されます。
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 Service 」と「 Deal Buyer Access Service」を参照してください。
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 Buckets 」を参照してください。
creative_recency_bucket string はい "15-30 minutes" クリエイティブが表示された最近のバケット。 使用可能な値については 、以下の「Creative Recency Buckets 」を参照してください。
creative_frequency_bucket string はい "11-20" クリエイティブが表示された頻度のバケット。 使用可能な値については 、以下の「クリエイティブ頻度バケット 」を参照してください。
creative_frequency_bucket_id string いいえ "3" クリエイティブ頻度バケットの ID。 使用可能な値については 、以下の「クリエイティブ頻度バケット 」を参照してください。
site_domain string いいえ bestsiteever.com インプレッションが発生したドメイン。 モバイル アプリケーションの場合は、アプリ ストア内のアプリの場所の URL を指定できます。
ドメインの代わりに表示される 2 つの追加の値があります。具体的には、 "deals.unknown" または "managed.unknown"。 これは、有効なドメインを参照元として受け取らなかったことを意味します。 たとえば、ドメインが空白であるか、形式が正しくない場合があります。
mobile_application_id int はい 343200656 対象となる Apple App Store ID、Android アプリケーション ID、または Windows アプリケーション ID。
supply_type string はい "mobile_web" 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" Placement のサブディメンションとしてレポート可能な配置オブジェクトに追加されたエイリアス。 レポートにはエイリアスの現在の値が表示され、履歴値は反映されません。 この情報は販売者にのみ報告できます。
code_2 文字列 いいえ "Code B" Placement のサブディメンションとしてレポート可能な配置オブジェクトに追加されたエイリアス。 レポートにはエイリアスの現在の値が表示され、履歴値は反映されません。 この情報は販売者にのみ報告できます。
code_3 文字列 いいえ "Code C" Placement のサブディメンションとしてレポート可能な配置オブジェクトに追加されたエイリアス。 レポートにはエイリアスの現在の値が表示され、履歴値は反映されません。 この情報は販売者にのみ報告できます。

注:

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

  • 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 ユーザーのブラウザー (または仲介サーバー) に配信される応答の数。 応答すると、インプレッション、プレイヤーのエラー、またはインプレッション イベントのないオークションが発生する可能性があります。

注: imp は、ビデオ プレーヤーがビデオを読み込み、最初のフレームを開始するタイミングを指します。 [ビデオ配信] は、ビデオ プレーヤーからの要求に応じて提供される VAST ドキュメントを指します。
clicks int 1 クリック すべてのインプレッションに対するクリックの合計数。
cost お金 16.833378 費用 直接発行元と購入済みのリアルタイム インベントリのメディア コストの合計金額。
revenue お金 25.767257 booked_revenue + reseller_revenue 予約収益とリセラー収益の合計。
profit お金 0.084102 booked_revenue - total_cost 予約済み収益から合計コストを差し引いた金額。
cpm お金 1.66051685393258 (cost/imps) x 1000 1,000 インプレッションあたりのコスト。
total_convs int 5 total_convs ポストビューとクリック後のコンバージョンの合計数。
convs_rate double 0.000221877080097626 total_convs/imps インプレッションへのコンバージョン率。
ctr double 0.000221877080097626 clicks/imps インプレッションに対するクリック数の割合。
rpm お金 2.60548314606741 (revenue/imps) x 1000 1000 インプレッションあたりの収益。
rpm_including_fees お金 2.60548314606741 (revenue_including_fees/imps) x 1000 非推奨となる。 収益から 1,000 インプレッションあたりの手数料を差し引いた値。
total_network_rpm お金 2.60548314606741 (revenue/imps) x 1000 1000 インプレッションあたりの収益。
ppm お金 0.944966292134831 (profit/imps) x 1000 非推奨となる。 1000 インプレッションあたりの利益。
ppm_including_fees お金 0.662460674157303 (profit_including_fees/imps) x 1000 非推奨となる。 1000インプレッションあたりの追加料金を含む利益。
cpm_including_fees お金 2.60548314606741 (cost_including_fees/imps) x 1000 非推奨となる。 1,000 インプレッションあたりの追加料金を含むコスト。
errors int 5 エラー エラーが発生した回数の合計。
starts int 360 開始 ビデオ クリエイティブの最初のセグメントがダウンロードされ、開始された合計回数。
start_rate double 25.85 starts/imps ビデオの開始回数をインプレッション数で割った値です。
skips int 20 スキップ ユーザーがビデオをスキップした回数の合計。
skip_rate double 20.5 skips / imps ビデオスキップの数をインプレッション数で割った値。
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 completions / imps ビデオの完了数をインプレッション数で割った値。
render_rate double 60% render_rate ユーザーのブラウザーに配信された広告応答の数に基づいて配信されたビデオの割合。 (インプレッション数/広告応答)
revenue_per_video_complete double 15.869 revenue / completions ビデオ完了あたりの収益。
cost_per_video_complete double 2.056 コスト/完了 ビデオの完了あたりのコスト。
imps_viewed int 30,450 imps_viewed IAB Viewability 定義に従って表示可能だった測定されたインプレッションの数。これは、2 秒間にピクセルの 50% が表示されている場合に表示可能であることを示します。
view_measured_imps int 10,120 view_measured_imps 視認性のために測定されたインプレッションの合計数。
view_rate double 58% view_rate 視認性を測定したインプレッションの総数のうち、表示可能だったインプレッションの割合。 (表示された Imps/View Measured Imps)
view_measurement_rate double 45% view_measurement_rate 総インプレッション数のうち視認性を測定したインプレッションの割合。 (測定された Imps/Imps を表示する)
started_video_completion_rate double 85.45 completions / 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 imps あたりの合計コスト。
total_cost_ecpc お金 123.45 total_cost/クリック数 クリックあたりの合計コスト。
total_cost_ecpa お金 123.45 total_cost/変換 コンバージョンあたりの合計コスト。
network_profit お金 123.45 (booked_revenue + reseller_revenue) - total_cost 予約収益とリセラー収益の合計から合計コストを差し引いた合計。
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 imps あたりの利益。
profit_ecpc お金 123.45 (booked_revenue - total_cost)/クリック クリックあたりの利益。
profit_ecpa お金 123.45 (booked_revenue - total_cost)/conversions コンバージョンあたりの利益。
profit_margin お金 123.45 (booked_revenue - total_cost)/booked_revenue 買い手の利益マージン。
Average View Time int 28 sum (creative_duration * ((0.125 × starts) + (0.25 × first_quartiles) + (0.25 × second_quartiles) + (0.25 × third_quartiles) + (0.125 × completions)) / sum (starts)) 表示されたクリエイティブの平均継続時間 (小数点以下 0 桁に丸めた秒数) の見積もり。 これは、ビデオ イベント間の中間点として視聴時間を近似することによって計算されます (たとえば、開始イベントではクリエイティブの 12.5% が表示されると推定されます)。
Average View Time Percent 百分率 89% sum (((0.125 × starts) + (0.25 × first_quartiles) + (0.25 × second_quartiles) + (0.25 × third_quartiles) + (0.125 × completions))∕starts) 表示可能時間の合計に対する割合で表される平均表示時間。
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 Outstream

プレイヤーサイズ

ID 名前
0 small
1 medium
2 large

例

JSON 形式のレポート要求を作成する

JSON ファイルには、"video_analytics_network"のreport_typeと、取得する列 (ディメンションとメトリック) とreport_intervalが含まれている必要があります。 また、特定のディメンションをフィルター処理し、粒度 (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 行の制限があります。