Prebid Server Premium Seller Analytics

Prebid Server Premium Seller Analytics レポートには、構成された Prebid Server Premium (PSP) 需要パートナーに関するパフォーマンス情報が含まれています。 このレポートを使用すると、次のことができます。

  • 見出し入札者の需要パートナー、発行元、または地理的リージョンによって収益を追跡します。
  • ヘッダー入札需要に対して開いた在庫のリフトを追跡します。
  • Prebid Server Premium パートナーと配置の正常性と効率性を監視します。

API を使用したその他のレポートについては、「 Report Service」を参照してください。 UI 経由でデータにアクセスする方法については、「Microsoft 収益化および Prebid Server Premium Seller Analytics レポートレポート ガイド」を参照してください。

時間枠

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

  • last_hour
  • last_48_hours
  • 今日
  • yesterday
  • last_7_days
  • month_to_date
  • quarter_to_date
  • last_month
  • 有効 期間
  • month_to_yesterday

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

データ保持期間

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

Dimensions

Column 種類 フィルター。 説明
hour date いいえ "2018-02-01-09:54" オークションの時間。
month date いいえ "2018-02" オークションの月。
day date はい "2018-02-01" オークションの日。
seller_member_id int はい 123 販売者メンバーの ID。
seller_member_name string いいえ "Cool Seller Inc" 販売者メンバーの名前。
tag_id int はい 456 配置タグの ID。
publisher_id int はい 789 発行元の ID。
publisher_name string いいえ "Neat Publisher Ltd" 発行元の名前。
publisher string いいえ "Neat Publisher Ltd (789)" 発行元名と発行元 ID で構成される文字列。
size string はい 300x250 インプレッションに関連付けられている配置の幅と高さ。
geo_country string はい "US" 国の省略形。
geo_country_name string いいえ "United States" 地理的な国の名前。
site_id int はい 555 サイトの ID。 詳細については、 サイト サービスに関するページを参照してください。
site_name string いいえ "My Site" サイトの名前。 詳細については、 サイト サービスに関するページを参照してください。
site string いいえ "My Site (555)" サイトの名前と ID を含む文字列。 詳細については、 サイト サービスに関するページを参照してください。
tag_name string いいえ "My Placement" インプレッションに関連付けられているタグの名前。
header_bidding_demand_partner_id int いいえ 9645 配置に関連付けられている需要パートナーの ID。
header_bidding_demand_partner_name string いいえ "PubMatic (PSP)" 配置に関連付けられている需要パートナー。
header_bidding_demand_partner string いいえ "PubMatic (PSP) (9645)" 配置に関連付けられている需要パートナーの名前と ID。
included_header_bidding_demand int はい 654 Xandr 以外の需要パートナーからの需要が含まれています。

指標

Column 説明
imps int 34534 Imps 合計インプレッション数 (既定値を含む)。
seller_revenue お 金 999.99 売り手収益の合計 取引の売り手収益。ドル金額として表されます。
seller_ecpm お 金 1.00 「説明」を参照してください eCPM で表される取引の販売者収益。
view_measured_imps int 1500 「説明」を参照してください 視認性のために測定されたインプレッションの合計数。
view_rate double 87.00 imps_viewed/view_measured_imps 視認性を測定したインプレッションの総数のうち、表示可能だったインプレッションの割合。
view_measurement_rate int 91.00 view_measured_imps/imps 総インプレッション数のうち視認性を測定したインプレッションの割合。
imps_viewed int 1100 「説明」を参照してください 配置の表示可能なインプレッションの数。
ad_requests int 1200 「説明」を参照してください 配置に関連付けられている広告リクエストの数。
fill_rate double 85.00 保持されたインプレッション数と再販インプレッション数/合計インプレッション数 需要が満たされた広告リクエストの割合。 (保持されたインプレッション数と再販インプレッション数/合計インプレッション数)。

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

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

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

POSTReport Service への要求

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

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

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

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

$ 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\":\"prebid_server_analytics\"
            "url": "report-download?id=97a181df6d77a8f3cd5a45eff4ea3dab"
        },
        "execution_status": "ready"
    }
}

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

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

注:

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

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

注:

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