次の方法で共有

Prebid Server Premium Health Analytics

  • [アーティクル]

Prebid Server Premium (PSP) Health Analytics レポートを使用すると、ユーザーは、構成された需要パートナーとの入札要求とトランザクションに関連するデータを分析できます。 これは、既知の問題のトラブルシューティングや最適化の機会を事前に特定する場合に最も役立ちます。

注:

ダッシュボードは、 サンプル データに乗算され、PSP アクティビティの全量を見積もります。 配信と収益レポートには使用されません。 Prebid Server Premium Seller Analytics レポートおよびその他の Microsoft 収益化レポートは、このような目的で使用する必要があります。

期限

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

  • last_hour
  • last_24_hours
  • last_48_hours
  • 今日
  • yesterday
  • last_2_days
  • last_7_days
  • last_14_days
  • last_30_days
  • month_to_date
  • last_month
  • month_to_yesterday
  • quarter_to_date
  • 一生

データの time_granularity は時間単位です。 レポートを取得する手順については、 レポート サービス または以下の 例を 参照してください。

データ保持期間

このレポートのデータ保持期間は 99 日です。

Dimensions

列 種類 フィルター。 例 説明
ad_size string はい 300x250 広告スロットのサイズ。
allowed_media_types_bitmap_name string いいえ "Banner" 収益化のプレースメントでパブリッシャーが有効にするクリエイティブのカテゴリ。 たとえば、バナー、ビデオ、ネイティブなどです。
application_id string はい "vizio.pluto" デバイスで使用される特定のアプリケーション。
bid_error_type int はい 21 入札応答に関連するエラーのカテゴリの ID。 詳細については、以下の Bid 要求エラーの種類 の表を参照してください。
bid_error_type_name string いいえ "NO_BID_PRICE" 入札応答に関連するエラーのカテゴリ。 詳細については、以下の Bid 要求エラーの種類 の表を参照してください。
bid_reject_error_code string はい "31" 需要パートナーの入札応答から生成された特定のエラー。 各値の説明と潜在的な解決策については、 入札エラー コード に関するページを参照してください。
bidder_id int はい 443 入札者の ID (443)。
bidder_name string いいえ Prebid Server bidder (Prebid Server) の名前。
browser_code_id int はい 5414 ブラウザーの特定のバージョンの ID。
browser_code_name string いいえ "da-chrome-107.0" ブラウザーの特定のバージョンの名前。
call_type string はい /ut/v3/prebid 入札要求を収益化 "(例: /ut/v3/prebid、openrtb2/prebid)" に送信するために使用されるハンドラーの種類。
cookies_present ブール値 はい はい 入札要求に Cookie が存在するかどうかを示します。
datacenter_id string はい "ams3" 要求を要求パートナーにルーティングするために使用されるデータ センターの ID。
day date はい "2018-02-01" オークションの日。
demand_partner string いいえ "PubMatic (PSP) (9645)" 要求パートナー名と ID で構成される文字列。
demand_partner_id int はい 9645 要求の送信先であり、応答 (ある場合) が受信されたパートナーの ID。
demand_partner_name string いいえ "PubMatic (PSP)" 要求の送信先であり、応答 (ある場合) が受信されたパートナーの名前。
device_browser_id int はい 8 デバイスで使用されるブラウザーの ID。 たとえば、Chrome、Safari などです。
device_browser_name string いいえ "Chrome (all versions)" デバイスで使用されるブラウザーの名前。 たとえば、Chrome、Safari などです。
device_os_extended_id int はい 137 オペレーティング システムの特定のバージョンの ID。 たとえば、iOS 16.0.0 などです。
device_os_extended_name string いいえ "Windows 10" オペレーティング システムの特定のバージョンの名前。 たとえば、iOS 16.0.0 などです。
device_os_family string いいえ "Android (2)" デバイス OS ファミリ名と ID で構成される文字列。
device_os_family_id int はい 2 デバイスのオペレーティング システムの ID。 たとえば、Microsoft Windows、Apple iOS などです。
device_os_family_name string いいえ "Android" デバイスのオペレーティング システムの名前。 たとえば、Microsoft Windows、Apple iOS などです。
device_type_id int はい 1 デバイスのカテゴリ:
- 0 = 不明
- 1 = デスクトップ & ノート PC
- 2 = 携帯電話
- 3 = タブレット
- 4 = テレビ
- 5 = ゲーム コンソール
- 6 = メディア プレーヤー
- 7 = トップ ボックスの設定
device_type_name string はい "mobile phones" デバイスのカテゴリの名前 (デスクトップ & ノート PC、携帯電話など)。
external_creative_id string はい 987654 クリエイティブに関連付けられている外部 ID が配信されます。
geo_country string はい "US" インプレッションが配信された国のコード。 たとえば、米国などです。
geo_country_name 文字列 いいえ "United States" インプレッションが配信された国の名前。 たとえば、米国。
hour date いいえ "2018-02-01-09:54" オークションの時間。
inventory_url string いいえ "myurl.com/(1234)" 広告呼び出しで検出されたドメインからのマップされた URL と、かっこ内の ID。
inventory_url_id string はい 1234 広告呼び出しで検出されたドメインからのマップされた URL ID。
inventory_url_name string はい 1234 広告呼び出しで検出されたドメインからのマップされた URL。
media_type string いいえ "Banner" 取引されたインプレッションに対するクリエイティブのカテゴリ。 たとえば、バナー、ビデオ、ネイティブなどです。
media_type_id int はい 1 取引インプレッションに対するクリエイティブのカテゴリの ID。
month date いいえ "2018-02" オークションの月。
placement_id int はい 456 要求が発生した配置の ID。
placement_name string いいえ "My Placement" 要求が発生した配置の名前。
psp_config_id int はい 10000 構成サービスを介した PSP 構成の一意識別子。 現時点では、 bid_responses_received、 valid_bid_on_imps、および imps_deliveredでのみ報告可能です。 今後、他のメトリックに対応するように更新される予定です。
publisher_id int はい 789 要求が発生したインベントリの発行元の ID。
publisher_name string いいえ "Neat Publisher Ltd" 要求が発生したインベントリの発行元の名前。
sdk_version string はい "pbjs-5.20.3" アプリに存在するソフトウェア開発キットのバージョン。
seller_member_id int はい 123 販売者メンバーの ID。
seller_member_name string いいえ "Cool Seller Inc" 販売者メンバーの名前。
site_id int はい 555 要求が発生したサイトの ID。
site_name string いいえ "My Site" 要求が発生したサイトの名前。
supply_type string はい "web" インベントリ (Web、モバイル Web、またはアプリ) のカテゴリ。 アプリには、CTV とモバイルが含まれています。
uap_response_error_type_id string はい TIMEOUT 入札要求から生成された特定のエラー。 各値の説明と潜在的な解決策については、以下の「 入札要求の入札要求エラーの種類 」の表を参照してください。

指標

列 種類 式 例 説明
average_clear_price double 「説明」を参照してください。 1.00 配信されたインプレッションの入札価格の合計を、送信された入札リクエストの数で割った値です。
average_response_time double bid_responses_received/bid_requests_sent。 0.08 需要パートナーから受信した入札応答の数を、送信された入札要求の数で割った数。
bid_errors int 「説明」を参照してください。 149908040 需要パートナーからの入札応答のエラーの数。
bid_errors_rate double bid_errors/bid_requests_sent 0.04 入札エラーの数を、需要パートナーに送信された入札要求の数で割った値です。
bid_request_error_rate double bid_request_errors/bid_requests_sent 0.05 入札要求エラーの数を、需要パートナーに送信された入札要求の数で割った値。
bid_request_errors int 「説明」を参照してください。 200 入札要求から生成された特定のエラーの数。 各値の説明と潜在的な解決策については、以下の 「入札要求エラーの種類 」の表を参照してください。
bid_requests_sent int 「説明」を参照してください。 3990674680 Prebid Server Premium から Demand パートナーに送信された要求の数。
bid_rejection_error_rate int bid_rejection_errors/bid_responses_received 0.06 入札拒否エラーの数を、需要パートナーから受け取った入札応答の数で割った値です。
bid_rejection_errors int 「説明」を参照してください。 300 需要パートナーの入札応答からの特定のエラーの数。 各値の説明と潜在的な解決策については、 入札エラー コード に関するページを参照してください。
bid_rate int bid_responses_received/bid_requests_sent 0.08 需要パートナーから受信した入札応答の数を、送信された入札要求の数で割った数。
bid_responses_received int 「説明」を参照してください。 381809500 需要パートナーの入札応答からの特定のエラーの数。 各値の説明と潜在的な解決策については、 入札エラー コード に関するページを参照してください。
bids_submitted_to_ad_server int 「説明」を参照してください。 54021580 広告サーバーに返された追加の Microsoft 拒否の影響を受けなかった有効な事前入札を行った広告リクエストの数。 この数値は、すべてのソースから受け取った入札を評価する Microsoft オークション プロセスの後にカウントされます。 valid_bid_on_impsとこの指標の間の減少量は、クリエイティブの要件が満たされていない、他の入札者によって制限されている、または広告サーバーに上位の入札のみを送信するオプションが原因である可能性があります。
bidder_user_matched_requests int 「説明」を参照してください。 1849169240 ユーザー識別子が存在する要求の数。

手記： このメトリックには、現在、Web およびモバイル Web 用の Cookie のみが含まれています。
imps_delivered int 「説明」を参照してください。 4804540 正常に配信され、広告がレンダリングされたインプレッションの数。

手記： このレポートは、PSP アクティビティの全量を推定するために乗算されたサンプル ログ データに基づいており、最終的な配信を表すものではありません。
no_bid_rate double no_bids/bid_requests_sent 0.87 需要パートナーが入札しなかった回数を、需要パートナーに送信された入札要求の数で割った回数。
no_bids int 「説明」を参照してください。 3461831640 要求に対してデマンド パートナーが入札しなかった回数。 これには入札エラーは含まれません。
total_bid_price int 「説明」を参照してください。 171869242 需要パートナーから受け取った入札値の合計。
total_buyer_spend double 「説明」を参照してください。 11234.88 配信されたインプレッションの購入者に対するメディア コスト。

手記： このレポートは、PSP アクティビティの全量を推定するために乗算されたサンプル ログ データに基づいており、最終的な配信を表すものではありません。
user_matched_requests_rate double bidder_user_matched_requests/bid_requests_sent 0.46 ユーザーが一致した要求の数を、需要パートナーに送信された入札要求の数で割った数。
valid_bid_on_imps int 「説明」を参照してください。 378935000 エラーをトリガーせず、クリエイティブ ID を持ち、0 ドルを超える入札がある PSP デマンド パートナーから受け取った入札の数。 複数の PSP デマンド パートナーが入札を返すと、オークションごとに複数の入札がカウントされる場合があります。
valid_bids_on_imp_rate double valid_bid_on_imps/bid_responses_received 0.09 有効な入札の数を、需要パートナーに送信された入札要求の数で割った値です。
win_rate double imps_delivered/bid_responses_received 0.01 このメトリックは、需要パートナー ディメンションが適用された場合にのみ使用する必要があります。 これは、需要パートナーが配信したインプレッションの割合を、受信した合計入札応答に対して表します。 この計算では、需要パートナーによって配信されたインプレッションの数を、受信した入札応答の合計数で割ります。

入札要求エラーの種類

コード エラー 説明 修復方法
0 NONE エラーはありません。 必要ありません。
1 INTERNAL 400 ステータス コードなど、デマンド パートナーからサーバー側エラーが発生します。 販売者は Microsoft と協力して、調査のために需要パートナーと共有する特定のコード例を収集する必要があります。
2 TIMEOUT 要求パートナーがタイムアウト制限内で応答しませんでした。 タイムアウト設定を増やして応答時間を長くするか、デマンド パートナーに連絡して制限を通知します。 タイムアウトの詳細については、「 PSP グローバル設定の追加または編集」を参照してください。
3 CLIENT デマンド パートナーの Prebid Server アダプターでエラーが発生しました。 このエラーの種類が多い場合、販売者は Microsoft サポートに問い合わせて、内部の Microsoft ログを確認して問題を診断する必要があります。 このエラーの例としては、ビデオ電源がサポートされていないアダプターに送信されている可能性があります。
4 PARSE 需要パートナーが入札応答の形式が正しくありません。 販売者は、Microsoft とデマンド パートナーと連携して、特定の書式設定の問題を特定して解決する必要があります。

注:

入札応答エラーの種類については、「 入札エラー コード」を参照してください。

例

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

JSON ファイルには、"psp_health_analytics"のreport_typeと、取得する列 (ディメンションとメトリック) とreport_intervalが含まれている必要があります。 また、特定のディメンションをフィルター処理し、粒度 (year、 month、 day) を定義し、データを返す "format" ("csv"、 "excel"、または "html") を指定することもできます。 JSON ファイルに含めることができるフィールドの詳細については、 レポート サービスに関するページを参照してください。

$ cat psp_health_analytics
   {"report": 
    {
        "format": "csv",
        "report_interval": "yesterday",
        "columns": ["hour", "publisher_id","site_id","header_bidding_demand_partner", "imps", "seller_revenue", "view_rate"],
        "report_type": "psp_health_analytics"
    }
}

POST Report サービスへの要求

POST レポート ID を取得するための JSON 要求。

$ curl -b cookies -c cookies -X post -d @psp_health_analytics "https://api.appnexus.com/report"
{
   "response":{
      "status":"OK",
      "report_id":"97a181df6d77a8f3cd5a45eff4ea3dab"
   }
}

GET レポート サービスからのレポートの状態

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

$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=97a181df6d77a8f3cd5a45eff4ea3dab'
{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2014-11-19 21:57:00",
            "json_request": "{\"report\":{\"format\":\"csv\",\"report_interval\":\"yesterday\",\"row_per\":[\"publisher_id\"],\"columns\":[\"hour\", \"publisher_id\",\"site_id\",\"header_bidding_demand_partner\",\"imps\",\"seller_revenue\", \"view_rate\"],\"report_type\":\"psp_health_analytics\"
            "url": "report-download?id=97a181df6d77a8f3cd5a45eff4ea3dab"
        },
        "execution_status": "ready"
    }
}

GET Report Download サービスからのレポート データ

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

注:

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

curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=97a181df6d77a8f3cd5a45eff4ea3dab' > /tmp/psp_health_analytics.csv

注:

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