ネットワーク パブリッシャー動画分析レポートを使用すると、ネットワーク内の特定のパブリッシャーのビデオ イベント指標を、ネットワーク動画分析レポートで提供されるデータよりも細かく表示できます。 このレポートは、ネットワーク ユーザーのみが利用できます。
注:
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
データ保持期間
このレポートのデータの保持期間は次のとおりです。
- 時間単位のリテンション期間: 100 日
- 1 日あたりのリテンション期間: 500 日
注:
カスタムの時間枠でレポートを実行するには、レポート要求の start_date フィールドと end_date フィールドを設定します。 これらのフィールドの詳細については、「 Report Service」を参照してください。
Dimensions
| 列 | 種類 | フィルター? | 例 | 説明 |
|---|---|---|---|---|
hour |
date | いいえ | "2010-02-01 06:00:00" |
オークションの時間 注: 100 日よりも前のインプレッションの場合は、時間ではなく日が返されます。 |
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_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 日を超えるインプレッションの場合、プレースメントは "All placement data older than 100 days" を placement_nameとして 1 つの行に集約されます。 |
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" - "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 などです。 |
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 | インプレッションの合計数。 |
clicks |
int | 545 |
クリック数 | すべてのインプレッションに対するクリックの総数。 |
total_convs |
int | 90 |
post_click_convs + post_view_convs | 表示後とクリック後のコンバージョンの合計数。 |
ctr |
double | 0.2327836 |
クリック数/インプ * 100 | クリック数対インプレッション数の割合。 |
convs_rate |
double | 0.0384413 |
total_convs / インプ * 100 | インプレッションに対するコンバージョン率。 |
network_revenue |
金銭 | 1201.13 |
network_revenue | 直接の広告主を通じて予約され、リアルタイムの購入者に再販売されたネットワーク収益 |
total_network_rpm |
金銭 | 2.60548314606741 |
(network_revenue / imps) x 1000 | インプレッション 1,000 回あたりのネットワーク収益。 |
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 |
(収益/INPS) x 1000 -----エラーなし | エラーではなかったインプレッション 1,000 回あたりの収益。 |
total_publisher_rpm |
金銭 | 1.66051685393258 |
(コスト/インプ) x 1000 | 直接のパブリッシャーとサードパーティのパブリッシャーに支払われたインプレッション 1,000 件あたりのコスト (エラーを含む)。 |
sold_publisher_rpm |
double | 147.786 |
(コスト/IMPS) x 1000 -----エラーなし | 直接のパブリッシャーとサードパーティのパブリッシャーに支払われたインプレッション 1,000 回あたりのコスト (エラーを含まない)。 |
network_ppm |
金銭 | 9.23 |
(利益/ imps) x 1000 | 非推奨です。 インプレッション 1,000 回あたりの利益。 |
imps_sold |
int | 42500 |
imps_sold | あなたが他のメンバーに販売したインプレッション数。 |
video_errors |
int | 23 |
エラー | 動画インプレッション配信エラーの合計数 |
ad_responses |
int | 2340 |
served。 | ユーザーのブラウザー (または仲介サーバー) に配信された応答の数。 応答により、インプレッション、プレイヤーのエラー、またはインプレッション イベントのないオークションが発生する可能性があります。 注: インプとは、ビデオ プレーヤーがビデオを読み込んで最初のフレームを開始するタイミングを指します。 Videos Served(提供されるビデオ) とは、ビデオ プレーヤーからの要求に応答して提供される 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 | 視認性について測定されたインプレッションの総数のうち、視認可能なインプレッションの割合。 (表示されたインプ/測定されたインプの表示) |
view_measurement_rate |
double | 45% |
view_measurement_rate | インプレッションの総数に対する視認性について測定されたインプレッションの割合。 (測定されたインプ/インプを表示) |
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_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)/コンバージョン | コンバージョンあたりのネットワーク利益。 |
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 ×開始) + (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 × 完了))∕開始) | 平均視聴時間のことです。視聴可能な合計時間に対する割合で表されます。 |
ビデオの再生方法
| メソッド ID | メソッド |
|---|---|
0 |
不明 |
1 |
自動再生、サウンド オン |
2 |
自動再生、サウンド オフ |
3 |
クイック再生 |
4 |
マウス オーバー |
5 |
自動再生、不明音 |
ビデオのコンテキスト
| メソッド ID | メソッド |
|---|---|
0 |
不明 |
1 |
ロール前 |
2 |
ロール中 |
3 |
ロール後 |
4 |
アウトストリーム |
プレイヤーのサイズ
| 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 行の制限があります。