次の方法で共有


クロスパートナー設定サービス

パートナー間設定サービスを使用すると、Prebid Server Premium (PSP) のメンバーのメンバー全体の設定を取得および編集できます。 グローバル入札者のタイムアウト、入札の価格粒度の詳細、通貨設定が含まれます。 クロス パートナー設定は、 UI のグローバル設定です。

REST API

HTTP メソッド エンドポイント 説明
GET https://api.appnexus.com/prebid/cross-partner-settings 呼び出し元のメンバーのすべてのクロスパートナー設定を取得します。
POST https://api.appnexus.com/prebid/cross-partner-settings 新しいクロスパートナー設定を作成します。 要求の本文にクロスパートナー設定を JSON として渡します。
PUT https://api.appnexus.com/prebid/cross-partner-settings 既存のクロスパートナー設定を更新します。 更新されたクロスパートナー設定を JSON として要求の本文に渡します。
PATCH https://api.appnexus.com/prebid/cross-partner-settings 既存のクロスパートナー設定の一部を更新します。 更新されたクロスパートナー設定を JSON として要求の本文に渡します。

GET

メンバーのすべてのグローバル PSP 設定を取得します。

応答

応答が成功すると、メンバー全体の設定を含む JSON が返されます。

プロパティ 説明
bidder_timeout_ms integer Prebid Server Premium パートナーとマーケットプレースの他の入札者が応答するために与えられる最大時間 (ミリ秒単位)。
deleted ブール値 パートナー間の設定が削除されたかどうかを示します。
id integer クロスパートナー設定オブジェクトの一意識別子。
last_modified string パートナー間設定オブジェクトの最終変更日。
last_modified_by string クロスパートナー設定オブジェクトを最後に変更したユーザー。
member_id integer クロスパートナー設定オブジェクトが属するメンバーの一意識別子。
price_granularity object 需要パートナーの入札を広告サーバーにグループ化する CPM 価格バケットを定義します。 以下の 価格粒度の表を 参照してください。

注:

優先度が最も高いものから最も低い順に完全なタイムアウト階層は次のとおりです。

  1. [デバッグ オークション タイムアウト値 (2000 ミリ秒)] [debug=1/true の場合]
  2. Ad Request auction_timeout_ms パブリッシャーによって設定された値です。
    1. AMP については、こちらのガイダンスを参照 してください
    2. Android の場合は、 こちらのガイダンスを参照してください。
    3. iOS については、こちらのガイダンスを参照 してください
  3. 配置レベルの auction_timeout_ms 値。 この値を設定するには、Microsoft 担当者にお問い合わせください。
  4. パブリッシャーによって設定された PSP グローバル設定 (クロス パートナー) タイムアウト値。 ガイダンスについては、こちらを参照してください
  5. 指定されたデータ センターのメンバー レベルの default_auction_timeout_ms 値。 この値を設定するには、Microsoft 担当者にお問い合わせください。
  6. メンバー レベルの default_auction_timeout_ms 値。 この値を設定するには、Microsoft 担当者にお問い合わせください。
  7. Microsoft データ センター/グローバル既定値 (150 ミリ秒)。

価格の細分性

価格粒度は、需要パートナーの入札を広告サーバーにグループ化する CPM 価格バケットを定義します。 詳細については、 Prebid のドキュメントを参照してください

プロパティ 説明
label string Prebid ドキュメントで定義されているスケールの種類 (低、中、高、自動、高密度、カスタム)。
ranges 配列 価格粒度範囲を記述するコンテナー オブジェクト。
ranges.max integer 範囲の最大長。
ranges.increment 浮動小数点数 範囲をインクリメントする量。
precision integer 価格を丸める小数点以下の桁数。 既定値は 2 なので、2.1234 の価格は小数点以下 2.12 桁に丸められます。
currency_code string 価格バケットの計算に必要な通貨コードを含む文字列。 Microsoft が承認した通貨の一覧の一部である必要があります。

応答の例

{
   "id":5,
   "member_id":13859,
   "bidder_timeout_ms":250,
   "price_granularity":{
      "label":"Dense",
      "ranges":[
         {
            "max":3,
            "increment":0.01
         },
         {
            "max":8,
            "increment":0.05
         },
         {
            "max":20,
            "increment":0.5
         }
      ],
      "currency_code":"USD",
      "precision":2
   },
   "last_modified":"2019-10-31T17:37:50Z",
   "last_modified_by":"user123",
   "deleted":false
}            
            

POST

新しいクロスパートナー設定を作成します。

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

curl https://api.appnexus.com/prebid/cross-partner-settings

POST JSON の例

{
   "id":123,
   "member_id":13859,
   "bidder_timeout_ms":995,
   "price_granularity":{
      "label":"Dense",
      "ranges":[
         {
            "max":3,
            "increment":0.01
         },
         {
            "max":8,
            "increment":0.05
         },
         {
            "max":20,
            "increment":0.5
         }
      ],
      "precision":2,
      "currency_code":"USD"
   }
}

POST:パラメーター

プロパティ 範囲 説明
bidder_timeout_ms integer 必須 Prebid Server Premium パートナーとマーケットプレースの他の入札者が応答するために与えられる最大時間 (ミリ秒単位)。
price_granularity object 必須 価格の細分性の設定。 このオブジェクトの詳細については、以下の 価格粒度の表を 参照してください。

POST: 価格の細分性

価格粒度は、需要パートナーの入札を広告サーバーにグループ化する CPM 価格バケットを定義します。 詳細については、 Prebid のドキュメントを参照してください

プロパティ 範囲 説明
label 配列 必須 Prebid ドキュメントで定義されているスケールの種類 (低、中、高、自動、高密度、カスタム)。
ranges 配列 必須 価格粒度範囲を記述するコンテナー オブジェクト。
ranges.max integer 必須 範囲の最大長。
ranges.increment 浮動小数点数 必須 範囲をインクリメントする量。
precision integer 必須 価格を丸める小数点以下の桁数。 既定値は 2 なので、2.1234 の価格は小数点以下 2.12 桁に丸められます。
currency_code string 必須 価格バケットの計算に必要な通貨コードを含む文字列。 Microsoft が承認した通貨の一覧の一部である必要があります。

PUT

既存のクロスパートナー設定を上書きします。 要求の本文に JSON として情報を渡します。

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

curl https://api.appnexus.com/prebid/cross-partner-settings

JSON の例

{
  "id": 450,
  "bidder_timeout_ms": 400,
  "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
      }
    ]
  }
}

応答

更新された Prebid demand パートナー オブジェクトを返します。

PATCH

既存のクロスパートナー設定をUpdatesします。 要求の本文に JSON として情報を渡します。

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

curl https://api.appnexus.com/prebid/cross-partner-settings

JSON の例

{
  "bidder_timeout_ms": 500
}

応答

更新された Prebid demand パートナー オブジェクトを返します。