拡張 Bidder プロファイル
Bidder プロファイルはトラフィックをフィルター処理し、入札者がオブジェクトにビジネス ルールを適用できるようにします。 これは、特定の種類のトラフィックが受信されているか、受信されていないことを確認するためです。 Xandr はあなたと提携し、ビジネス ニーズに合ったプロファイルを確保するための適切なツールを提供します。
大まかな変更
レガシから現在の拡張入札者プロファイルへの変更の一覧については、 変更ログを参照してください。
- インプレッションは、合格するためにいずれかのプロファイルの要件を満たす必要があります。
- 親子階層がなくなった
- 階層の変更の詳細については、「 拡張入札者プロファイルの階層と広告の種類のターゲティング」を参照してください。
- 広告の種類のフィルタリングとターゲット設定が追加されました。
- ネイティブ、バナー、ビデオ、オーディオをブロック/ターゲットできるようになりました
- 広告の種類のターゲティングの詳細については、「拡張入札者プロファイルの階層と広告の種類のターゲティング」を参照してください。
- パススルー率の削除。
- DC ごとに QPS キャップを設定できるようになりました。
- QPS 上限を設定する方法の詳細については、「Bidder Instance Service」を参照してください。
- Exchange ターゲティングの追加
- インベントリをわかりやすいグループにグループ化しました
- 交換の詳細については、Exchange サービスに関するページを参照してください。
REST API
| HTTPS メソッド | エンドポイント | 説明 |
|---|---|---|
| POST | https://api.adnxs.com/bidder-profile/BIDDER_ID |
新しいプロファイルを追加する |
| PUT | https://api.adnxs.com/bidder-profile/BIDDER_ID/PROFILE_ID |
既存のプロファイルを変更する |
| 取得 | https://api.adnxs.com/bidder-profile/BIDDER_ID |
入札者に関連付けられているすべてのプロファイルを表示するには |
| GET | https://api.adnxs.com/bidder-profile/BIDDER_ID/PROFILE_ID |
入札者に関連付けられている特定のプロファイルを表示するには |
JSON フィールド
| フィールド | 種類 | 説明 |
|---|---|---|
id |
int | 入札者プロファイルの ID。 これは読み取り専用フィールドです。 |
bidder_id |
int | 入札者の ID。 これは読み取り専用フィールドです。 |
code |
string | 入札者プロファイルの代替識別子。入札者に固有です。 |
description |
string | 入札者プロファイルの説明。 |
active |
ブール型 | プロファイルがアクティブ化されているかどうかを示します。 false の場合、このプロファイルは入札者に送信されるトラフィックには影響しません。 |
targeting |
object | この入札者プロファイルのターゲット設定ルール。 詳細については、以下 の「ターゲット設定 」を参照してください。 |
user_not_in_segment_action |
列挙 | に設定されている include場合: すべてのユーザーのインプレッションが入札者に送信されます。に exclud設定されている場合: 入札者が所有または共有しているセグメントにユーザーが存在するインプレッションのみが送信されます。 このフィールドには QPS の制限が適用されます。 入札者は、セグメント アクションでセグメントを明示的に指定する必要はありません。注: このフィールドは、 を優先 unknown_users_actionして非推奨になります。 |
unknown_users_action |
列挙 | に設定されている include場合: すべてのユーザーのインプレッションが入札者に送信されます。に exclude設定されている場合: ユーザーが Xandr Cookie にマップされた社内 ID を持つインプレッションのみが送信されます。 マッピングは、bidder が setuid 関数を呼び出すときに発生します。 |
non_audited_url_action |
列挙 | に exclude設定すると、Xandr によって監査されていないすべてのインベントリが除外されます。 それ以外の場合は、すべてのインベントリが含まれます。 |
ターゲット
ターゲット オブジェクトには、次のフィールドが含まれています。
| フィールド | 種類 | 説明 |
|---|---|---|
exchanges |
object | このプロファイルに含まれる、または除外された取引所および販売者メンバー。 詳細については、以下の 「Exchange 」を参照してください。 |
countries |
object | このプロファイルに含まれるか除外されている国。 詳細については、以下の 「国 」を参照してください。 |
domain_lists |
object | このプロファイルに含まれるドメイン リストまたは除外されたドメイン リスト。 詳細については、以下の「ドメイン Lists」を参照してください。 |
ad_types |
object | 広告の種類 (バナー、ビデオなど) は、このプロファイルに含まれるか除外されます。 詳細については、以下の 「広告の種類」を 参照してください。 |
supply_types |
object | 供給の種類 (デスクトップ、モバイル アプリなど) は、このプロファイルに含まれるか除外されます。 詳細については、以下の 「供給タイプ」を 参照してください。 |
inventory_attributes |
オブジェクト | このプロファイルに含まれる、または除外されたインベントリ属性。 詳細については、以下の 「インベントリ属性 」を参照してください。 |
交換
exchange オブジェクトには、次のフィールドが含まれています。
| フィールド | 種類 | 説明 | 設定可能な値 |
|---|---|---|---|
action |
列挙 | targets 配列 (以下) の交換を含めるか除外するかを示します。 | include, exclude |
targets |
オブジェクトの配列 | プロファイルに含まれる、または除外された交換の一覧。 交換の詳細については、 Exchange サービス のドキュメントを参照してください。 |
{"id": 1}, {"id": 2}, {"id": 3} |
excluded_members |
オブジェクトの配列 | 入札者が除外する販売者の一覧。 対象となるメンバーの一覧については、 プラットフォーム メンバー サービス を参照してください。 | {"id": 181}, {"id": 459} |
included_members |
オブジェクトの配列 | 入札者が含める販売者の一覧。 対象となるメンバーの一覧については、 プラットフォーム メンバー サービス を参照してください。 注: Xandr の直接供給 (Exchange 1) に属する販売者を個別に含めることはできません。 詳細については、 Exchange サービス のドキュメントを参照してください。 |
{"id": 181}, {"id": 459} |
Countries
countries オブジェクトには、次のフィールドが含まれています。
| フィールド | 種類 | 説明 | 設定可能な値 |
|---|---|---|---|
action |
列挙 | targets 配列 (以下) の国を含めるか除外するかを示します。 | include, exclude |
targets |
オブジェクトの配列 | プロファイルに含まれる国または除外されている国の一覧。 対象となる国の一覧については、 Country Service を参照してください。 | {"id": 233}, {"id": 80} |
ドメイン リスト
ドメイン リスト オブジェクトには、次のフィールドが含まれています。
| フィールド | 種類 | 説明 | 設定可能な値 |
|---|---|---|---|
action |
列挙 | ターゲット配列 (以下) のドメイン リストが許可リストまたはブロックリスト内にあるかどうかを示します。 | include, exclude |
targets |
オブジェクトの配列 | プロファイルに含まれるドメイン リストまたは除外されたドメイン リストの一覧。 ドメイン リストの種類は、ターゲット設定の適用方法には影響しません。アクションを使用して、許可リストまたはブロックリストを構成します。 対象となるドメイン リストの一覧については、 ドメイン リスト サービス を参照してください。 | {"id": 12345}, {"id": 34567} |
広告の種類
広告の種類オブジェクトには、次のフィールドが含まれています。 広告の種類: 拡張入札者プロファイルの階層と広告の種類のターゲット設定の詳細については、以下を参照してください。
| フィールド | 種類 | 説明 | 設定可能な値 |
|---|---|---|---|
banner |
object | バナーの対象となるインプレッションが対象かどうかを示します。 特定の広告サイズを構成できます。 明示的に構成されていない場合は、含まれていると見なされます。 詳細については、以下の 「バナー 」を参照してください。 | {"id": 12345}, {"id": 34567} |
video |
object | 動画の対象となるインプレッションが対象かどうかを示します。 明示的に構成されていない場合は、含まれていると見なされます。 詳細については、以下の ビデオ を参照してください。 | |
native |
object | ネイティブの対象となるインプレッションが対象かどうかを示します。 明示的に構成されていない場合は、含まれていると見なされます。 詳細については、以下の 「ネイティブ」 を参照してください。 | |
audio |
object | オーディオの対象となるインプレッションが対象かどうかを示します。 明示的に構成されていない場合は、含まれていると見なされます。 詳細については、以下の 「オーディオ 」を参照してください。 |
バナー
バナー オブジェクトには、次のフィールドが含まれています。
| フィールド | 種類 | 説明 | 設定可能な値 |
|---|---|---|---|
action |
列挙 | バナーの対象となるインプレッションを含めるか除外するかを示します。 | include, exclude |
sizes |
オブジェクトの配列 | ターゲティングに含まれるバナー広告サイズの一覧。 クリエイティブサイズは除外できません。 | {"width": 300, "height": 250}, {"width": 728, "height": 90} |
ビデオ
ビデオ オブジェクトには、次のフィールドが含まれています。
| フィールド | 種類 | 説明 | 設定可能な値 |
|---|---|---|---|
action |
列挙 | 動画の対象となるインプレッションを含めるか除外するかを示します。 | include, exclude |
ネイティブ
ネイティブ オブジェクトには、次のフィールドが含まれています。
| フィールド | 種類 | 説明 | 設定可能な値 |
|---|---|---|---|
action |
列挙 | ネイティブの対象となるインプレッションを含めるか除外するかを示します。 | include, exclude |
オーディオ
オーディオ オブジェクトには、次のフィールドが含まれています。
| フィールド | 種類 | 説明 | 設定可能な値 |
|---|---|---|---|
action |
列挙 | オーディオの対象となるインプレッションを含めるか除外するかを示します。 | include, exclude |
供給の種類
supply types オブジェクトには、次のフィールドが含まれています。
| フィールド | 種類 | 説明 | 設定可能な値 |
|---|---|---|---|
action |
列挙 | targets 配列 (以下) の供給型を含めるか除外するかを示します。 | include, exclude |
targets |
文字列の配列 | プロファイルに含まれる、または除外される供給タイプの一覧。 | mobile_app, mobile_web, web |
インベントリ属性
inventory 属性オブジェクトには、次のフィールドが含まれています。
| フィールド | 種類 | 説明 | 設定可能な値 |
|---|---|---|---|
action |
列挙 | targets 配列 (以下) のインベントリ属性が含まれるかどうかを示します。 | include |
targets |
オブジェクトの配列 | プロファイルに含まれる、または除外されるインベントリ属性の一覧。 対象となる インベントリ属性 の一覧については、インベントリ属性サービスを参照してください。 割り当てられたインベントリ属性を持たないインベントリは、常にターゲットになります。 |
{"id": 2}, {"id": 16} |
例
その他の API の例については、API で GET 呼び出しを実行 する拡張 Bidder プロファイルの API ユース ケース を参照してください。
交換
{
"response": {
"status": "OK",
"count": 1,
"start_element": 0,
"num_elements": 100,
"bidder_profiles": [{
"id": 00,
"bidder_id": 00,
"code": null,
"description": null,
"targeting": {
"exchanges": {
"action": "include",
"targets": [{
"id": 1,
"name": "Direct"
}],
"excluded_members": [{
"id": 5,
"billing_name": "Supply_source"
}],
"included_members": [{
"id": 7,
"billing_name": "Supply_source_two"
}]
}
},
"last_activity": "2018-07-24 17:05:00",
"created_on": "2018-07-20 18:16:19",
"active": true
}]
}
}
国
{
"response": {
"status": "OK",
"count": 1,
"start_element": 0,
"num_elements": 100,
"bidder_profiles": [
{
"id": 00,
"bidder_id": 0,
"code": "my_code",
"description": "EMEA Profile",
"targeting": {
"countries": {
"action": "include",
"targets": [
{
"id": 18,
"name": "Australia",
"code": "AU",
"active": true
},
{
"id": 41,
"name": "Canada",
"code": "CA",
"active": true
},
{
"id": 105,
"name": "Ireland",
"code": "IE",
"active": true
},
{
"id": 173,
"name": "New Zealand",
"code": "NZ",
"active": true
},
{
"id": 80,
"name": "United Kingdom",
"code": "GB",
"active": true
},
{
"id": 233,
"name": "United States",
"code": "US",
"active": true
}
]
},
"last_activity": "2018-07-24 19:47:54",
"created_on": "2018-07-24 19:47:49",
"active": true,
"user_not_in_segment_action": "include"
}
],
"dbg": {
"warnings": [
],
"version": "1.18.701",
"output_term": "bidder_profiles"
}
}
}
ドメイン リスト
{
"response": {
"status": "OK",
"count": 2,
"start_element": 0,
"num_elements": 100,
"bidder_profiles": [
{
"id": 00,
"bidder_id": 00,
"code": null,
"description": null,
"targeting": {
"domain_lists": {
"action": "exclude",
"targets": [
{
"id": 140000,
"name": "Additional Block List",
"description": "Block list",
"type": "black"
},
{
"id": 800000,
"name": "Domain list (blocklist)",
"description": "Domain list (blocklist)",
"type": "black"
}
]
},
"last_activity": "2018-07-24 17:05:31",
"created_on": "2018-07-20 18:21:00",
"active": true
}
],
"dbg": {
"warnings": [
],
"version": "1.18.701",
"output_term": "bidder_profiles"
}
}
}
広告の種類
{
"response": {
"status": "OK",
"count": 1,
"start_element": 0,
"num_elements": 100,
"bidder_profiles": [
{
"id": 00,
"bidder_id": 000,
"code": "Company_test",
"description": "Company Parent Test",
"targeting": {
"ad_types": {
"banner": {
"action": "include",
"sizes": [{
"width": 200,
"height": 200
}, {
"width": 50,
"height": 50
}]
},
"video": {
"action": "exclude"
"sizes": [{
"width": 200,
"height": 200
}, {
"width": 50,
"height": 50
}]
}, },
"audio": {
"action": "exclude"
},
"native": {
"action": "include"
}
}
},
"last_activity": "2018-07-24 19:47:54",
"created_on": "2018-07-24 19:47:49",
"active": true,
"non_audited_url_action": "include"
}
],
"dbg": {
"warnings": [
],
"version": "1.18.701",
"output_term": "bidder_profiles"
}
}
}
供給の種類
{
"response": {
"status": "OK",
"count": 1,
"start_element": 0,
"num_elements": 100,
"bidder_profiles":
[
{
"id": 00,
"bidder_id": 000,
"code": "my_code",
"description": "Company Profile",
"targeting": {
"supply_types": {
"action": "include",
"targets": [
"web",
"mobile_web",
"mobile_app"
]
},
}
}
},
"last_activity": "2018-07-24 19:47:54",
"created_on": "2018-07-24 19:47:49",
"active": true,
"non_audited_url_action": "include"
}
],
"dbg": {
"warnings": [
],
"version": "1.18.701",
"output_term": "bidder_profiles"
}
}
}
インベントリ属性
{
"response": {
"status": "OK",
"count": 2,
"start_element": 0,
"num_elements": 100,
"bidder_profiles": [
{
"id": 00,
"bidder_id": 00,
"code": null,
"description": null,
"targeting": {
"inventory_attributes": {
"targets": [{
{
"id": 00,
"name": "Streaming Media",
"deleted": false
}]
}
},
"last_activity": "2018-07-24 19:47:54",
"created_on": "2018-07-24 19:47:49",
"active": true,
"non_audited_url_action": "include"
}
],
"dbg": {
"warnings": [
],
"version": "1.18.701",
"output_term": "bidder_profiles"
}
}
}
不明なユーザーのアクション
{
"response": {
"status": "OK",
"count": 2,
"start_element": 0,
"num_elements": 100,
"bidder_profiles": [
{
"id": 00,
"bidder_id": 00,
"code": null,
"description": null,
"targeting": {
"inventory_attributes": {
"targets": [{
{
"id": 00,
"name": "Streaming Media",
"deleted": false
}],
"action": "include"
}
},
"last_activity": "2018-07-24 19:47:54",
"created_on": "2018-07-24 19:47:49",
"active": true,
"unknown_users_action": "include"
}
],
"dbg": {
"warnings": [
],
"version": "1.18.701",
"output_term": "bidder_profiles"
}
}
}
監査されていない URL アクション
{
"response": {
"status": "OK",
"count": 2,
"start_element": 0,
"num_elements": 100,
"bidder_profiles": [
{
"id": 00,
"bidder_id": 00,
"code": null,
"description": null,
"targeting": {
"inventory_attributes": {
"targets": [{
"id": 00,
"name": "Streaming Media",
"deleted": false
}],
"action": "include"
}
},
"last_activity": "2018-07-24 19:47:54",
"created_on": "2018-07-24 19:47:49",
"active": true,
"non_audited_url_action": "include"
}
],
"dbg": {
"warnings": [
],
"version": "1.18.701",
"output_term": "bidder_profiles"
}
}
}