次の方法で共有

Digital Platform API - 履歴レポート

概要

履歴レポートは、Microsoft 収益化の主要な分析レポートであり、さまざまなディメンションとメトリックにわたる包括的なデータを提供します。 Network Analytics、販売者ブランド レビュー、販売者の塗りつぶしと配信など、10 種類を超えるレガシ レポートが統合されています。 これにより、ユーザーが操作する必要があるレポートの種類の数が減り、 dimensions の分類や metrics 、包括的な検索機能などの使いやすさを向上させる機能が提供されます。

履歴レポートは、1 つのインターフェイスを介してアクセスできる 2 つのデータセットから作成され、選択中に dimension と metric の非互換性が表示されます。 オプションの範囲が広がり、配信と在庫の複数の側面にわたるデータのより詳細なビューが提供され、配置やデバイスなど、レポート可能なディメンションの組み合わせが追加されます。 履歴レポートには、レガシ レポート システムで使用できるほとんどのデータが含まれています。

注:

このレポートは GA であり、 October 10, 2024から始まるデータが含まれています。 計画された更新プログラムは、Network Analytics、販売者の塗りつぶしと配信、Video Analytics レポートに合わせて機能を拡張します。 今後の更新では、追加のディメンション、メトリック、調整データが導入される予定です。

レポート マッピング

Delivery Analytics レポートと Inventory Analytics レポートは、1 つの履歴レポート ビルダー エクスペリエンスに統合されます。 この統合により、レポート ワークフローが合理化され、パフォーマンスとインベントリに関する分析情報が拡張され、次の機能が提供されます。

  • 包括的なパフォーマンス分析のための統合レポート
  • メトリックとディメンションの広範なカバレッジ
レガシ レポート名 マップされたレポート名 API 名
Delivery Analytics 履歴レポート monetize_creative_brand_analytics
Inventory Analytics 履歴レポート monetize_supply_analytics

注:

ディメンションとメトリックのカバレッジが進行中です。 レガシ レポートの種類の廃止をサポートするために、追加のフィールドが追加されています。

レガシ レポート

従来のレポートでは、 early 2026以降に Microsoft 収益化データが受信されなくなります。 履歴データは、各レポートの標準保有期間または 2 years 6 monthsに基づいてアクセス可能なままになります。どちらか短い方で、レポート内のいくつかの特定のディメンションでは、 99 days または 14 monthsの保持期間が短くなり、関連するレガシ レポート内の同等のフィールドのリテンション期間がミラーリングされます。 これらの新しいレポートの種類には、Microsoft 収益化販売者の 7=RTB (別のシートから独自のシートへの供給時の購入トランザクション) を除く、すべてのインプレッションタイプのデータが自動的に含まれます。

注:

  • 移行プロセスをサポートするために、事前に通信が提供されます。
  • Microsoft Invest および External SSP のレポートは、これらのデータセットには含まれません。

従来のレポートの種類

ネットワーク レポートの種類

レポートでは、配信とインベントリの分析が統合され、データ アクセスが合理化されます。 次の表は、統合されたレポートを従来の対応する API 名にマップします。

UI レポート名 API レポート名
Network Analytics network_analytics
販売者ブランド レビュー seller_brand_review
販売者ブランド レビュー 時間単位 (アルファ) seller_brand_review_hourly (アルファ)
販売者の塗りつぶしと配送ネットワーク seller_fill_and_delivery_network
販売者サイト ドメイン seller_site_domain
サイト ドメインのパフォーマンス network_site_domain_performance
Device Analytics network_device_analytics
Carrier Analytics network_carrier_analytics
Prebid Server Analytics prebid_server_analytics
Video Analytics video_analytics_network
Video Error Analytics video_error_analytics_network
Audio Analytics audio_analytics_network

広告主またはパブリッシャーのレポートの種類

UI レポート名 API レポート名
広告主向けアナリティクス advertiser_analytics
サイト ドメインのパフォーマンス site_domain_performance
広告主向け Video Analytics video_analytics_network_advertiser
Publisher Analytics network_publisher_analytics
インストールしない publisher_brand_review
販売者の塗りつぶしと配信の発行元 seller_fill_and_delivery_publisher
Publisher Video Analytics レポート video_analytics_network_publisher
Publisher Video Error Report video_error_analytics_network

履歴レポートの作成

履歴レポートを使用すると、効率的なレポート作成が可能になります。 ユーザーは、さまざまな ディメンション、 メトリック、 フィルター から選択して、レポートをカスタマイズできます。

時間枠とデータ保持期間

時間範囲

JSON 要求の report_interval フィールドは、次のいずれかに設定できます。

  • custom
  • current_hour
  • last_hour
  • today
  • yesterday
  • last_48_hours
  • last_2_days
  • last_7_days
  • last_14_days
  • last_30_days
  • month_to_date
  • month_to_yesterday

データ保持期間

注:

カスタム時間枠のレポートを実行するには、レポート要求のstart_dateフィールドとend_dateフィールドを設定します。 これらのフィールドの詳細については、「 Report Service」を参照してください。

  • 時間単位のデータ: データは過去 100 日間保持されます。
  • 累積データ: データは最大 2 年 2 か月間保持されます。
  • 現在の最大データ可用性: データは 90 日間保持されます (今後予定されている拡張機能)。

間隔

間隔は、データをレポート応答の行にグループ化する方法を決定します。 レポートで使用できる間隔の完全な一覧を次に示します。 ただし、すべての間隔は、すべてのレポートで使用できるわけではありません。

  • 毎時： データは時間単位でグループ化されます。
  • 日毎： データは日別にグループ化されます。
  • マンスリー： データは月ごとにグループ化されます。
  • 累積： データは、選択した期間全体でカバーされます。

フィルター

フィルターを使用すると、表示されるデータを特定のディメンションで制限できます。 使用可能なフィルターは次のとおりです。

  • 広告主名
  • 発行元名
  • インプレッションの種類

Dimensions

警告

デバイスの作成やクリエイティブなど、一部のディメンションは一緒に使用できません。 情報メッセージは、使用できない組み合わせを示します。

列 種類 フィルター。 説明
advertiser 文字列 いいえ インプレッションを購入した広告主。 これは販売者が所有するオブジェクトであり、マネージド購入または取引 v2 インプレッション用に設定されます。
advertiser_id int はい インプレッションを購入した広告主の ID。 これは販売者が所有するオブジェクトであり、マネージド購入または取引 v2 インプレッション用に設定されます。
advertiser_name 文字列 いいえ インプレッションを購入した広告主の名前。 これは販売者が所有するオブジェクトであり、マネージド購入または取引 v2 インプレッション用に設定されます。
bidder int 不要 Bidder オブジェクト (ほとんどの場合、これは DSP です)。
bidder_id int はい Xandr Bidder オブジェクトの ID (ほとんどの場合、これは DSP です)。
bidder_name int 不要 Xandr Bidder オブジェクトの名前 (ほとんどの場合、これは DSP です)。
billing_period_id int はい 請求期間の ID
billing_period.booked_imps_budget_daily int 不要 挿入注文の請求期間の 1 日あたりのインプレッション予算。
billing_period.booked_imps_budget_lifetime int 不要 挿入注文の請求期間の有効期間のインプレッション予算。
billing_period.start_date 日付型 不要 挿入注文の請求期間の最も早い日付。 注: Alpha-Beta 注意: このフィールドまたは機能は、現在アルファまたはベータ 段階の機能の一部です。 そのため、変更される可能性があります。
billing_period.end_date 日付型 不要 挿入注文の請求期間の最後の日付。 注: Alpha-Beta 注意: このフィールドまたは機能は、現在アルファまたはベータ 段階の機能の一部です。 そのため、変更される可能性があります。
billing_period.external_code int 不要 請求期間のカスタム コード。
buyer_member 文字列 いいえ インプレッションを購入した Xandr 購入者メンバーの ID を角かっこで囲んだ名前
buyer_member_id int はい インプレッションを購入した Xandr 購入者メンバーの ID
buyer_member_name 文字列 いいえ インプレッションを購入した Xandr 購入者メンバーの名前
buyer_seat 文字列 いいえ Bidder の座席。 これにより、 buyer_member_id ブレークアウトを持たない入札者のサブシートに関するレポートが可能になります。
buyer_seat_id int はい Bidder のシートの ID。 これにより、 buyer_member_id ブレークアウトを持たない入札者のサブシートに関するレポートが可能になります。
buyer_seat_name 文字列 いいえ Bidder のシートの名前。 これにより、buyer_member_idブレークアウトのない入札者のサブシートに関するレポートが可能になります。
buyer_seat_code 文字列 いいえ インプレッションの入札に使用されたカスタム 購入者シート ID (DSP によって送信)
flight_id int 不要 インプレッションが購入された広告申込情報フライトの ID。
flight_booked_impressions_budget_daily int 不要 広告申込情報のフライトの 1 日あたりのインプレッション予算。
flight_booked_impressions_budget_lifetime int 不要 広告申込情報のフライトの有効期間のインプレッション予算。
flight_start_date 日付型 不要 明細のフライトの開始日。
flight_end_date 日付型 不要 明細のフライトの終了日。
insertion_order string はい インプレッションを購入した挿入注文。 これは販売者が所有するオブジェクトであり、マネージド購入または取引 v2 インプレッション用に設定されます。
insertion_order_id int 不要 インプレッションを購入した挿入注文 ID。 これは販売者が所有するオブジェクトであり、マネージド購入または取引 v2 インプレッション用に設定されます。
insertion_order_name 文字列 いいえ インプレッションを購入した挿入注文名。 これは販売者が所有するオブジェクトであり、マネージド購入または取引 v2 インプレッション用に設定されます。
insertion_order.billing_code 文字列 いいえ 挿入順序に関連付けられている課金コード (ある場合)。
insertion_order.end_date 日付型 不要 挿入指図の終了日 (従来の挿入指図の場合)。
insertion_order.start_date 日付型 不要 挿入指図の開始日 (従来の挿入指図の場合)。
insertion_order.state 文字列 いいえ 挿入順序の状態 (アクティブ、非アクティブなど)。
insertion_order.type int はい インプレッションに関連付けられた挿入順序の種類 (レガシ、シームレスなど)。
line_item 文字列 いいえ インプレッションを購入した広告申込情報の注文。 これは販売者が所有するオブジェクトであり、マネージド購入または取引 v2 インプレッション用に設定されます。
line_item_id int はい インプレッションを購入した広告申込情報 ID。 これは販売者が所有するオブジェクトであり、マネージド購入または取引 v2 インプレッション用に設定されます。
line_item_name 文字列 いいえ インプレッションを購入した広告申込情報名。 これは販売者が所有するオブジェクトであり、マネージド購入または取引 v2 インプレッション用に設定されます。
line_item.comments 文字列 いいえ この明細に対して入力されたコメント。
line_item.start_date 日付型 不要 明細の開始日。
line_item.end_date 日付型 不要 明細の終了日。
line_item.status 文字列 いいえ 明細の状態 (アクティブ、非アクティブなど)。
line_item_code 文字列 いいえ 行項目に適用される省略可能な外部コード。
li_priority string はい 直接在庫を対象とする広告申込情報の入札優先度。 詳細については、UI ドキュメントの「入札の優先順位」を参照してください。 使用可能な値: 1 ~ 20。20 が最も高い優先順位です。
li_subtype string はい 明細サブタイプ (拡張、取引、保証など)。
li_subtype_id int 不要 明細サブタイプ ID。
li_subtype_name 文字列 いいえ 明細サブタイプ名。
salesrep_for_line_item string はい 営業担当者を含むカスタム レポート ラベル フィールド。 レポートごとに 1 つのレポート ラベルのみを選択できます。
trafficker_for_line_item string はい 入稿者を含むカスタム レポート ラベル フィールド。 レポートごとに 1 つのレポート ラベルのみを選択できます。
type_for_line_item string はい 広告申込情報の種類を一覧表示するために使用されるカスタム レポート ラベル フィールド (例: REtargeting LI)。 これは、上記の Type 属性と同じではありません。 レポートごとに 1 つのレポート ラベルのみを選択できます。
insertion_order_type string はい 挿入順序の種類 (ブランド化 IO など) の一覧に使用されるカスタム レポート ラベル フィールド。 これは、上記の Type 属性と同じではありません。 レポートごとに 1 つのレポート ラベルのみを選択できます。
insertion_order.sales_rep_label string はい 挿入注文に関連付けられている営業担当者を一覧表示するために使用される顧客レポート ラベル フィールド。 レポートごとに 1 つのレポート ラベルのみを選択できます。
insertion_order.trafficker_label string はい 挿入注文に関連付けられている入稿者を一覧表示するために使用される顧客レポート ラベル フィールド。 レポートごとに 1 つのレポート ラベルのみを選択できます。
placement 文字列 いいえ インプレッションの Xandr 配置。
placement_id int はい インプレッションの Xandr 配置の ID。
placement_name 文字列 いいえ インプレッションの Xandr 配置の名前。
placement.code 文字列 いいえ インプレッションの Xandr 配置のコード。
placement.code2 文字列 いいえ インプレッションの Xandr 配置のコード。
placement.code3 文字列 いいえ インプレッションの Xandr 配置のコード。
plmt_grp 文字列 いいえ インプレッションの Xandr 配置グループ。
plmt_grp_id int はい インプレッションの Xandr 配置グループの ID。
plmt_grp.name 文字列 いいえ インプレッションの Xandr 配置グループの名前。
plmt_grp.code 文字列 いいえ インプレッションの Xandr 配置グループのコード。
publisher 文字列 いいえ インプレッションの Xandr Publisher。
publisher_id int はい インプレッションの Xandr Publisher の ID。
publisher_name 文字列 いいえ インプレッションの Xandr Publisher の名前。
brand 文字列 いいえ Xandr クリエイティブ監査またはマネージド トラフィックに割り当てられた自己によって決定されるブランド
brand_id int はい Xandr クリエイティブ監査またはマネージド トラフィックに割り当てられた自己によって決定されるブランドの ID
brand_name 文字列 いいえ Xandr クリエイティブ監査またはマネージド トラフィックに割り当てられた自己割り当てによって決定されるブランドの名前
brand_category_id int はい クリエイティブに割り当てられたブランドの親カテゴリ ID
brand_category_name 文字列 いいえ クリエイティブに割り当てられたブランドの親カテゴリ名
creative 文字列 いいえ 配信されたクリエイティブ。 これは、マネージド インプレッションに対してのみ設定されます。
creative_id int はい 配信されたクリエイティブの Xandr ID。
creative_name 文字列 いいえ 配信したクリエイティブの Xandr 名。 名前は、マネージド インプレッションに対してのみ設定されます。
creative_code 文字列 いいえ クリエイティブのコード。
creative_type 文字列 いいえ 取引を行ったクリエイティブのメディアの種類
creative_type_id int 不要 取引を行ったクリエイティブのメディアタイプ ID
size string はい ディスプレイ クリエイティブの場合、これはクリエイティブ幅 x 高さ (ピクセル単位) です
domains_exposed_id int 不要 このインベントリのドメインが購入者によるターゲット設定のために公開されているかどうか。 許可される値: "Exposed"、"Not exposed"
domains_exposed int 不要 このインベントリのドメインが購入者によるターゲット設定のために公開されているかどうか。 許可される値: "Exposed"、"Not exposed"
exposed_for_resale 文字列 いいえ 売り手がcontent_categories情報を購入者に公開/非表示にするために使用する視認性プロファイル
exposed_for_resale_id int 不要 販売者がパブリッシャー情報を購入者に公開/非表示にするために使用する視認性プロファイル
allowed_media_types_bitmap_name 文字列 いいえ インプレッションに許可されているメディアの種類の配列
audit_type 文字列 いいえ インプレッションが発生したドメインで実行される監査の種類。
audit_type_id int はい インプレッションが発生したドメインで実行される監査の種類の ID。
audit_type_name 文字列 いいえ インプレッションが発生したドメインで実行される監査の種類の名前。
browser 文字列 いいえ インプレッションが配信されたブラウザーの名前と ID。 ブラウザー ID と名前の完全な一覧を取得するには、ブラウザー サービスを使用します。
browser_id int はい インプレッションが配信されたブラウザーの ID。 ブラウザー ID と名前の完全な一覧を取得するには、ブラウザー サービスを使用します。
content_category 文字列 いいえ 監査対象ドメインに関連付けられているユニバーサル コンテンツ カテゴリの ID と名前。
content_category_id int はい 監査対象ドメインに関連付けられているユニバーサル コンテンツ カテゴリの ID。
content_category_name 文字列 いいえ 監査対象ドメインに関連付けられているユニバーサル コンテンツ カテゴリの名前。
fold_position 文字列 いいえ 折り畳み位置、つまりページ上のどこに配置が配置されているか。 許可される値については、「fold_position_id」を参照してください。
fold_position_id int はい 折り畳み位置の ID。つまり、ページ上の配置が配置されている場所。 インプレッションに使用できる値: 0 = "unknown"、1 = "above"、2 = "below"。
supply_type_id int はい インベントリの種類の ID。
supply_type_name 文字列 いいえ インベントリの種類。 使用可能な値: "web"、"mobile_web"、"mobile_app"、"facebook_sidebar"。
prebid_server_eligible int はい PSP がインプレッションのオークションに入札する資格がある場合ははい。
prebid_server_eligible_name 文字列 いいえ PSP がインプレッションのオークションに入札する資格がある場合ははい。
ssp 文字列 いいえ トランザクションが PSP (bidder_id=443) によって購入されると、このフィールドには、取引された個々の SSP が表示されます。 それ以外の場合、SSP は収益化として記録されます。
ssp_id int 不要 トランザクションが PSP (bidder_id=443) によって購入されると、このフィールドには、取引された個々の SSP が表示されます。 それ以外の場合、SSP は収益化として記録されます。
ssp_name 文字列 いいえ トランザクションが PSP (bidder_id=443) によって購入されると、このフィールドには、取引された個々の SSP が表示されます。 それ以外の場合、SSP は収益化として記録されます。
deal 文字列 いいえ 影響を受ける取引の名前と ID。
deal_id int はい 取引の ID。
deal_name 文字列 いいえ 影響を受ける取引の名前。
deal_type string はい 使用可能な値: Open Auction (1)、Private Auction (2)、First Look (3)、Programmatic Guaranteed (4)、キュレーション (5 - キュレーターにのみ関連)。
revenue_type 文字列 いいえ 管理された明細の場合、これは、予約された収益が販売者に記録される基準です。
revenue_type_id int はい 広告主がインプレッションの支払いに同意した基準。
carrier 文字列 いいえ インプレッションが配信されたデバイスの通信事業者。
carrier_id int はい インプレッションが配信されたデバイスの通信事業者の ID。
carrier_name 文字列 いいえ インプレッションが配信されたデバイスの通信事業者の名前。
device_make 文字列 いいえ デバイスの製造元
device_make_id int はい インプレッションが配信されたデバイスの ID。 メーカーは、一般的にデバイスの製造元です (つまり、Apple)。
device_make_name 文字列 いいえ インプレッションが配信されたデバイスの名前。 メーカーは、一般的にデバイスの製造元です (つまり、Apple)。 デバイスの ID と名前の完全な一覧を取得するには、Device Make Service を使用します。
device_model 文字列 いいえ インプレッションが配信されたデバイス モデルの ID と名前。 モデルは通常、特定の製品 (IPhone) です。
device_model_id int はい インプレッションが配信されたデバイス モデルの ID。 モデルは通常、特定の製品 (IPhone) です。
device_model_name 文字列 いいえ インプレッションが配信されたデバイス モデルの名前。 モデルは通常、特定の製品 (IPhone) です。
device_type 文字列 いいえ インプレッションの発信元のデバイスの種類。 0=Unknown、1=PC、2=Phone、3=Tablet、4=TV、5=Game Console、6=Media Player、7=Set top box
device_type_id int はい インプレッションの発信元のデバイス タイプの ID。 0=Unknown、1=PC、2=Phone、3=Tablet、4=TV、5=Game Console、6=Media Player、7=Set top box
operating_system 文字列 いいえ デバイスのオペレーティング システムの名前の後に ID (Microsoft Advertising 形式) が続きます。
operating_system_id int はい デバイスのオペレーティング システムの ID。
operating_system_name 文字列 いいえ デバイスのオペレーティング システムの名前。
operating_system_family 文字列 いいえ デバイスのオペレーティング システム ファミリ (Android、Microsoft Windows など) の名前の後に ID (Microsoft Advertising 形式) が続きます。
operating_system_family_id int はい インプレッションが配信されたデバイスに関連付けられているオペレーティング システム ファミリの ID。
operating_system_family_name 文字列 いいえ インプレッションが配信されたデバイスに関連付けられているオペレーティング システム ファミリの名前。
curator_member 文字列 いいえ トランザクションに存在していたキュレーターの ID
curator_member_id int はい トランザクションに存在していたキュレーターの ID
curator_member_name 文字列 いいえ トランザクションに存在していたキュレーターの名前
is_curated ブール値 はい はい(キュレーター経由でトランザクションが発生した場合)
demand_channel 文字列 いいえ インプレッションを購入した需要の種類。 使用可能な値: Managed (imp_type=5)、PSP (bidder_id=443)、Standard Deal、Priority Deal、PG Deal、Curation (curator_member_id > 0)、Open Exchange (imp_type=6)。
demand_channel_id int はい インプレッションを購入した需要の種類。 使用可能な値: Managed (imp_type=5)、PSP (bidder_id=443)、Standard Deal、Priority Deal、PG Deal、Curation (curator_member_id > 0)、Open Exchange (imp_type=6)。
demand_channel_name 文字列 いいえ インプレッションを購入した需要の種類。 使用可能な値: Managed (imp_type=5)、PSP (bidder_id=443)、Standard Deal、Priority Deal、PG Deal、Curation (curator_member_id > 0)、Open Exchange (imp_type=6)。
imp_type 文字列 いいえ トランザクションの種類。 (1=blank,2=PSA, 3=Default Error, 4=default, 5=kept, 6=resold, 7=RTB, 8=PSA Error, 9=External Impression, 10=External Click, 11=Insertion)
imp_type_id int はい トランザクションの種類。 (1=blank,2=PSA, 3=Default Error, 4=default, 5=kept, 6=resold, 7=RTB, 8=PSA Error, 9=External Impression, 10=External Click, 11=Insertion)
call_type string はい 印象が生まれた Impbus ハンドラー
sdk_version 文字列 いいえ 広告要求の生成に使用される Xandr SDK (AST または Mobile SDK) のバージョン。
mobile_application 文字列 いいえ ドメイン/アプリ 広告要求のバンドルがマップされたアプリケーション
mobile_application_id int 不要 ドメイン/アプリ 広告要求でバンドルがマップされたアプリケーションの ID
mobile_application_name 文字列 いいえ ドメイン/アプリ 広告要求でバンドルがマップされたアプリケーションの名前
site_domain 文字列 いいえ ドメイン/アプリ 広告要求に対して検出されたドメイン
geo_country string はい 地理 インプレッションが行われた国/地域 2 桁のコード。 Xandr が広告がレンダリングされたことを示さなかったインプレッションリクエスト (つまり、非トランザクション) の場合、国/地域の情報は提供されません。 国/地域の情報は、ユーザーの IP アドレスによって検出されます。 注: 国/地域の検出方法の違いにより、一部の相違点が外部データ ソースと正常です。
geo_country_name 文字列 いいえ インプレッションが行われた国/地域名。 Xandr が広告がレンダリングされたことを示さなかったインプレッションリクエスト (つまり、非トランザクション) の場合、国/地域の情報は提供されません。 国/地域の情報は、
day date 不要 オークションの日
hour date 不要 オークションの時間。 注: 100 日を超えるインプレッションの場合、1 時間ではなく日が返されます。
month date 不要 オークションの月
filtered_request_reason 文字列 いいえ Xandrの在庫管理によってインプレッションリクエストが除外され、オークションが開催されなかった理由。 考えられる理由は、"無効なドメイン" (1)、"無効な IP" (2)、"疑わしいドメイン検出の改ざん" (3、 4、5、"Unknown" (6、7)、"White Ops: General IVT" (17) - リストの適用またはその他の標準化されたパラメーター チェックを通じて実行される、フィルター処理の日常的な手段によって識別されるトラフィックで構成されます。"White Ops: Sophisticated IVT" (18) は、高度な分析を必要とする状況をより困難に検出するために構成されます。 マルチポイントの腐食/調整、重要な人間の介入など、分析および識別するために、"有効な印象" (0) も有効なフィルター処理された要求の理由ですが、その場合はオークションが開催され、フィルター処理されませんでした。
filtered_request_reason_id int 不要 Xandrの在庫管理によってインプレッションリクエストが除外され、オークションが開催されなかった理由。 考えられる理由は、"無効なドメイン" (1)、"無効な IP" (2)、"疑わしいドメイン検出の改ざん" (3、 4、5、"Unknown" (6、7)、"White Ops: General IVT" (17) - リストの適用またはその他の標準化されたパラメーター チェックを通じて実行される、フィルター処理の日常的な手段によって識別されるトラフィックで構成されます。"White Ops: Sophisticated IVT" (18) は、高度な分析を必要とする状況をより困難に検出するために構成されます。 マルチポイントの腐食/調整、重要な人間の介入など、分析および識別するために、"有効な印象" (0) も有効なフィルター処理された要求の理由ですが、その場合はオークションが開催され、フィルター処理されませんでした。

指標

注:

調整収益は現在報告できません。 収益メトリックでは、集計レベルが異なるため、若干の不一致が生じる可能性があります。

列 型 説明
imps int 記録されたimp_typeのインプレッション数。 N.B./OpenRTB2 や /prebid 空白インプレッションなどの一部のcall_typesでは、通常、Xandr が入札を返すとさらにオークションが発生し、最終的なインプレッションが空白になっているか、最終オークションで Xandr が失われたかは不明であるため、imps として記録されません。
sold_network_rpm double 空白、既定値、またはエラーではない 1,000 インプレッションあたりの収益。
total_revenue_ecpm お金 1,000 インプレッションあたりの総収益。
revenue お金 純収益の合計。
imps_blank int 空白のクリエイティブが配信されたインプレッションの合計数。
imps_default int 有効な入札がなかったために既定のクリエイティブが配信されたインプレッションの合計数。
imps_default_error int タイムアウトの問題が原因で既定のクリエイティブが配信されたインプレッションの合計数。
imps_kept int 管理対象広告主の 1 人がクリエイティブを配信したインプレッションの合計数。
imps_resold int サード パーティの購入者に販売されたインプレッションの合計数。
imps_primary_creative int マスター クリエイティブに配信されたページ レベルの障害の数。 注: Alpha-Beta 注意: このフィールドまたは機能は、現在アルファまたはベータ 段階の機能の一部です。 そのため、変更される可能性があります。
imps_psa int 他のクリエイティブが適格でなかったため、パブリック サービスのお知らせが配信されたインプレッションの合計数。
imps_psa_error int タイムアウトの問題が原因でパブリック サービスのお知らせが配信されたインプレッションの合計数。
seller_revenue お金 第三者の買い手から得られた純収益 (販売者へ)
booked_revenue お金 インプレッションを獲得した広告申込情報に適用される純収益。
clicks int 記録されたクリック数。 クリック数はオークションで重複除去され (一意のオークションごとに最大 1 回クリック)、6 時間の TTL が記録されます。 クリック数は、Xandr Investによって購入されたディスプレイインプレジソンと、すべての購入者からのビデオクリエイティブとネイティブクリエイティブに対して測定できます。
total_revenue_ecpc お金 クリックあたりの総収益。
cost お金 広告申込情報を使用してサード パーティの在庫を購入するためのコスト
cpm お金 1,000 インプレッションあたりのコスト。
starts int Xandr が受信した開始イベントの数。オークションごとに最大 1 回。
25_pcts int Xandr が受信した最初の四分位数イベントの数。オークションごとに最大 1 回。
50_pcts int Xandr が受信した 2 番目の四分位数イベントの数。オークションごとに最大 1 回。
75_pcts int Xandr が受信した 3 番目の四分位数イベントの数。オークションごとに最大 1 回。
completions int Xandr が受信した完了イベントの数。オークションごとに最大 1 回。
errors int Xandr が受信したエラー イベントの数。オークションごとに最大 1 回。
skips int Xandr が受信したスキップ イベントの数。オークションごとに最大 1 回。
start_rate double video_starts/imps
video_25_pct_completion_rate double video_25_pcts/video_starts
video_50_pct_completion_rate double video_50_pcts/video_starts
video_75_pct_completion_rate double video_75_pcts/video_starts
video_skip_rate double video_skips/video_starts
started_video_completion_rate double 読み込みあたりのビデオ入力候補 (video_completions/video_starts)
revenue_per_video_complete double ビデオ完了あたりの収益。
view_measured_imps int 視認性のために測定されたインプレッションの合計数
imps_viewed int Xandr ビューアビリティ スクリプトによって表示可能として測定されたインプレッションの合計数
view_measurement_rate double 総インプレッション数のうち視認性を測定したインプレッションの割合。 (測定された Imps/Imps を表示する)
view_rate double 視認性を測定したインプレッションの総数のうち、表示可能だったインプレッションの割合。 (表示された Imps/View Measured Imps)
total_revenue_vcpm お金 表示可能なインプレッション数 1,000 件あたりの総収益。
ad_requests int フィルターが適用される前に Xandr がオークションで考慮した一意のオークションの数。 N.B.1 つの広告呼び出しに複数のタグが含まれる場合があります。 このようなシナリオでは、広告要求メッセージ内のすべてのタグに対する広告要求をカウントします。
filtered_requests int 在庫品質チェックのために Xandr がフィルター処理した一意のオークションの数
external_click int 外部クリックトラッカーによって記録されたクリック。
external_impression int 外部インプレッション トラッカーによって記録されるインプ。
total_revenue_ecpa お金 取得あたりの合計収益。

例

JSON 形式のレポート要求を作成する

JSON ファイルには、report_type monetize_supply_analytics または monetize_creative_brand_analytics、取得する列 (ディメンションとメトリック) と report_interval が含まれている必要があります。 また、特定のディメンションをフィルター処理し、粒度 (年、月、日) を定義し、データを返す形式 (csv、excel、または html) を指定することもできます。 JSON ファイルに含めることができるフィールドの詳細については、[Report Service[(report-service.md)]を参照してください。


$ cat monetize_supply_analytics.json
{
    "report": {
        "report_type": "monetize_supply_analytics",
        "columns": ["hour", "seller_member_name", "buyer_member_name", "advertiser_name", "publisher_name", "imps", "clicks"],
        "report_interval": "last_48_hours",
        "format": "csv"
    }
}

要求を Reporting サービスに POST する


$ curl -b cookies -X POST -d @ monetize_supply_analytics 'https://api.appnexus.com/report'
{
   "response": {
      "status": "OK",
      "report_id": "097f59fc3ab7d02c5d60db42081d9b69"
   }
}

レポート サービスからレポートの状態を取得する

レポート要求を送信した後、GET メソッドを使用して状態をチェックします。

要求の例

レポート ID を使用して GET 呼び出しを行って、レポートの状態を取得します。 execution_statusがreadyされるまで、このGET呼び出しを行い続けます。 次の手順で説明するように、レポート ダウンロード サービスを使用してレポート データをファイルに保存します。

$ curl -b cookies 'https://api.appnexus.com/report?id=097f59fc3ab7d02c5d60db42081d9b69' 

{ 

   "response":{ 
      "status":"OK", 
      "report":{ 
         "name":null, 
         "created_on":"2010-05-25 19:19:53", 
         "json_request":"{\"report\":{\"report_type\":\"monetize_supply_analytics\",\"columns\":[\"hour\",\"seller_member_name\", 
            \"buyer_member_name\",\"advertiser_name\",\"publisher_name\",\"imps\",\"clicks\"], 
            \"row_per\":[\"hour\",\"seller_member_id\",\"buyer_member_id\",\"advertiser_id\",\"publisher_id\"], 
            \"report_interval\":\"last_48_hours\"}}", 
         "url": "report-download?id=b97897a7864dd8f34e7457226c7af592" 
      }, 
      "execution_status":"ready" 
   } 
}

レポート ダウンロード サービスからレポート データを取得する

レポート データをファイルにダウンロードするには、レポート ID を使用して別の GET 呼び出しを行いますが、今回はレポートダウンロード サービスに呼び出します。 サービスとレポート ID は、前のGET応答の [url] フィールドにあります。 保存するファイルを特定するときは、最初のPOSTで指定したformatのファイル拡張子を使用してください。

注:

ダウンロード中にエラーが発生した場合、応答ヘッダーには HTTP エラー コードとメッセージが含まれます。 応答ヘッダーを公開するには、呼び出しで -i または -v を使用します。

curl -b cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/monetize_supply_analytics.csv

ヒント

XLSX および Excel ファイルとしてダウンロードする場合、レポートごとに 100,000 行の制限があります。