配置セット サービス

プレースメント セット サービスは、広告ポッドの作成と管理、1 つのビデオ配置に収まるように設計された広告の線形グループ化をサポートします。

REST API

HTTP メソッド	エンドポイント	説明
GET	https://api.appnexus.com/placement-set?publisher_id=PUBLISHER_ID	いずれかのパブリッシャーの配置セットをすべて表示します。
GET	https://api.appnexus.com/placement-set?id=PLACEMENT_ID	いずれかの発行元の特定の配置セットを表示します。
POST	https://api.appnexus.com/placement-set?publisher_id=PUBLISHER_ID&member_id=MEMBER_ID	配置セット (NETWORK) を追加します。 注: プレースメント グループに関連付けられているすべての広告ポッドの配置は、プレースメント グループのパブリッシャーに属している必要があります。
PUT	https://api.appnexus.com/placement-set?id=PLACEMENT_ID&publisher_id=PUBLISHER_ID&member_id=MEMBER_ID	既存の配置セット (NETWORK) を変更します。

JSON フィールド

フィールド	種類	説明
code	string	配置セットに関連付けられているコード。 既定値: null
id	int	配置セットの ID。 必須:PUT
last_modified	timestamp	配置セットに対してアクティビティが最後に実行されたタイム スタンプ。 既定値: null
member_id	int	パブリッシャーに関連付けられているメンバーの ID。 必須:POST
name	string	配置セットの名前。 ユーザーはこれを使用して、配置セットを識別します。 既定値: null
placement_ids	ints の配列	配置セットに関連付けられている配置。 既定値: null
publisher_id	int	配置セットに関連付けられている発行元の ID。 必須:POST

例

新しい配置セットを作成する

$ cat ps_create

{
    "placement_set":{
        "code":"appnexus_example2",
        "name":"placement set test",
        "member_id":958,
        "publisher_id":123456,
        "placement_ids":[01234567, 12345678]
    }
}
$ curl -b cookies -c cookies -X POST -d @ps_create 'https://api.appnexus.com/placement-set?member_id=958&publisher_id=123456' 

既存の配置セットを更新する

$ cat ps_change
{
    "placement_set":{
        "id":2,
        "name":"new placement set name",
        "placement_ids":[01234567, 12345678]
    }
}

$ curl -b cookies -c cookies -X PUT -d @ps_change 'https://api.appnexus.com/placement-set?id=2&member_id=958&publisher_id=123456'
{
    "response": {
        "status": "OK",
        "start_element": 0,
        "num_elements": 100,
        "placement_set": {
            "id": 2,
            "name": "new placement set name",
            "code": "appnexus_example2",
            "member_id": 958,
            "publisher_id": 123456,
            "last_activity": "2017-05-01 03:06:51",
            "placement_ids": [
                "01234567",
                "12345678"
            ]
        },
        "count": 1
        }
    }
}

既存の配置セットを表示する

$ curl -b cookies -c cookies 'https://api.appnexus.com/placement-set?publisher_id=123456'
{
    "response": {
        "status": "OK",
        "start_element": 0,
        "num_elements": 100,
        "placement_sets": [
            {
                "id": 1,
                "name": "my first test",
                "code": "appnexus_example",
                "member_id": 958,
                "publisher_id": 123456,
                "last_activity": "2017-05-01 02:52:09",
                "placement_ids": null
            },
            {
                "id": 2,
                "name": "placement set test",
                "code": "appnexus_example2",
                "member_id": 958,
                "publisher_id": 123456,
                "last_activity": "2017-05-01 02:55:11",
                "placement_ids": [
                    "01234567",
                    "12345678"
                ]
            }
        ],
        "count": 2
        ...
        }
    }
}