Compartir a través de


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
        ...
        }
    }
}