英語で読む

次の方法で共有


シートサービス

重要

この機能は現在、クローズド ベータ版です。 参加に興味がある場合は、Xandr の担当者にお問い合わせください。

購入者シート ID 製品を使用すると、外部入札者は Xandr メンバー ID を使用するのではなく、カスタム購入者 ID で入札できます。 これにより、外部の入札者は、Xandr インベントリに入札するときに、独自のシステムから購入者 ID を利用でき、よりシームレスなレポートと取引の設定が可能になります。

シート サービスは、入札者の新しいシートを登録するために使用されるまったく新しい API サービスです。 これは、API への呼び出し後に手動で行うか、入札者が入札応答で新しいシート ID で入札したときにリアルタイムで行うことができます。

概要

シートサービスは、入札者の座席 ID を格納するために使用されます。 これらのシート ID は、入札応答で使用され、トランザクション レポートに記録されます。

Rest API

HTTP メソッド エンドポイント 説明
GET https://api.adnxs.com/seat/BIDDER_ID 入札者にアタッチされているすべてのシートを表示するには
GET https://api.adnxs.com/seat/BIDDER_ID/SEAT_ID API シート識別子を使用して既存のシートを表示するには
取得 https://api.adnxs.com/seat?bidder_id=BIDDER_ID&code=SEATCODE API bidder シート ID を使用して既存のシートを表示するには
POST https://api.adnxs.com/seat/BIDDER_ID 新しいシートを追加する
PUT https://api.adnxs.com/seat/BIDDER_ID/SEAT_ID API シート識別子を使用して既存のシートを変更する
PUT https://api.adnxs.com/seat?bidder_id=BIDDER_ID&co6de=SEATCODE bidder シート ID を使用して既存のシートを変更する

JSON フィールド

フィールド 種類 説明
bidder_id int 入札者の ID。 これは読み取り専用フィールドです。
code string Bidder シート ID。
id int シートの ID。 これは読み取り専用フィールドです。
name string このシートの購入者の名前。

: 自動登録シートでは、標準の名前付け規則が seat_codeされます (入札者名)

次の API 呼び出しの例は、新しいシートをアップロードしたり、既存のシートを編集したりする方法を示しています。

新しいシートのアップロード

$ cat seats.json
 
{
 
    "seats": [{
            "bidder_id": 1,
            "code": "sdfg54VVsh",
            "name": "sdfg54VVsh(Bidder)"
        },
        {
            "bidder_id": 129,
            "code": "54Gfa762Gbse",
            "name": "54Gfa762Gbse(Bidder)"
        }
    ]
}
 
$ curl -b cookies -c cookies -X POST -d @seats.json "https://api.adnxs.com/seat/1"
 {
    "response": {
        "status": "OK",
        "num_elements": 100,
        "seats": [
            {
                "bidder_id": 1,
                "code": "sdfg54VVsh",
                "created_on": "2018-12-13 15:31:13",
                "id": 11,
                "last_activity": "2018-12-13 15:31:13",
                "name": "sdfg54VVsh(Bidder)"
            },
            {
                "bidder_id": 1,
                "code": "54Gfa762Gbse",
                "created_on": "2018-12-13 17:09:26",
                "id": 22,
                "last_activity": "2018-12-13 17:09:26",
                "name": "54Gfa762Gbse(Bidder)"
            }
        ]
    }
}

既存のシートの更新 - シート名の変更

$ cat seats.json
 
{
 
    "seats": [{
            "bidder_id": 1,
            "code": "sdfg54VVsh",
            "name": "Bidder seat name"
        }
    ]
}
 
$ curl -b cookies -c cookies -X PUT -d @seats.json "https://api.adnxs.com/seat/1/11"
 {
    "response": {
        "status": "OK",
        "num_elements": 100,
        "seats": [
            {
                "bidder_id": 1,
                "code": "sdfg54VVsh",
                "created_on": "2018-12-13 15:31:13",
                "id": 11,
                "last_activity": "2018-12-13 15:31:13",
                "name": "Bidder seat name"
            }
        ]
    }
}

既存のシートを表示する

$ curl -b cookies -c cookies -X GET "https://api.adnxs.com/seat/1/22"
 {
    "response": {
        "status": "OK",
        "num_elements": 100,
        "seats": [
            {
                "bidder_id": 1,
                "code": "54Gfa762Gbse",
                "created_on": "2018-12-13 17:09:26",
                "id": 22,
                "last_activity": "2018-12-13 17:09:26",
                "name": "54Gfa762Gbse(Bidder)"
            }
        ]
    }
}

特定の入札者のすべてのシートを表示する

$ curl -b cookies -c cookies -X GET "https://api.adnxs.com/seat/1"
 {
    "response": {
        "status": "OK",
        "num_elements": 100,
        "seats": [
            {
                "bidder_id": 1,
                "code": "sdfg54VVsh",
                "created_on": "2018-12-13 15:31:13",
                "id": 11,
                "last_activity": "2018-12-13 15:31:13",
                "name": "sdfg54VVsh(Bidder)"
            },
            {
                "bidder_id": 1,
                "code": "54Gfa762Gbse",
                "created_on": "2018-12-13 17:09:26",
                "id": 22,
                "last_activity": "2018-12-13 17:09:26",
                "name": "54Gfa762Gbse(Bidder)"
            }
        ]
    }
}