ネットワーク広告主のビデオ分析
ネットワーク広告主 Video Analytics レポートを使用すると、Network Video Analytics レポートで提供されるデータよりも詳細な特定の広告主のビデオ イベント メトリックを表示できます。 このレポートは、ネットワーク ユーザーのみが使用できます。
注:
ビデオ メトリックは VAST クリエイティブに対してのみ記録されます。
使用手順については、以下の 例 を参照してください。 このレポートでは、次のような URL の一部として広告主 ID を指定する必要があることに注意してください。
https://api.appnexus.com/report?advertiser_id=ADVERTISER_ID
期限
report_interval フィールドは、次のいずれかに設定できます。
- 今日
- yesterday
- last_24_hours
- last_48_hours
- last_2_days
- last_7_days
- last_14_days
- last_30_days
- last_available_day
- last_7_available_days
- last_14_available_days
- last_30_available_days
- month_to_date
- month_to_yesterday
- last_month
- last_365_days
データ保持期間
このレポートのデータは、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 | date | 2010-02 |
年の月。 |
seller_member_id |
int | はい | 567 |
販売メンバーの内部 ID。 |
seller_member_name |
文字列 | いいえ | "AdMeld" |
販売メンバーの表示名。 |
seller_member |
文字列 | いいえ | "AdMeld (567)" |
非推奨。 |
advertiser_id |
int | はい | 344 |
キャンペーンとクリエイティブがインプレッションで提供された広告主の内部 ID。 |
campaign_id |
int | はい | 728 |
キャンペーンを識別する番号。 |
campaign_name |
文字列 | いいえ | "Test" |
キャンペーンの表示名 |
campaign |
文字列 | いいえ | "Test (123)" |
非推奨。 |
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_name は "External Clicks" または "External Imps"されます。 |
creative |
文字列 | いいえ | "Q1 2010 728x90 (554)" |
非推奨。 |
placement_id |
int | はい | 567 |
配置の ID。 注: 100 日を超えるインプレッションの場合、配置は 1 行に集計され、 placement_idとして-1されます。 |
placement_name |
文字列 | いいえ | "Photos 728x90" |
配置の名前。 注: 100 日を超えるインプレッションの場合、配置は 1 行に集計され、 placement_nameとして"All placement data older than 100 days"されます。 |
placement |
文字列 | いいえ | "Photos 728x90 (123)" |
非推奨。 |
placement_code |
文字列 | いいえ | "Placement Code" |
配置のカスタム コード。 |
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)" |
非推奨。 |
size |
string | はい | "728x90" |
クリエイティブ/プレースメントのサイズ |
geo_country |
string | はい | "US" |
地理的国コード |
geo_country_name |
文字列 | いいえ | "Unites States" |
国の名前 |
creative_recency_bucket |
string | はい | "11-20" |
クリエイティブが表示された最近のバケット。 使用可能な値については 、以下の「Creative Recency Buckets 」を参照してください。 |
creative_recency_bucket_id |
文字列 | いいえ | "4" |
クリエイティブのレジェンシー バケットの ID。 使用可能な値については 、以下の「Creative Recency Buckets 」を参照してください。 |
creative_frequency_bucket |
string | はい | "15-30 minutes" |
クリエイティブが表示された頻度のバケット。 使用可能な値については 、以下の「クリエイティブ頻度バケット 」を参照してください。 |
creative_frequency_bucket_id |
文字列 | いいえ | "3" |
クリエイティブ頻度バケットの ID。 使用可能な値については 、以下の「クリエイティブ頻度バケット 」を参照してください。 |
insertion_order_id |
int | はい | 654 |
挿入順序の ID |
insertion_order_name |
文字列 | いいえ | "Insertion Order Name" |
挿入順序の名前 |
insertion_order |
文字列 | いいえ | "Insertion Order Name (654)" |
非推奨。 |
line_item_id |
int | はい | 932 | 行項目を識別する番号 |
line_item_name |
文字列 | いいえ | "$3 CPM Verizon Remarketing" |
明細の表示名 |
line_item |
文字列 | いいえ | "$3 CPM Verizon Remarketing (932)" |
非推奨。 |
publisher_id |
int | はい | 321 |
発行元を識別する番号 |
publisher_name |
文字列 | いいえ | "Test" |
発行元の表示名 |
publisher |
文字列 | いいえ | "Test (123)" |
非推奨。 |
trafficker_for_insertion_order |
string | はい | "Chris Mack" |
挿入順序の入稿者。 詳細については、挿入注文サービスの ["labels"] フィールドを参照してください。 |
salesrep_for_insertion_order |
string | はい | "Jonathan Smith" |
挿入指図の営業担当者。 詳細については、挿入注文サービスの ["labels"] フィールドを参照してください。 |
site_domain |
string | いいえ | bestsiteever.com |
インプレッションが発生したドメイン。 モバイル アプリケーションの場合は、アプリ ストア内のアプリの場所の URL を指定できます。 ドメインの代わりに表示される 2 つの追加の値があります。具体的には、 "deals.unknown" または "managed.unknown"。 これは、有効なドメインを参照元として受け取らなかったことを意味します。 たとえば、ドメインが空白であるか、形式が正しくない場合があります。 |
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_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, and Other Devices. |
クリエイティブが再生するように設定されたデバイスの種類。 |
video_content_duration |
int | はい | 100 |
ビデオ コンテンツの長さ (秒単位)。 |
video_content_language |
文字列 | いいえ | "Spanish" |
広告が再生されるビデオ プログラムの言語。 たとえば、「 Spanish 」のように入力します。 |
video_content_network |
文字列 | いいえ | "AMC" |
ビデオ コンテンツを配信するネットワーク。 たとえば、 9 Story、 CBC、 Disney、 AMC、 Foxなどです。 |
video_delivery_type |
文字列 | いいえ | "vod" |
ストリーミング コンテンツ配信の種類。 たとえば、Video On Demand (VOD) および Live などです。 |
注:
次のディメンションのデータは、パブリッシャーがビデオ分類を実装している場合にのみ使用できます。
video_content_genrevideo_program_typevideo_content_ratingvideo_content_durationvideo_content_languagevideo_content_networkvideo_delivery_typ
指標
| 列 | 型 | 例 | 式 | 説明 |
|---|---|---|---|---|
imps |
int | 234123 |
imps | 配信されたインプレッションの合計数。 |
clicks |
int | 545 |
クリック | すべてのインプレッションに対するクリックの合計数。 |
post_view_convs |
int | 75 |
post_view_convs | 記録されたポストビューコンバージョンの合計数。 |
post_click_convs |
int | 15 |
post_click_convs | クリック後に記録されたコンバージョンの合計数。 |
total_convs |
int | 90 |
post_click_convs + post_view_convs | ポストビューとクリック後のコンバージョンの合計数。 |
convs_rate |
double | 0.0003844 |
total_convs/imps | インプレッションへのコンバージョン率。 |
post_view_convs_rate |
double | 0.000320 |
post_view_convs/imps | 表示後のインプレッションへのコンバージョン率。 |
post_click_convs_rate |
double | 0.000064 |
post_click_convs/imps | クリック後のインプレッションへのコンバージョン率。 |
ctr |
double | 0.2327836 |
clicks/imps | インプレッションに対するクリック数の割合。 |
profit |
お金 | 350.00 |
booked_revenue - total_cost | 予約済み収益から合計コストを差し引いた金額。 |
revenue_ecpm |
お金 | 1.9221 |
booked_revenue/クリック数 | 1,000 インプレッションあたりの総収益。 |
cost_ecpm |
お金 | 0.4271259 |
media_cost/imps * 1,000 | 1,000 インプレッションあたりのコスト。 |
profit_ecpm |
お金 | 0.4949 |
profit/imps * 1,000 | 1000 インプレッションあたりの利益。 "利益" は、予約収益から合計コストを差し引いた値として定義されます。 |
revenue_ecpc |
お金 | 0.8256 |
booked_revenue/クリック数 | クリックあたりの総収益。 |
revenue_ecpa |
お金 | 5.00 |
booked_revenue/total_convs | コンバージョンあたりの合計収益。 |
cost_ecpc |
お金 | 0.1834 |
media_cost/クリック数 | クリックあたりのコスト。 |
cost_ecpa |
お金 | 1.1111 |
media_cost/total_convs | 取得/変換あたりのコスト。 |
profit_margin |
お金 | 0.7778 |
profit/booked_revenue | 利益を booked_revenueで割った。 "利益" は、予約収益から合計コストを差し引いた値として定義されます。 |
media_cost |
お金 | 100.00 |
media_cost | 合計金額。 |
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 | ビデオの完了数をインプレッション数で割った値。 |
revenue_per_video_complete |
double | 15.869 |
revenue / completions | ビデオ完了あたりの収益。 |
cost_per_video_complete |
double | 2.056 |
コスト/完了 | ビデオの完了あたりのコスト。 |
served |
int | 87649 |
配信されたビデオインプレッション数 | 配信されたビデオインプレッションの合計数。 注: 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/変換 | コンバージョンあたりの合計コスト。 |
profit_ecpc |
お金 | 123.45 |
(booked_revenue - total_cost)/クリック | クリックあたりの利益。 |
profit_ecpa |
お金 | 123.45 |
(booked_revenue - total_cost)/conversions | コンバージョンあたりの利益。 |
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 | バケット名 |
|---|---|
-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 |
Unknown |
1 |
Auto-play, sound on |
2 |
Auto-play, sound off |
3 |
Click-to-play |
4 |
Mouse-over |
5 |
Auto-play, sound unknown |
ビデオ コンテキスト
| メソッド ID | メソッド |
|---|---|
0 |
Unknown |
1 |
Pre-roll |
2 |
Mid-roll |
3 |
Post-roll |
4 |
Outstream |
プレイヤーサイズ
| ID | 名前 |
|---|---|
0 |
small |
1 |
medium |
2 |
large |
例
JSON レポート要求を作成する
JSON ファイルには、"video_analytics_network_advertiser"のreport_typeと、取得する列 (ディメンションとメトリック) とreport_intervalが含まれている必要があります。 また、特定のディメンションをフィルター処理し、粒度 (year、 month、 day) を定義し、データを返す形式 (csv、 excel、または html) を指定することもできます。 JSON ファイルに含めることができるフィールドの詳細については、 レポート サービスに関するページを参照してください。
$ cat video_analytics_network_advertiser
{"report":
{
"report_type":"video_analytics_network_advertiser",
"columns":[
"hour",
"seller_member_id",
"campaign_id",
"imps",
"starts",
"75_pcts",
"completions",
"cost_per_video_complete",
"served"
],
"report_interval":"last_48_hours",
"format":"csv"
}
}
POST レポート サービスへの要求
POST レポート ID を取得するための JSON 要求。
$ curl -b cookies -c cookies -X post -d @video_analytics_network_advertiser "https://api.appnexus.com/report?advertiser_id=690"
{
"response":{
"status":"OK",
"report_id":"09b6979a6a4c3805bdac8921378d3622"
}
}
GET レポート サービスからのレポートの状態
レポート ID を使用して GET 呼び出しを行って、レポートの状態を取得します。
execution_statusが"ready"されるまで、この呼び出しを続けます。 次に、 レポート ダウンロード サービスを使用して、レポート データをファイルに保存します (次の手順で説明します)。
$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=09b6979a6a4c3805bdac8921378d3622'
{
"response":{
"status":"OK",
"report":{
"name":null,
"created_on":"2010-05-25 19:15:48",
"json_request":"{\"report\":{\"report_type\":\"video_analytics_network_advertiser\",\"columns\":
[\"hour\",\"seller_member_id\",\"campaign_id\",\"imps\",\"starts\",\"75_pcts\",
\"completions\",\"cost_per_video_complete\",\"served\"],\"row_per\":
[\"hour\",\"seller_member_id\",\"campaign_id\"],
\"report_interval\":\"last_48_hours\",\"filters\":[{\"advertiser_id\":\"690\"}]}}",
"url":"report-download?id=b97897a7864dd8f34e7457226c7af592"
},
"execution_status":"ready"
}
}
GET レポート ダウンロード サービスからのレポート データ
レポート データをファイルにダウンロードするには、レポート ID を使用して別の GET 呼び出しを行いますが、今回は レポートダウンロード サービスに呼び出します。 サービス ID とレポート ID は、前のGET呼び出しに対する応答のurl フィールドにあります。 保存するファイルを特定するときは、最初の POSTで指定したファイル形式のファイル拡張子を使用してください。
注:
ダウンロード中にエラーが発生した場合、応答ヘッダーには HTTP エラー コードとメッセージが含まれます。 応答ヘッダーを公開するには、呼び出しで -i または -v を使用します。
$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/video_analytics_network_advertiser.csv
注:
XLSX および Excel ファイルとしてダウンロードする場合、レポートごとに 100,000 行の制限があります。