構成サービス

インベントリが Prebid Server Premium (PSP) に統合され、 クロスパートナー設定 が確認され、 デマンド パートナーが 有効になったら、PSP 構成を介してデマンド パートナーにインベントリをマップする必要があります。 これらのマッピングにより、PSP はデマンド パートナーのパラメーターを含む入札要求を送信できるため、パートナーはインベントリを識別し、購入者に対してより適切に表現できるため、歩留まりを増やし、フロアや広告品質などのパブリッシャーの設定を尊重できます。

• 各構成は、配置、配置グループ、パブリッシャー、地域、在庫タイプ、キーと値などの 1 つ以上のディメンションを使用して、Monetize のパブリッシャー インベントリの一部をターゲットとします。
• 各構成には、パブリッシャーがインベントリに入札する 1 つ以上の需要パートナーが含まれています
• 各デマンド パートナーは、 PSP に表示されるオープンソースの Prebid Server Go アダプターで受け取る必須パラメーターとオプション パラメーターを指定します。 これにより、パートナーは入札要求をプラットフォーム内のオブジェクトと一致させることができます
• パブリッシャーは、各パートナーのプラットフォーム (通常は別のサプライサイド プラットフォーム (SSP) 内のオブジェクトにマップされた値を使用して、デマンド パートナーのパラメーターを入力します

デマンド パートナーの要件

パブリッシャーが PSP 構成で定義されたインベントリに入札するすべての需要パートナーを、同じ構成に追加する必要があります。 最初の構成セットを作成する前に、計画されている各 PSP 需要パートナーで要件を確認して、マッピング戦略を決定します。 入札要求から情報 (広告サイズ、地域、言語など) を動的にプルするパートナーもあれば、個別のパラメーター マッピングや PSP 構成を必要とするパートナーもあります。 デマンド パートナーがプラットフォーム内のオブジェクトに対して非常に細かいマッピングを必要とする場合、それによって他のパートナーのマッピング方法と必要な構成の数が決まります。 デマンド パートナーが (入札要求または静的な事前入札パラメーターのいずれかを通じて) インベントリをより適切に識別できればなるほど、購入者に提供できる情報が増え、パブリッシャーの収益が増加します。

デマンド パートナー パラメーターを以下に示します。

• 以下に詳述するように PSP 構成サービス内、または UI 自体内。
• Prebid サイトで 、完全なコンテキストと詳細を提供します。
• PSP デマンド パートナー スキーマ サービス内。

以下のドキュメントでは、API を使用して構成を作成および管理する方法について説明します。 構成は UI を使用して管理することもできます。

REST API

GET

呼び出し元のメンバーのすべての Prebid 構成を返します。 結果は JSON として返されます。

パラメーター

状態フィルター引数で curl を使用した呼び出しの例

curl --header "Content-Type: application/json" https://api.appnexus.com/prebid/config?status_filter=enabled

curl を使用して特定の構成を返す呼び出しの例

URL の最後のコンポーネントとして構成 ID を追加します。

curl --header "Content-Type: application/json"https://api.appnexus.com/prebid/config/{prebidSettingsId}

応答

正常な応答は、メンバーのパートナー間設定とすべての PSP 構成を含む JSON を返します。 クエリ文字列に特定の prebidSettingsId を含めると、その構成のみを含む応答になります。

パートナーの設定を要求します

構成プロパティ

ターゲティング メタデータ プロパティ

パートナー構成プロパティを要求する

価格の細分性

価格の粒度は、デマンド パートナーの入札が広告サーバーでグループ化される CPM 価格バケットを定義します。 これは、 Cross-Partner Settings Service で定義されます。

プロファイル

profile オブジェクトには、入札要求を PSP 構成に照合するために使用されるインベントリ ターゲティング属性が含まれます。

プロフィールは次のとおりです。

• PSP UI を使用すると自動的に生成される、または
• psp-campaign-objects API を介してユーザー入力から作成されます。

プロファイルを更新するには、 psp-campaign-objects API を使用します。 構成サービスは、GET応答でのみ psp_profile オブジェクトを返します。

改ページ

num_elements 引数を渡すことで、応答の数を制限できます。 表示を開始する要素は、 start_element 引数を使用して設定できます。

結果を 15 個に制限し、10 番目の要素から結果を開始する呼び出しの例

返される要素は、10 番目から 25 番目までのインデックスが付けられます。

GET https://api.appnexus.com/prebid/config?num_element=15&start_element=10

応答の例

{
  "id": 450,
  "member_id": 13859,
  "bidder_timeout_ms": 500,
  "price_granularity": {
    "label": "Auto",
    "currency_code": "USD",
    "precision": 2,
    "ranges": [
      {
        "max": 5,
        "increment": 0.05
      },
      {
        "max": 10,
        "increment": 0.1
      },
      {
        "max": 20,
        "increment": 0.5
      }
    ]
  },
  "deleted": 0,
  "last_modified_by": "user123",
  "last_modified": "2024-08-21T16:37:24.000Z",
  "demand_partner_settings": {
    "appnexus": {
      "id": 2045,
      "bid_cpm_adjustment": 0.7,
      "enabled": 1
    },
    "openx": {
      "id": 2065,
      "bid_cpm_adjustment": 1,
      "enabled": 0
    },
    "ix": {
      "id": 2106,
      "bid_cpm_adjustment": 0.9,
      "enabled": 1
    },
    "adform": {
      "id": 2110,
      "bid_cpm_adjustment": 1,
      "enabled": 1
    }
  },
  "total_configs": 2,
  "configs": [
    {
      "id": 87053,
      "member_id": 13859,
      "name": "ConfigName1",
      "targeting_level_code": 4,
      "targeting_id": 25172737,
      "enabled": 1,
      "targeting_metadata": {
        "priority": 10
      },
      "deleted": 0,
      "last_modified_by": "user123",
      "last_modified": "2024-07-17T18:17:56.000Z",
      "demand_partner_config_params": [
        {
          "id": 619584,
          "member_id": 13859,
          "prebid_settings_id": 87053,
          "name": "ix",
          "params": {
            "size": null,
            "siteId": "yyy.com"
          },
          "enabled": 1,
          "deleted": 0,
          "last_modified_by": "user123",
          "last_modified": "2024-07-17T18:36:40.000Z"
        }
      ],
      "psp_profile": {
        "id": 147870841,
        "description": "",
        "country_action": "include",
        "supply_type_action": "include",
        "advertiser_id": 11125655,
        "created_on": "2025-10-23 18:02:50",
        "country_targets": [
          {
            "id": 59,
            "name": "Germany",
            "code": "DE",
            "active": true
          },
          {
            "id": 233,
            "name": "United States",
            "code": "US",
            "active": true
          }
        ],
        "supply_type_targets": [
          "mobile_app",
          "mobile_web",
          "web"
        ],
        "ad_type_targets": [
          {
            "id": 2,
            "name": "video"
          }
        ],
        "placement_targets": [
          {
            "id": 36707024,
            "action": "include",
            "name": "Placement Name 1",
            "deleted": 0,
            "site_id": 7908985,
            "site_name": "Placement Group 1",
            "publisher_id": 2545613,
            "publisher_name": "Publisher 1"
          }
        ]
      }
    },
    {
      "id": 87784,
      "member_id": 13859,
      "name": "ConfigName2",
      "targeting_level_code": 4,
      "targeting_id": 25175861,
      "enabled": 1,
      "targeting_metadata": {
        "priority": 10
      },
      "deleted": 0,
      "last_modified_by": "user123",
      "last_modified": "2024-07-31T21:34:34.000Z",
      "demand_partner_config_params": [
        {
          "id": 619080,
          "member_id": 13859,
          "prebid_settings_id": 87784,
          "name": "openx",
          "params": {
            "unit": "3456",
            "platform": null,
            "delDomain": "abc.com",
            "customFloor": null,
            "customParams": null
          },
          "enabled": 0,
          "deleted": 0,
          "last_modified_by": "user123",
          "last_modified": "2024-08-21T21:10:28.000Z"
        },
        {
          "id": 619081,
          "member_id": 13859,
          "prebid_settings_id": 87784,
          "name": "ix",
          "params": {
            "size": null,
            "siteId": "abc.com"
          },
          "enabled": 1,
          "deleted": 0,
          "last_modified_by": "user123",
          "last_modified": "2024-07-17T18:36:06.000Z"
        },
        {
          "id": 625915,
          "member_id": 13859,
          "prebid_settings_id": 87784,
          "name": "adform",
          "params": {
            "inv": null,
            "mid": "1414158",
            "mname": null,
            "priceType": null
          },
          "enabled": 1,
          "deleted": 0,
          "last_modified_by": "user123",
          "last_modified": "2024-07-17T18:36:09.000Z"
        }
      ],
      "psp_profile": {
        "id": 147870841,
        "description": "",
        "country_action": "include",
        "supply_type_action": "include",
        "advertiser_id": 11125655,
        "created_on": "2025-10-23 18:02:50",
        "country_targets": [
          {
            "id": 59,
            "name": "Germany",
            "code": "DE",
            "active": true
          },
          {
            "id": 233,
            "name": "United States",
            "code": "US",
            "active": true
          }
        ],
        "supply_type_targets": [
          "mobile_app",
          "mobile_web",
          "web"
        ],
        "ad_type_targets": [
          {
            "id": 2,
            "name": "video"
          }
        ],
        "placement_targets": [
          {
            "id": 36707024,
            "action": "include",
            "name": "Placement Name 2",
            "deleted": 0,
            "site_id": 7908985,
            "site_name": "Placement Group 2",
            "publisher_id": 2545613,
            "publisher_name": "Publisher 2"
          }
        ]
      }
    }
  ]
}
       

POST

新しい構成オブジェクトの作成を有効にします。 このサービスへの要求には、 demand_partner_config_params.enabled フィールドを含めてはなりません。 この値は、 デマンド パートナー サービスのパートナーの状態から継承されます。

curl を使用した呼び出しの例

curl -d @config.json -X POST --header "Content-Type: application/json" 'https://api.appnexus.com/prebid/config'

POST: パラメーター

POST: パートナー構成プロパティの要求

POST: ターゲティングのメタデータ プロパティ

JSON 要求の例

{
    "name": "ConfigName1",
    "targeting_id": 22378872,
    "enabled": 0,
    "targeting_metadata": {
        "priority": 20
    },
    "demand_partner_config_params": [
        {
            "id": 1718542,
            "member_id": 13859,
            "name": "appnexus",
            "params": {
                "placement_id": 123456
            }
        }
    ]
}
            

応答

正常な応答は、新しい構成オブジェクトを返します。

POST: JSON 応答の例

{
    "id": 196038,
    "member_id": 13859,
    "name": "ConfigName1",
    "targeting_level_code": 4,
    "targeting_id": 22378872,
    "enabled": 1,
    "targeting_metadata": {
        "priority": 20
    },
    "deleted": 0,
    "last_modified_by": "user123",
    "last_modified": "2024-08-22T21:24:40.000Z",
    "demand_partner_config_params": [
        {
            "id": 1718542,
            "member_id": 13859,
            "prebid_settings_id": 196038,
            "name": "appnexus",
            "params": {
                "placement_id": 123456
            },
            "enabled": 1,
            "deleted": 0,
            "last_modified_by": "user123",
            "last_modified": "2024-08-22T21:24:40.000Z"
        }
    ]
}
                

PUT

既存の Prebid 構成を上書きします。 URL パスの最後のコンポーネントとして prebidSettingsId を含めます。 要求の本文で更新情報を JSON として渡します。

このサービスへの要求には、 demand_partner_config_params.enabled フィールドを含めてはなりません。 この値は、 デマンド パートナー サービスのパートナーの状態から継承されます。

PUT: curl を使用した呼び出しの例

curl -d @config-update.json -X PUT --header "Content-Type: application/json https://api.appnexus.com/prebid/config/{prebidSettingsId}

PUT: JSON 要求の例

{
    "name": "ConfigName1",
    "targeting_id": 22378872,
    "enabled": 0,
    "targeting_metadata": {
        "priority": 20
    },
    "demand_partner_config_params": [
        {
            "id": 1718542,
            "member_id": 13859,
            "prebid_settings_id": 196038,
            "name": "appnexus",
            "params": {
                "placement_id": 123456
            }
        }
    ]
}

PUT: 応答

Prebid 構成オブジェクトを返します。

PATCH

既存の Prebid 構成を部分的に更新します。 パスの最後のコンポーネントとして prebidSettingsId を含めます。 要求の本文で更新情報を JSON として渡します。 要求には、更新する他の要素を含む最上位の config オブジェクトを含める必要があります。

このサービスへの要求には、 demand_partner_config_params.enabled フィールドを含めてはなりません。 この値は、 デマンド パートナー サービスのパートナーの状態から継承されます。

PATCH: curl を使用した呼び出しの例

curl -d @config-update.json -X PATCH --header "Content-Type: application/json https://api.appnexus.com/prebid/config/{prebidSettingsId}

PATCH: JSON 要求の例

{
    "config": {
        "enabled": 0
    }
}

PATCH: 応答

Prebid 構成オブジェクトを返します。

DELETE

既存の Prebid 構成を削除します。 パスの最後のコンポーネントとして prebidSettingsId を含めます。

DELETE: curl を使用した呼び出しの例

curl -X DELETE https://api.appnexus.com/prebid/config/{prebidSettingsId}

DELETE: 応答

成功すると、示された構成は、deleted プロパティが 1 に設定された JSON オブジェクトとして返されます。 システム内では使用できなくなります。 すべてのサブオブジェクトも削除されます。

関連トピック

• PSP Campaign Objects Service
• 需要パートナー スキーマ サービス
• デマンド パートナー サービス
• Prebid Demand Partner Params Service
• 広告サイズ サービス
• メディア タイプ サービス
• パートナー間設定サービス
• 新しい PSP 構成を作成する
• Prebid Server Premium Demand パートナー統合
• よくある問題とベスト プラクティス