Bidder - インベントリの可用性レポート
インベントリ可用性レポートでは、プラットフォームで利用可能なインベントリの種類に関する分析情報が提供されます。 これらのレポートは、要求によってのみ使用できます。 Microsoft Advertising カスタマー サポート ポータルを使用してください。 インプレッションの可用性データベースの構造により、レポートのディメンションは以下に示すものに制限されます。 以下の点にもご注意ください。
- Microsoft のデータベースには、30 日分の履歴インベントリ可用性データが含まれています。 したがって、レポートはこの期間に制限されます。
- モバイルインプレッションには、追加のレポート制限が適用される場合があります。 詳細については、Xandr の担当者にお問い合わせください。
期限
このレポートは、カスタム時間枠に対して実行し、レポート要求の start_date
フィールドと end_date
フィールドを設定できます。 これらのフィールドの詳細については、「 Report Service」を参照してください。
データ保持期間
このレポートのデータは 30 日間保持されます。
Dimensions
列 | 種類 | フィルター。 | 例 | 説明 |
---|---|---|---|---|
day |
date | はい | "2023-04-18" |
印象の日。 |
month |
date | はい | "2023-04" |
印象の月。 |
seller_member_id |
int | はい | 9876 |
販売メンバーの内部 ID。 |
seller_member_name |
文字列 | いいえ | "CNN" |
販売者メンバーの表示名 |
size |
string | はい | "120"x"600" |
クリエイティブの標準サイズ。 サイズの詳細については、「 メンバー サービスから返されるstandard_sizes」を参照してください。 |
geo_country |
string | はい | "US" |
インプレッションに関連付けられている地理的な国または地域のコード。 |
imp_type_id |
int | はい | 5 |
インプレッションの種類の ID。 使用可能な値 (かっこ内の関連する型):1 ("Blank") : クリエイティブは提供されません。2 ("PSA") : 有効な入札がなく、既定のクリエイティブが利用できなかったため、パブリック サービスのお知らせが配信されました。3 ("Default Error") : タイムアウトの問題が原因で提供される既定のクリエイティブ。4 ("Default") : 有効な入札がなかったため、既定のクリエイティブが配信されました。5 ("Kept") : 広告主のクリエイティブがパブリッシャーのサイトで配信されます。6 ("Resold") : 発行元の印象がサード パーティの購入者に販売されました。7 ("RTB") : 広告主のクリエイティブがサード パーティのインベントリに掲載されました。8 ("PSA Error") : タイムアウトの問題や既定のクリエイティブがないため、パブリック サービスのお知らせが配信されます。9 ("External Impression") : インプレッション トラッカーからのインプレッション。10 ("External Click") : クリック トラッカーからのクリック。 |
site_domain |
string | はい | bestsiteever.com |
インプレッションが発生したドメイン。 モバイル アプリケーションの場合は、アプリ ストア内のアプリの場所の URL を指定できます。 ドメインの代わりに表示される 2 つの追加の値があります。具体的には、 "deals.unknown" または "managed.unknown" 。 これは、有効なドメインを参照元として受け取らなかったことを意味します。 たとえば、ドメインが空白であるか、形式が正しくない場合があります。 |
media_type_id |
int | はい | 5 |
特定のメディアの種類に関連付けられている ID。 たとえば、ビデオです。 詳細については、「 Media Type Service」を参照してください。 |
audit_type_id |
int | はい | 2 |
監査の優先順位の整数コード。 有効な値は次のとおりです。1 : Standard2 :優先権 |
browser_id |
int | はい | 3 |
特定のブラウザーに関連付けられている ID。 たとえば、Microsoft Edge などです。 詳細については、「 ブラウザー サービス」を参照してください。 |
mobile_application |
文字列 | いいえ | "Angry Birds (com.rovio.angrybirds)" |
モバイル アプリケーションの名前の後に、Xandr の形式の ID が続きます。 |
language_id |
int | はい | 1 |
特定のブラウザーに関連付けられている ID。 たとえば、英語です。 詳細については、「 Language Service」を参照してください。 |
operating_system_family_id |
int | はい | 5 |
特定のオペレーティング システム ファミリに関連付けられている ID。 たとえば、Microsoft Windows などです。 詳細については、「 オペレーティング システム ファミリ サービス」を参照してください。 |
datacenter_id |
int | はい | 001 |
要求を要求パートナーにルーティングするために使用されるデータ センターの ID。 |
seller_join_date |
int | はい | 20220901 |
販売者メンバーが追加された日付。 1 年未満の場合、正確な日付が表示されます。1 年以上の場合、結合日は +1 年として表示されます。 |
mobile_application_id |
string | はい |
"343200656" (iOS) または "com.rovio.angrybirds" (Android) |
対象となる Apple App Store ID、Google Play パッケージ名、または Windows アプリケーション ID。 |
device_type |
int | はい | 1 |
インプレッションが配信されたデバイスの種類 ID。 使用可能な値は次のとおりです。0 (その他のデバイス)1 (デスクトップ & ノート PC)2 (携帯電話)3 (タブレット)4 (テレビ)5 (ゲーム コンソール)6 (メディア プレーヤー)7 (トップ ボックスの設定) |
指標
列 | 型 | 例 | 式 | 説明 |
---|---|---|---|---|
imps |
int | 1000 |
imps | 使用可能なインプレッションの数。 |
例
JSON 形式のレポート要求を作成する
JSON ファイルには、"platform_inventory_availability"
のreport_type
と、取得するcolumns
(ディメンションとメトリック) とreport_interval
が含まれている必要があります。 また、特定のディメンションをフィルター処理し、粒度 (year
、 month
、 day
) を定義し、データを返す format
(csv
、 excel
、または html
) を指定することもできます。 JSON ファイルに含めることができるフィールドの詳細については、 レポート サービスに関するページを参照してください。
$ cat platform_inventory_availability
{
"report": {
"columns": [
"day",
"seller_member_name",
"audit_type",
"size",
"device_type",
"operating_system_family",
"geo_country",
"imps"
],
"format": "csv",
"report_interval": "today",
"report_type": "platform_inventory_availability"
}
}
POST
レポート サービスへの要求
$ curl -b cookies -X POST -d @platform_inventory_availability 'https://api.appnexus.com/report'
{
"response":{
"status":"OK",
"report_id":"6b177543a9411ffa67b09bdf5e76cac1"
}
}
GET
レポート サービスからのレポートの状態
$ curl -b cookies 'https://api.appnexus.com/report?id=6b177543a9411ffa67b09bdf5e76cac1'
{
"response":{
"status":"OK",
"report":{
"name":null,
"created_on":"2020-08-25 13:03:37",
"json_request":"{\"report\":{\"report_type\":\"platform_inventory_availability\",\"columns\":[\"day\",\"seller_member_name\",\"audit_type\",\"imps\",\"size\",\"device_type\,\"operating_system_family\,\"geo_country\"],\"report_interval\":\"today\",\"format\":\"csv\",\"grouping\":{\"additional_grouping_sets\":[],\"unselected_implicit_groupings\":[],\"additional_groups_on_bottom\":true},\"timezone\":\"UTC\",\"filters\":[{\"device_type\":\"123456\"}],\"reporting_decimal_type\":\"decimal\",\"use_cache\":true},\"extraction_version\":\"refactored\",\"end_date\":1598400000,\"start_date\":1598313600,\"user_id\":\"987654\"}",
"url": "report-download?id=6b177543a9411ffa67b09bdf5e76cac1"
},
"execution_status":"ready"
}
}
GET
レポート ダウンロード サービスからのレポート データ
レポート データをファイルにダウンロードするには、レポート ID を使用して別の GET
呼び出しを行いますが、今回は レポート ダウンロード サービスに呼び出します。 サービスとレポート ID は、前のGET
応答の [url
] フィールドにあります。 保存するファイルを特定するときは、最初のPOST
で指定した"format"
のファイル拡張子を使用してください。
注:
ダウンロード中にエラーが発生した場合、応答ヘッダーには HTTP エラー コードとメッセージが含まれます。 応答ヘッダーを公開するには、呼び出しで
-i
または-v
を使用します。XLSX および Excel ファイルとしてダウンロードする場合、レポートごとに 100,000 行の制限があります。
$ curl -b cookies 'https://api.appnexus.com/report-download?id=6b177543a9411ffa67b09bdf5e76cac1' > /tmp/platform_inventory_availability.csv