入札者サービス

入札者サービスは、入札者を Xandr のインプレッション バスに接続し、入札者とインプレッション バスが通信を開始できるようにします。 Xandr 担当者がシステムで入札者を作成し、お客様は入札者サービスを使用して変更を行ったり、入札者 ID を取得したりします。

一部のサービスでは、入札者 ID が必要になる場合があります。 ご使用の入札者 ID を確認するには、以下で説明する [すべての入札者を表示] コマンドを実行します。

一部の入札者機能は、契約上の義務に基づいているため、特定のユーザーしかアクセスできません。

データ プロバイダーのフィールドの変更 ( PUT 経由) - 各プロバイダーとのデータ アクセス契約が必要です

入札者サンドボックス環境では、すべての機能が統合の目的で使用できます。

REST API

JSON フィールド

入札者が受け取るトラフィックをフィルタリングするには、 従来の入札者プロファイル サービスを使用します。 いくつかのフィルタリングおよび調整フィールドは入札者サービスにまだ存在しますが、間もなく入札者プロファイル サービスに移行されます。 クラスフィルターは両方で使用できます。これらには、Bidder Profile Service の使用をお勧めします。

非推奨のフィールド

例

認証トークン

API サービスを使用する場合、認証は常に最初のステップです。 認証トークンは、将来使用するために cookie ファイルに書き込むことができます。 詳細な手順については、「 認証サービス」を参照してください。

入札者情報を表示する

Xandr によってすでに入札者が追加されている場合は、JSON 形式の入札者 ID などの入札者情報が既に用意されていることになります。 この情報は、次のコマンドで表示できます。

S curl -b cookies -c cookies "https://api.adnxs.com/bidder"
{
   "response":{
      "status":"OK",
      "bidder":{
         "id":4,
         "name":"Test Bidder",
         "short_name":"TestBidder",
         "active":true,
         "parent_profile_id": 12345,
         "child_profiles":[{"id":1000},{"id":2000},{"id":3000}],
         "bid_uri":"/bid",
         "notify_uri":"/notify",
         "click_uri":null,
         "ready_uri":null,
         "pixel_uri":"/pixel",
         "audit_notify_uri":null,
         "last_activity":"2009-01-07 22:07:08"
      }
   }
}

入札者を変更する

入札者 ID がわかったので、JSON 形式のテキスト ファイルを使用して入札者を変更できます。 準備完了 URI パラメーターを変更する JSON の例を次に示します。

$ cat bidder
{
      "bidder":{
         "id":4,
         "ready_uri":"/ready"
      }
   }

次に、 PUT コマンドを使用して、インプレッション バス キャッシュ内のこのデータを更新します。

$ curl -b cookies -c cookies -X PUT --data-binary @bidder 'https://api.adnxs.com/bidder/4'
{
   "response":{
      "status":"OK",
      "id":4
   }
}

これで、Bidder 4 を表示すると、次の機能を利用できます。

$ curl -b cookies -c cookies 'https://api.adnxs.com/bidder/4'
{
   "response":{
      "status":"OK",
      "bidder":{
         "id":4,
         "name":"Test Bidder",
         "short_name":"TestBidder",
         "active":true,
         "parent_profile_id": 12345,
         "child_profiles":[{"id":1000},{"id":2000},{"id":3000}],      
         "bid_uri":"/bid",
         "notify_uri":"/notify",
         "click_uri":null,
         "ready_uri":"/ready",
         "ready_string":"Ready:1"
         "pixel_uri":"/pixel",
         "audit_notify_uri":null,
         "last_activity":"2009-01-07 22:07:08"
      }
      }
}

関連トピック

• 従来の入札者プロファイル サービス
• 入札者プロフィール - FAQ
• Bidder インスタンス サービス
• 入札者を統合する