Yield Management Floor サービス
Yield Management Floor Service は、既存の Yield Management プロファイル内でフロアを作成および更新するために使用されます。
フロアは、ネットワークまたはパブリッシャーがクリエイティブに対して受け取りたい最小価格と考えることができます。 ただし、微妙な情報があります。
警告
フロア設定は 、配置サービスを介して設定された予約価格よりも優先されます。
例: ソフト フロアの設定はありますが、ハード フロアはなく、 配置 レベルで予約価格を設定しています。 ただし、 Yield Management ツールを使用しているため、予約価格設定は無視されます。 ハードフロア経由でここで設定する必要があります。
REST API
JSON フィールド
フィールド | 種類 | 説明 |
---|---|---|
member_id |
int | フロアが関連付けられているメンバーの一意識別子。 デフォルト: NULL クエリ文字列で必要な On: PUT 。 |
id |
int | 利回り管理フロアの一意識別子。 デフォルト: 自動インクリメントされた数値 (つまり 123)。 必須: PUT |
name |
string | 利回り管理フロアの説明に使用される名前。 デフォルト: None 必須: POST |
code |
string | 歩留まり管理フロアを参照するために使用される省略可能なカスタム コード。 デフォルト: NULL |
description |
string | 利回り管理フロアの使用方法の説明 (省略可能)。 デフォルト: NULL |
hard_floor |
double | 適用されるハード予約価格として使用される CPM フロア。 デフォルト: None 必須: POST |
soft_floor |
double | ソフト リザーブとして使用される CPM フロア。価格引き下げが発生する最低価格として定義されます。 これは、ハード フロア (設定されている場合) 以上である必要があります。
floor_optimization_enabled がtrue されている場合、この値は無視されます。デフォルト: NULL |
default_calculation_type |
列挙 | フロアを gross に適用するか、 net 入札するかを指定します。 使用可能な値: gross または net 。
net のdefault_calculation_type は、パブリッシャーに支払われたメディア コストに適用されるフロアです。デフォルト: gross |
profile_id |
int | 省略可能な profile_id は、フロアを適用するタイミングを決定するために使用されます。 プロファイルは、インベントリを対象とする一般的なルールのセットであり、特定のフロアは特定のインベントリのスライスにのみ適用できます。 詳細については、 プロファイル サービスに関するページを参照してください。デフォルト: NULL |
priority |
int | 優先順位フィールド (省略可能) は、フロアを適用する方法の階層を作成するために使用されます。 値は 1 -10 の間で指定できます。ここで、優先度 10 は最も高い優先度の値として扱われます。デフォルト: 5 |
ym_profile_id |
int | 利回り管理フロアが関連付けられている利回り管理プロファイルの ID。 詳細については、 Yield Management Profile Service を参照してください。 手記: この ID は、設定後は変更できません。 デフォルト: NULL 必須: POST |
floor_application_target |
列挙 | 価格フロアが適用される入札の種類。 使用可能な値: - external_only :価格フロアは外部の入札にのみ適用されます(購入メンバーと販売メンバーは異なります)。 このオプションは、学習の 1 日あたりの最大量 (Publisher Service の [max_learn_pct ] フィールド) を超える場合でも、既定値を提供するよりも、使用可能なマネージド学習インプレッションを提供する場合に使用します。- external_non_preferred : 価格フロアは外部の入札に適用されます (購入メンバーと販売メンバーは異なります)、またはインプレッションが学習の 1 日のボリュームの最大 % を超える使用可能なマネージド 学習インプレッションである場合。 このオプションは、学習の 1 日のボリュームの最大 % を超える使用可能なマネージド学習インプレッションを提供するよりも、既定値を提供する場合に使用します。- all : 価格フロアは、Learn の 1 日のボリュームの最大 % 以内のマネージド 学習インプレッションを除くすべての入札に適用されます。デフォルト: all |
apply_floor_to_direct |
ブール型 | 削除されます。 代わりに floor_application_target を使用します。 |
allow_tag_reserve_override |
ブール型 |
true 場合は、広告タグクエリ文字列を介して送信された予約価格を許可して、既存のハードフロアをオーバーライドします。 タグが指定された予約価格がフロア価格より大きい場合にのみ、フロアがオーバーライドされます。デフォルト: false |
floor_optimization_enabled |
ブール型 |
true 場合、ソフトフロアは無視され、市場の状況に応じてフロアが上下に移動しますが、ハードフロアの下に入ることは決して許可されません。デフォルト: false |
members |
配列 | 利回り管理フロアを適用するメンバー。 左を NULL に設定すると、フロアはすべてのメンバーに適用されます。 詳細については、以下の 「メンバー 」を参照してください。デフォルト: NULL |
brands |
配列 | 利回り管理フロアを適用する必要があるブランド。 詳細については、以下の 「ブランド 」を参照してください。 デフォルト: NULL |
categories |
配列 | この収益管理フロアを適用する必要があるブランドまたはクリエイティブ カテゴリ。 詳細については、以下の 「カテゴリ 」を参照してください。 デフォルト: NULL |
allowed_media_types |
配列 | この利回り管理フロアを適用する必要があるメディアの種類。 詳細については、以下の 「メディアの種類」を 参照してください。 デフォルト: NULL |
allowed_media_subtypes |
配列 | この歩留管理フロアを適用する必要があるメディア サブタイプ。 詳細については、以下の 「メディア サブタイプ」を 参照してください。 デフォルト: NULL |
メンバー
フィールド | 種類 | 説明 |
---|---|---|
id |
int | フロアを適用する必要がある ( プラットフォーム メンバー サービスで見つかった) 購入者メンバーの ID。 必須: POST /PUT |
name |
string | 購入者メンバーの名前。このフィールドは 読み取り専用です。 |
ブランド
フィールド | 種類 | 説明 |
---|---|---|
id |
int | フロアを適用するクリエイティブのブランドの ID ( ブランド サービスに含まれる)。 必須: POST /PUT |
name |
string | ブランドの名前。 このフィールドは 読み取り専用です。 |
Categories
フィールド | 種類 | 説明 |
---|---|---|
id |
int | このフロアを適用する必要があるブランドまたはクリエイティブ カテゴリ ( カテゴリ サービスに記載されている) の ID。 必須: POST /PUT |
name |
string | ブランドまたはクリエイティブ カテゴリの名前。 このフィールドは 読み取り専用です。 |
メディアの種類
フィールド | 種類 | 説明 |
---|---|---|
id |
int | このフロアを適用する必要があるメディア タイプの ID ( メディア タイプ サービスで説明されています)。 必須: POST /PUT |
name |
string | メディアの種類の名前。 このフィールドは 読み取り専用です。 |
メディア サブタイプ
フィールド | 種類 | 説明 |
---|---|---|
id |
int | このフロアを適用する必要があるメディア サブタイプの ID ( メディア サブタイプ サービスの説明に従います)。 必須: POST /PUT |
name |
string | メディア サブタイプの名前。 このフィールドは 読み取り専用です。 |
例
特定のフロアを表示する
$ curl -b cookies -c cookies "https://api.appnexus.com/ym-floor?id=1234"
{
"ym-floor": {
"member_id": 3,
"id": 1234,
"name": "Germany Floor",
"description": "This rule will used to set the floor for a set of demand attributes across Germany inventory.",
"hard_floor": 1.20,
"soft_floor": null,
"default_calculation_type": "gross",
"apply_floor_to_direct": true,
"floor_application_target": "all",
"profile_id": 1542,
"priority": 6,
"ym_profile_id": 1234,
"members": [{
"id": 100,
"name": "eBay"
}, {
"id": 256,
"name": "MiG"
}],
"brands": [{
"id": 102,
"name": "Netflix"
}, {
"id": 256,
"name": "Blockbuster"
}],
"categories": [{
"id": 2,
"name": "Apparel"
}, {
"id": 8,
"name": "Dating"
}],
"allowed_media_types": [{
"id": 1,
"name": "Banner"
}, {
"id": 4,
"name": "Video"
}],
"allowed_media_subtypes": [{
"id": 1,
"name": "Standard Banner"
}, {
"id": 8,
"name": "30-second VAST"
}]
}
}
利回り管理プロファイルに関連付けられているすべてのフロアを表示する
次のフロアは、{{members}}
配列ではなく、省略可能な{{profile_id}}
をターゲットにしていることに注意してください。 詳細については、上記の JSON フィールドに関する ページを 参照してください。
$ curl -b cookies "https://api.appnexus.com/ym-floor?ym_profile_id=9999"
{
"response": {
"start_element": null,
"count": 2,
"ym-floors": [{
"priority": 5,
"last_modified": "2011-11-03 23:04:24",
"soft_floor": 0.23999999999999999,
"member_id": 123,
"name": "Placement 60 + Size 300x250 Floor",
"floor_application_target": "all",
"default_calculation_type": "gross",
"brands": null,
"ym_profile_id": 9999,
"code": "Tattooed Bikers Galore",
"hard_floor": 0,
"id": 555,
"description": null,
"profile_id": 23,
"members": null,
"categories": null,
"allowed_media_types": null,
"allowed_media_subtypes": null
}, {
"priority": 5,
"last_modified": "2011-11-04 01:18:35",
"soft_floor": 0.050000000000000003,
"member_id": 1,
"name": "Placement+Size 728x90 Floor",
"floor_application_target": "all",
"default_calculation_type": "gross",
"brands": null,
"ym_profile_id": 9999,
"code": "Tattooed Bikers Knit and Sew",
"hard_floor": 0,
"id": 4,
"description": null,
"profile_id": 9,
"members": null,
"categories": null,
"allowed_media_types": null,
"allowed_media_subtypes": null
}],
"status": "OK",
"num_elements": null
}
}