ネットワーク広告主の動画分析

ネットワーク広告主のビデオ分析レポートを使用すると、ネットワーク ビデオ分析レポートで提供されるデータよりも詳細な特定の広告主のビデオ イベント メトリックを表示できます。 このレポートは、ネットワーク ユーザーのみが利用できます。

注:

ビデオ メトリックは、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

データ保持期間

このレポートのデータの保持期間は次のとおりです。

  • 時間単位のリテンション期間: 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 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 日を超えるインプレッションの場合、プレースメントは "All placement data older than 100 days" を placement_nameとして 1 つの行に集約されます。
placement 文字列 いいえ "Photos 728x90 (123)" 非推奨です。
placement_code 文字列 いいえ "Placement Code" 配置のカスタム コード。
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)" 非推奨です。
size string はい "728x90" クリエイティブ/プレースメントのサイズ
geo_country string はい "US" 地理的な国/地域コード
geo_country_name 文字列 いいえ "Unites States" 国/地域の名前
creative_recency_bucket string はい "11-20" クリエイティブが表示された期間のバケット。 可能な値については、以下の クリエイティブ最新性バケット を参照してください。
creative_recency_bucket_id 文字列 いいえ "4" クリエイティブの最新性バケットの ID。 可能な値については、以下の クリエイティブ最新性バケット を参照してください。
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 にすることができます。

ドメインの代わりに表示される可能性のある追加の値、具体的には "deals.unknown" または "managed.unknown" の 2 つがあります。 これらは、参照元として有効なドメインを受け取っていないことを意味します。 たとえば、ドメインが空白であったり、形式が正しくないなどです。
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_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 などです。
is_takeover ブール値 はい "Yes" マルチ広告要求の広告の少なくとも 1 つが引き継ぎであったために、インプレッションが Blanked か Defaulted かを示します。 インプレッションが引き継ぎ要求の一部である場合は true を返し、それ以外の場合は false を返します。

注:

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

  • video_content_genre
  • video_program_type
  • video_content_rating
  • video_content_duration
  • video_content_language
  • video_content_network
  • video_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 クリック数/インプ クリック数対インプレッション数の割合。
profit 金銭 350.00 booked_revenue - total_cost booked 収益から総コストを差し引いた金額。
revenue_ecpm 金銭 1.9221 booked_revenue / クリック数 インプレッション 1,000 回あたりの総収益。
cost_ecpm 金銭 0.4271259 media_cost / imps * 1,000 インプレッション 1,000 回あたりのコスト。
profit_ecpm 金銭 0.4949 利益/IMP * 1,000 インプレッション 1,000 回あたりの利益。 "利益" は、簿記収益から総コストを差し引いたものとして定義されます。
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 利益/booked_revenue 利益を booked_revenueで割った値。 "利益" は、簿記収益から総コストを差し引いたものとして定義されます。
media_cost 金銭 100.00 media_cost 消費した合計金額。
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 動画の完成回数をインプレッション数で割ったものです。
revenue_per_video_complete double 15.869 収益/完了数 ビデオの完了あたりの収益。
cost_per_video_complete double 2.056 コスト/完了数 ビデオの完了あたりのコスト。
served int 87649 配信された動画インプレッション数 配信された動画インプレッションの合計数。

注: インプ とは、ビデオ プレーヤーがビデオを読み込んで最初のフレームを開始するタイミングを指します。 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/コンバージョン コンバージョンあたりの総コスト。
profit_ecpc 金銭 123.45 (booked_revenue - total_cost)/クリック数 クリックあたりの利益。
profit_ecpa 金銭 123.45 (booked_revenue - total_cost)/コンバージョン コンバージョンあたりの利益。
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 バケット名
-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 ファイルには、取得する列 (ディメンションとメトリック) とreport_intervalだけでなく、"video_analytics_network_advertiser"のreport_typeを含める必要があります。 また、特定のディメンションをフィルター処理したり、粒度 (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 行の制限があります。

Report Service

  • Last updated on