次の方法で共有


ネットワークパブリッシャーのビデオ分析

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_id0されます。
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" 広告が再生されるプログラムのメインジャンル。 たとえば、 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などです。

注:

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

  • 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 行の制限があります。