ネットワークパブリッシャーのビデオ分析
Network Publisher Video Analytics レポートを使用すると、ネットワーク内の特定のパブリッシャーのビデオ イベント メトリックを表示できます。これは、Network Video Analytics レポートで提供されるデータよりも詳細です。 このレポートは、ネットワーク ユーザーのみが使用できます。
注:
video_content_genre
ビデオ メトリックは VAST クリエイティブに対してのみ記録されます。
使用手順については、以下の 例 を参照してください。 このレポートでは、次のような URL の一部として発行元 ID を指定する必要があることに注意してください。
https://api.appnexus.com/report?publisher_id=PUBLISHER_ID
期限
report_interval
フィールドは、次のいずれかに設定できます。
- 今日
- yesterday
- last_24_hours
- last_48_hours
- last_2_days
- last_7_days
- last_14_days
- last_30_days
- month_to_date
- month_to_yesterday
- last_available_day
- last_7_available_days
- last_14_available_days
- last_30_available_days
- last_month
データ保持期間
このレポートのデータは、420 日間保持されます。
注:
カスタム時間枠のレポートを実行するには、レポート要求の start_date
フィールドと end_date
フィールドを設定します。 これらのフィールドの詳細については、「 Report Service」を参照してください。
Dimensions
列 | 種類 | フィルター。 | 例 | 説明 |
---|---|---|---|---|
hour |
date | いいえ | "2010-02-01 06:00:00" |
オークションの時間 注: 100 日を超えるインプレッションの場合、1 時間ではなく日が返されます。 |
day |
date | いいえ | "2010-02-01" |
オークションの日。 |
month |
date | いいえ | "2010-02" |
オークションの月。 |
member_id |
int | はい | 767 |
メンバーの ID。 |
buyer_member_id |
int | はい | 567 |
購入メンバーの ID。 |
buyer_member_name |
string | いいえ | "Network" |
購入メンバーの名前。 |
advertiser_id |
int | はい | 728 |
広告主の ID。 |
advertiser_name |
string | いいえ | "Test" |
広告主の名前。 |
brand_id |
int | はい | 3 |
クリエイティブに関連付けられているブランドの ID。
imp_type_id = 6 の場合、このレポートの [brand_id ] フィールドには情報がありません。 代わりに 販売者ブランドレビューレポート を参照してください。 |
brand_name |
string | いいえ | "Ace Hardware" |
クリエイティブに関連付けられているブランドの名前。
imp_type_id = 6 の場合、このレポートの [brand_name ] フィールドには情報がありません。 代わりに 販売者ブランドレビューレポート を参照してください。 |
publisher_id |
int | はい | 6787 |
発行元を識別する番号。 |
publisher_currency |
string | はい | "USD" |
発行元の通貨。 |
site_id |
int | はい | 194 |
サイトの ID。 注: 100 日を超えるインプレッションの場合、 site_id は 0 されます。 |
site_name |
string | いいえ | "Site Name" |
サイトの名前。 |
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" |
取引の名前。 |
geo_country |
string | はい | "US" |
地理的な国/地域コード。 |
geo_country_name |
string | いいえ | "United States" |
国/地域の名前です。 |
placement_id |
int | はい | 546 |
配置の ID。 注: 100 日を超えるインプレッションの場合、配置は 1 行に集計され、 placement_id として-1 されます。 |
placement_name |
string | いいえ | "300x250 Business" |
配置の名前。 注: 100 日を超えるインプレッションの場合、配置は 1 行に集計され、 placement_name として"All placement data older than 100 days" されます。 |
placement_code |
string | いいえ | "300x250 Business Code" |
配置のカスタム コード。 |
site_domain |
string | いいえ | bestsiteever.com |
インプレッションのサイト ドメイン。 |
application_id |
string | はい |
'343200656' (iOS) または 'com.rovio.angrybirds'(Android) |
対象となる Apple App Store ID、Google Play パッケージ名、または 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。 使用可能な値については、以下の 「プレイヤー サイズ 」を参照してください。 |
video_delivery_type1 |
文字列 | いいえ | "vod" |
ストリーミング コンテンツ配信の種類。 たとえば、Video On Demand (VOD) および Live などです。 |
video_content_genre1 |
文字列 | いいえ | "action" |
広告が再生されるプログラムのメインジャンル。 たとえば、 Action 、 Adventure 、 Biography 、 Business 、 Comedy などです。 |
video_program_type1 |
文字列 | いいえ | "series" |
広告が再生されるビデオ プログラムの形式の上位レベルの分類。 たとえば、 Movie 、 Series 、 Special 、 Show 、 Event 、 Clip などです。 |
video_content_rating1 |
文字列 | いいえ | "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, and Other Devices . |
クリエイティブが再生するように設定されたデバイスの種類。 |
video_content_duration1 |
int | はい | 100 |
ビデオ コンテンツの長さ (秒単位)。 |
video_content_language1 |
文字列 | いいえ | "Spanish" |
広告が再生されるビデオ プログラムの言語。 たとえば、「 Spanish 」のように入力します。 |
video_content_network1 |
文字列 | いいえ | "AMC" |
ビデオ コンテンツを配信するネットワーク。 たとえば、 9 Story 、 CBC 、 Disney 、 AMC 、 Fox などです。 |
注:
次のディメンションのデータは、パブリッシャーがビデオ分類を実装している場合にのみ使用できます。
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 | 合計インプレッション数。 |
clicks |
int | 545 |
クリック | すべてのインプレッションに対するクリックの合計数。 |
total_convs |
int | 90 |
post_click_convs + post_view_convs | ポストビューとクリック後のコンバージョンの合計数。 |
ctr |
double | 0.2327836 |
clicks / imps * 100 | インプレッションに対するクリック数の割合。 |
convs_rate |
double | 0.0384413 |
total_convs/imps * 100 | インプレッションへのコンバージョン率。 |
network_revenue |
お金 | 1201.13 |
network_revenue | 直接広告主を通じて予約され、リアルタイムバイヤーに再販されたネットワーク収益 |
total_network_rpm |
お金 | 2.60548314606741 |
(network_revenue/imps) x 1000 | 1000 インプレッションあたりのネットワーク収益。 |
publisher_revenue |
お金 | 400.05 |
publisher_revenue | パブリッシャーに支払われた収益 (revshare または cpm に基づく)。 |
network_profit |
お金 | 801.08 |
(booked_revenue + reseller_revenue) - total_cost | ネットワーク利益から総コストを差し引いた値。 |
network_roi |
double | 2.94 |
(network_revenue/media_cost) - 1 | 非推奨となる。 ネットワーク投資収益率。 パーセンテージとして返されます(例: 0.94 = 94%) |
sold_network_rpm |
double | 231.888 |
(revenue/imps) x 1000 -----エラーなし | エラーではない 1,000 インプレッションあたりの収益。 |
total_publisher_rpm |
お金 | 1.6605168 5393258 |
(cost/imps) x 1000 | ダイレクトおよびサード パーティのパブリッシャーに支払われた 1,000 インプレッションあたりのコスト (エラーを含む)。 |
sold_publisher_rpm |
double | 147.786 |
(コスト/imps) x 1000 -----エラーなし | 直接およびサード パーティのパブリッシャーに支払われた 1,000 インプレッションあたりのコスト。エラーは含まれません。 |
network_ppm |
お金 | 9.23 |
(profit/imps) x 1000 | 非推奨となる。 1000 インプレッションあたりの利益。 |
imps_sold |
int | 42500 |
imps_sold | 他のメンバーに販売したインプレッションの数。 |
video_errors |
int | 23 |
エラー | ビデオインプレッションを配信するエラーの合計数 |
ad_responses |
int | 2340 |
提供 | ユーザーのブラウザー (または仲介サーバー) に配信される応答の数。 応答すると、インプレッション、プレイヤーのエラー、またはインプレッション イベントのないオークションが発生する可能性があります。 注: imp は、ビデオ プレーヤーがビデオを読み込み、最初のフレームを開始するタイミングを指します。 [ビデオ配信] は、ビデオ プレーヤーからの要求に応じて提供される VAST ドキュメントを指します。 |
imps_viewed |
int | 30,450 |
imps_viewed | IAB ビューアビリティ定義に従って表示可能だった測定されたインプレッションの数。これは、1 秒間にピクセルの 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 を表示する) |
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_ecpm |
お金 | 123.45 |
((booked_revenue + reseller_revenue - total_cost)/imps) * 1,000 | 1,000 imps あたりのネットワーク利益。 |
network_profit_ecpc |
お金 | 123.45 |
(booked_revenue + reseller_revenue - total_cost)/クリック | クリックあたりのネットワーク利益。 |
network_profit_ecpa |
お金 | 123.45 |
(booked_revenue + reseller_revenue - total_cost)/conversions | コンバージョンあたりのネットワーク利益。 |
network_profit_margin |
お金 | 123.45 |
(booked_revenue + reseller_revenue - total_cost)/(booked_revenue + reseller_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) | 表示可能時間の合計に対する割合で表される平均表示時間。 |
ビデオ再生方法
メソッド ID | メソッド |
---|---|
0 |
不明 |
1 |
自動再生、サウンドオン |
2 |
自動再生、サウンドオフ |
3 |
クリックして再生する |
4 |
マウス オーバー |
5 |
自動再生、不明なサウンド |
ビデオ コンテキスト
メソッド ID | メソッド |
---|---|
0 |
不明 |
1 |
プリロール |
2 |
ミッドロール |
3 |
ポストロール |
4 |
Outstream |
プレイヤーサイズ
ID | 名前 |
---|---|
0 |
small |
1 |
medium |
2 |
large |
例
JSON 形式のレポート要求を作成する
$ cat video_analytics_network_publisher
{
"report":
{
"report_type":"video_analytics_network_publisher",
"columns":[
"hour",
"buyer_member",
"brand_name",
"deal_name",
"deal_id",
"imps_sold",
"video_errors",
"total_convs",
"served"
],
"row_per":[
"hour",
"buyer_member",
"sold_network_rpm"
],
"report_interval":"last_48_hours",
"format":"csv"
}
}
POST
レポート サービスへの要求
$ curl -b cookies -c cookies -X post -d @video_analytics_network_publisher "https://api.appnexus.com/report?publisher_id=4642"
{
"response":{
"status":"OK",
"report_id":"f4ebb93755dd01dde4fc157f86198ea9"
}
}
GET
レポート サービスからのレポートの状態
レポート ID を使用して GET
呼び出しを行って、レポートの状態を取得します。
execution_status
が"ready"
されるまで、このGET
呼び出しを行い続けます。 次の手順で説明するように、 レポート ダウンロード サービスを使用してレポート データをファイルに保存します。
$ curl -b cookies -c cookies "https://api.appnexus.com/report?id=f4ebb93755dd01dde4fc157f86198ea9"
{
"response":{
"status":"OK",
"report":{
"name":null,
"created_on":"2010-05-25 19:37:31",
"json_request":"{\"report\":{\"report_type\":\"video_analytics_network_publisher\",\"columns\":[\"hour\",\"buyer_member\",\"brand_name\",
\"deal_name\",\"deal_id\",\"imps_sold\",\"video_errors\",\"total_convs\",\"served\"],
\"row_per\":[\"hour\",\"buyer_member\",\"sold_network_rpm\"],\"report_interval\":\"last_48_hours\",
\"filters\":[{\"publisher_id\":\"4642\"}]}}",
"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_publisher.csv
注:
XLSX および Excel ファイルとしてダウンロードする場合、レポートごとに 100,000 行の制限があります。