プラットフォーム販売者レポート
プラットフォーム販売者レポートは、購入者に請求書を送ったり、内部トランザクション レコードを調整したりするために使用できます。 このレポートを使用すると、トランザクション情報をタグ レベルで表示できます。
このレポートを取得する手順については、以下の 例 を参照してください。
時間枠
JSON 要求のフィールドは report_interval
、次のいずれかに設定できます。
current_hour
last_hour
today
yesterday
last_48_hours
last_7_days
month_to_yesterday
month_to_date
quarter_to_date
last_month
lifetime
mtd
Dimensions
Column | 種類 | グループ。 | フィルター。 | 説明 |
---|---|---|---|---|
bidder |
文字列 | いいえ | 不要 | 廃止。 |
bidder_id |
int | はい | はい | 入札者の内部 ID。 |
bidder_name |
文字列 | いいえ | 不要 | 入札者の表示名。 |
buyer_member |
文字列 | いいえ | 不要 | 廃止。 |
buyer_member |
文字列 | いいえ | いいえ | 購入メンバーの表示名の後に ID (Xandr 形式) が続きます。 |
buyer_member_id |
int | はい | はい | 購入メンバーの内部 ID。 |
buyer_member_name |
文字列 | いいえ | いいえ | 購入メンバーの表示名。 |
buyer_member_name |
文字列 | いいえ | いいえ | 購入者メンバーの表示名。 |
cleared_direct |
int | 不要 | はい | これが 1 に設定されている場合、インプレッションは直接インベントリで正常に配信されました。 使用可能な値: - 0 = 直接インベントリではない- 1 = 直接インベントリ |
day |
date | はい | はい | 日 |
gender |
文字列 | いいえ | はい | ユーザーの性別。 |
geo_country |
文字列 | いいえ | はい | 国の表示名の後に ID (Xandr 形式) が続きます。 |
geo_country_name |
文字列 | いいえ | 不要 | 国。 |
hour |
date | はい | はい | オークションの時間。 注: 100 日を超えるインプレッションの場合、1 時間ではなく日が返されます。 |
imp_type |
文字列 | いいえ | はい | 配信されたインプレッションの種類。 使用可能な値: - 1 = 空白- 2 = PSA- 3 = 既定のエラー- 4 = 既定値- 5 = 保持- 6 = 再販- 7 = RTB- 8 = 既定のエラーに起因する PSA- 9 = 外部インプレッション- 10 = 外部クリック |
is_delivered |
ブール値 | いいえ | はい | true の場合、インプレッションは正常に配信されました。 |
is_dw |
ブール値 | いいえ | はい | true の場合、インプレッションは Xandr によって提供されました。 |
month |
time | はい | 不要 | 月 |
price_bucket_id |
int | はい | 不要 | 価格バケットの ID。 価格バケットの詳細については、メンバー サービスのフィールドのprice_buckets 説明を参照してください。 |
publisher |
文字列 | いいえ | いいえ | 廃止。 |
publisher_code |
文字列 | いいえ | 不要 | 外部システム内の発行元コードに対応するために入力された発行元のカスタム コード。 |
publisher_id |
int | はい | はい | パブリッシャーの内部 ID。 |
publisher_name |
文字列 | いいえ | 不要 | 発行元の表示名。 |
seller_currency |
文字列 | いいえ | はい | 販売者メンバーが選択した通貨。 サポートされている通貨の一覧については、「 サポートされている通貨」を参照してください。 |
seller_member |
文字列 | いいえ | 不要 | 廃止。 |
seller_member_id |
int | はい | はい | メンバーの内部 ID。 |
seller_member_name |
文字列 | いいえ | 不要 | 販売者メンバーの表示名。 |
site |
文字列 | いいえ | 不要 | 廃止。 |
site_code |
文字列 | いいえ | 不要 | 外部システム内のサイト コードに対応するために入力されたサイトのカスタム コード。 |
site_id |
int | はい | はい | サイトの内部 ID。 |
site_name |
文字列 | いいえ | 不要 | サイトの表示名。 |
size |
文字列 | いいえ | 不要 | クリエイティブのサイズ。 |
supply_type |
文字列 | いいえ | 不要 | インベントリの種類。 使用可能な値: - "web" - "mobile_web" - "mobile_app" |
tag |
文字列 | いいえ | 不要 | 廃止。 |
tag_id |
int | はい | 不要 | タグの ID。 |
tag_name |
文字列 | いいえ | 不要 | タグの表示名。 |
year |
date | はい | はい | 年。 |
指標
Column | 種類 | 式 | 説明 |
---|---|---|---|
auction_service_deduction |
お 金 | auction_service_deduction |
RTB の控除は、購入者メンバーの契約で指定されたインプレッションを購入しました。 たとえば、10% の控除で、キャンペーンの予算が $1000 の場合、そのキャンペーンから $100 を受け取り、販売者から在庫を購入するために使用される $900 を買い手に残します。 |
auction_service_fees |
お 金 | auction_service_fees |
RTB で請求された料金は、購入者メンバーの契約で指定されたインプレッションを購入しました。 たとえば、10% の手数料で、購入者が在庫に $1000 を費やした場合、100 ドルの手数料が請求されます。 |
buyer_spend |
お 金 | buyer_spend |
買い手がメディアのコストに対して支払う金額。 |
clear_fees |
お 金 | clear_fees |
外部またはパートナーの販売者から購入したインプレッションに対して請求される購入者メンバーの契約で指定された料金。 |
clicks |
int | clicks |
クリックの合計数。 |
creative_overage_fees |
お 金 | creative_overage_fees |
購入者メンバーの契約で指定されたクリエイティブ サイズ制限を超えるホストクリエイティブの料金。 |
imps |
int | imps |
合計インプレッション数 (配信数と再販回数)。 |
imps_delivered |
int | imps_delivered |
正常に配信されたインプレッションの合計数。 |
imps_not_delivered |
int | imps_not_delivered |
Xandr 以外のユーザーがインプレッションを提供したインプレッションの合計数。 |
imps_viewed |
int | imps_viewed |
IAB ビューアビリティ定義に従って表示可能だった測定されたインプレッションの数。これは、1 秒間にピクセルの 50% が表示されている場合に表示可能であることを示します。 |
seller_ecpm |
お 金 | ( seller_revenue / imps_delivered ) * 1000 |
売り手の収益は eCPM で表されます。 |
seller_ecpm_seller_curr |
お 金 | (seller_revenue / imps_delivered ) * 1000、売り手の通貨で表されます。 |
販売者が選択した通貨で、eCPM で表される販売者の収益。 サポートされている通貨の一覧については、「 サポートされている通貨」を参照してください。 |
seller_revenue |
お 金 | seller_revenue |
インプレッションあたりの販売者の収益。 |
seller_revenue_seller_curr |
お 金 | seller_revenue は、販売者の通貨で表されます。 |
選択した通貨でのインプレッションあたりの販売者の収益。 サポートされている通貨の一覧については、「 サポートされている通貨」を参照してください。 |
view_measurable_rate |
double | view_measurable_rate |
総インプレッション数のうち視認性を測定したインプレッションの割合。 (測定された Imps/Imps を表示する) |
view_measured_imps |
int | view_measured_imps |
視認性のために測定されたインプレッションの合計数。 |
view_rate |
double | view_rate |
視認性を測定したインプレッションの総数のうち、表示可能だったインプレッションの割合。 (表示された Imps/View Measured Imps) |
管理者にのみ表示
Column | 種類 | 式 | 説明 |
---|---|---|---|
forex_allowance |
お 金 | forex_allowance |
外貨バッファー許容量。 |
discrepancy_allowance |
お 金 | discrepancy_allowance |
売り手メンバーの契約で指定された RTB 販売インプレッションの控除。 これは、Xandr と供給パートナーが獲得したインプレッションとして記録された過去の不一致に基づいて決定されます。 |
例
JSON 形式のレポート要求を作成する
JSON ファイルには、取得する report_type "platform_buyer"
、 columns
、および (ディメンションとメトリック) report_interval
が含まれている必要があります。 また、特定のディメンションをフィルター処理し、粒度 (年、月、日) を定義し、データを返す形式 (csv、excel、または html) を指定することもできます。 JSON ファイルに含めることができるフィールドの詳細については、 レポート サービスに関するページを参照してください。
$ cat report
{
"report": {
"report_type": "platform_seller",
"timezone": "PST",
"report_interval": "last_7_days",
"name": "SSP Monthly Buyer Report",
"columns": [
"day",
"seller_member",
"publisher_id",
"publisher_name",
"publisher_code",
"buyer_member_id",
"buyer_member_name",
"imps",
"imps_delivered",
"seller_revenue",
"buyer_spend"
]
}
}
ヒント
日順を指定するには、"columns" 配列の後にこのオブジェクトを JSON ファイルに挿入します。
"orders": ["day"]
レポート サービスに要求を POST する
$ curl -b cookies -c cookies -X POST -d @report 'https://api.adnxs.com/report'
{
"response": {
"status": "OK",
"report_id": "bfe2ba2ea54a51115db942d591a7b5d9",
}
}
レポート サービスからレポートの状態を取得する
レポート ID を GET
使用して呼び出しを行って、レポートの状態を取得します。 が "ready"
になるまでこのGET
呼び出しを"execution_status"
続けます。 次の手順で説明するように、レポート ダウンロード サービスを使用してレポート データをファイルに保存します。
$ curl -b cookies -c cookies 'https://api.adnxs.com/report?id=bfe2ba2ea54a51115db942d591a7b5d9'
{
"response":{
"status":"OK",
"report":{
"name":null,
"created_on":"2010-05-25 19:19:53",
"url": "report-download?id=bfe2ba2ea54a51115db942d591a7b5d9"
},
"execution_status":"ready"
}
}
レポート ダウンロード サービスからレポート データを取得する
レポート データをファイルにダウンロードするには、レポート ID を使用して別 GET
の呼び出しを行いますが、今回は report-download サービスに対して呼び出します。 サービスとレポート ID は、前 GET
の応答の "url" フィールドにあります。 保存するファイルを特定するときは、最初 POST
に 指定した "形式" のファイル拡張子を使用してください。
ヒント
ダウンロード中にエラーが発生した場合、応答ヘッダーには HTTP エラー コードとメッセージが含まれます。 応答ヘッダーを公開するには、呼び出しで "-i" または "-v" を使用します。
$ curl -b cookies -c cookies 'https://api.adnxs.com/report?id=bfe2ba2ea54a51115db942d591a7b5d9' > report.csv
レポートを最初に投稿したときの応答で指定された ID を使用します。
頻繁に実行されるレポートをスケジュールする
定期的にプルするレポートをスケジュールできます。 詳細については、「 保存されたレポート サービス 」を参照してください。