次の方法で共有


Yield Management Floor サービス

Yield Management Floor Service は、既存の Yield Management プロファイル内でフロアを作成および更新するために使用されます。

フロアは、ネットワークまたはパブリッシャーがクリエイティブに対して受け取りたい最小価格と考えることができます。 ただし、微妙な情報があります。

警告

フロア設定は 、配置サービスを介して設定された予約価格よりも優先されます。

例: ソフト フロアの設定はありますが、ハード フロアはなく、 配置 レベルで予約価格を設定しています。 ただし、 Yield Management ツールを使用しているため、予約価格設定は無視されます。 ハードフロア経由でここで設定する必要があります。

REST API

HTTP メソッド エンドポイント 説明
GET https://api.appnexus.com/ym-floor?member_id=MEMBER_ID 特定のメンバーに関連付けられているすべてのフロアを表示します。
GET - https://api.appnexus.com/ym-floor?ym_profile_id=YM_PROFILE_ID
- https://api.appnexus.com/ym-floor?ym_profile_code=YM_PROFILE_CODE
特定 の Yield Management プロファイルに関連付けられているすべてのフロアを表示します。
GET - https://api.appnexus.com/ym-floor?id=YM_FLOOR_ID
- https://api.appnexus.com/ym-floor?code=YM_FLOOR_CODE
特定のフロアを表示します。
GET https://api.appnexus.com/ym-floor?id=1,2,3 コンマ区切りリストを使用して、ID で複数の歩留まり管理フロアを表示します。
POST - https://api.appnexus.com/ym-floor?ym_profile_id=YM_PROFILE_ID
- https://api.appnexus.com/ym-floor?ym_profile_code=YM_PROFILE_CODE
(ym-floor JSON)
新しいフロアを追加します。
PUT - https://api.appnexus.com/ym-floor?member_id=MEMBER_ID
- https://api.appnexus.com/ym-floor?code=YM_FLOOR_CODE
(ym-floor JSON)
既存のフロアを変更します。
DELETE - https://api.appnexus.com/ym-floor?id=YM_FLOOR_ID
- https://api.appnexus.com/ym-floor?code=YM_FLOOR_CODE
既存のフロアを削除します。

手記: 1 つ以上の Yield Management プロファイルの基準フロアとして使用されているフロアを削除することはできません。

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_enabledtrueされている場合、この値は無視されます。
デフォルト:NULL
default_calculation_type 列挙 フロアを gross に適用するか、 net 入札するかを指定します。
使用可能な値: gross または netnetdefault_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
    }
}