Servicio de conjunto de selección de ubicación
El servicio conjunto de selección de ubicación admite la creación y administración de pods de anuncios, agrupaciones lineales de anuncios diseñados para caber dentro de una sola ubicación de vídeo.
API de REST
Http (método) | Endpoint | Description |
---|---|---|
GET |
https://api.appnexus.com/placement-set?publisher_id=PUBLISHER_ID |
Vea todos los conjuntos de selección de ubicación de uno de los publicadores. |
GET |
https://api.appnexus.com/placement-set?id=PLACEMENT_ID |
Vea un conjunto de selección de ubicación específico para uno de los publicadores. |
POST |
https://api.appnexus.com/placement-set?publisher_id=PUBLISHER_ID&member_id=MEMBER_ID |
Agregue un conjunto de selección de ubicación (NETWORK). Nota: Todas las ubicaciones de pods de anuncios asociadas a un grupo de selección de ubicación deben pertenecer al publicador del grupo de selección de ubicación. |
PUT |
https://api.appnexus.com/placement-set?id=PLACEMENT_ID&publisher_id=PUBLISHER_ID&member_id=MEMBER_ID |
Modificar un conjunto de selección de ubicación existente (NETWORK). |
Campos JSON
Campo | Tipo | Descripción |
---|---|---|
code |
string | Código asociado al conjunto de selección de ubicación. Valor predeterminado: null |
id |
Entero | Identificador del conjunto de selección de ubicación. Obligatorio activado: PUT |
last_modified |
Timestamp | Marca de tiempo cuando se realizó por última vez la actividad en el conjunto de selección de ubicación. Valor predeterminado: null |
member_id |
Entero | Identificador del miembro asociado al publicador. Obligatorio activado: POST |
name |
string | Nombre del conjunto de selección de ubicación. El usuario lo usaría para identificar su conjunto de selección de ubicación. Valor predeterminado: null |
placement_ids |
matriz de ints | Las ubicaciones asociadas al conjunto de selección de ubicación. Valor predeterminado: null |
publisher_id |
Entero | Identificador del publicador asociado al conjunto de selección de ubicación. Obligatorio activado: POST |
Ejemplos
Create un nuevo conjunto de selección de ubicación
$ 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'
Actualización de un conjunto de selección de ubicación existente
$ 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
}
}
}
Visualización de un conjunto de selección de ubicación existente
$ 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
...
}
}
}