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
、、) を定義し、month
day
データを"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"
}
}
POST
Report 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 は、前GET
のurl
呼び出しに対する応答のフィールドにあります。 保存するファイルを特定するときは、最初 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 行の制限があります。