ネットワーク パブリッシャーの動画分析

ネットワーク パブリッシャー動画分析レポートを使用すると、ネットワーク内の特定のパブリッシャーのビデオ イベント指標を、ネットワーク動画分析レポートで提供されるデータよりも細かく表示できます。 このレポートは、ネットワーク ユーザーのみが利用できます。

注:

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_id0されます。
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 日を超えるインプレッションの場合、プレースメントは -1placement_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" 広告が再生される番組の主なジャンル。 たとえば、 ActionAdventureBiographyBusinessComedy などです。
video_program_type1 文字列 いいえ "series" 広告が再生されるビデオ プログラム フォーマットの上位レベルの分類。 たとえば、 MovieSeriesSpecialShowEventClip などです。
video_content_rating1 文字列 いいえ "teens" パブリッシャーが特定した、コンテンツのレーティング対象のオーディエンス グループ。 たとえば、 AllChildren (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 StoryCBCDisneyAMCFox などです。
is_takeover ブール値 はい "Yes" マルチ広告要求の広告の少なくとも 1 つが引き継ぎであったために、インプレッションが BlankedDefaulted かを示します。 インプレッションが引き継ぎ要求の一部である場合は true を返し、それ以外の場合は false を返します。

注:

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

  • 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 クリック数/インプ * 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.6605168
5393258
(コスト/インプ) 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 行の制限があります。