Servicio Pixel de terceros

El servicio de píxeles de terceros le permite cargar y modificar píxeles creativos de terceros, y adjuntarlos a anunciantes o creativos. También puede adjuntar píxeles creativos de terceros a su miembro.

API de REST

Http (método)	Endpoint	Description
GET	https://api.appnexus.com/thirdparty-pixel	Ver todos los píxeles de terceros.
GET	https://api.appnexus.com/thirdparty-pixel?id=THIRDPARTY-PIXEL_ID	Ver un píxel de terceros específico.
POST	https://api.appnexus.com/thirdparty-pixel	Agregue un nuevo píxel de terceros.
PUT	https://api.appnexus.com/thirdparty-pixel?id=THIRDPARTY-PIXEL_ID	Modifique un píxel de terceros existente.
DELETE	https://api.appnexus.com/thirdparty-pixel?id=THIRDPARTY-PIXEL_ID	Elimine un píxel de terceros existente.

Campos JSON

Campo	Tipo	Descripción
active	booleano	Marca que indica si el píxel está activo. Valor predeterminado: true
adservers	matriz de objetos	Los adservers a los que llama el píxel. Necesario para los píxeles que sirven en el inventario de Google Ad Manager. Se puede recuperar una lista completa de adservers del servicio de servidor de anuncios. Ejemplo: "adservers":[{"id":11},{"id":12}]
advertisers	matriz de objetos	Si el píxel tiene un anunciante propietario (es decir, advertiser_id no nulles ), esta matriz debe contener el identificador (y solo el identificador) del anunciante propietario del píxel. Como resultado, este píxel se representará en todas las creatividades propiedad de ese anunciante. Si el píxel no tiene un anunciante propietario, esta matriz puede contener varios anunciantes a los que se aplicará el píxel. Ejemplo: "advertisers":[{"id":3}] Optional
advertiser_id	Entero	Identificador del anunciante propietario del píxel de terceros. Valor predeterminado: null
audit_status	string	Estado de auditoría del píxel. Los posibles valores son: - "pending" - "rejected" - "approved" - "exempt" Nota: Un píxel sin auditar no impedirá que una creatividad sirva, pero no servirá junto con la creatividad hasta que haya superado la auditoría. Solo lectura Valor predeterminado: "pending"
content	string	Si el píxel format es "raw-js", este es el contenido de JavaScript que se va a servir con la creatividad. Los content campos y/o secure_content son necesarios para POST los raw-js píxeles. También puede agregar macros al píxel. Para obtener una lista de las macros creativas que puede anexar al píxel, vea Macros creativas en la documentación de la interfaz de usuario . Obligatorio activado: POST si el píxel format es "raw-js".
creatives	matriz de objetos	Las creatividades a las que se aplica un píxel. Los creativos deben pertenecer al socio/anunciante propietario. Para adjuntar un píxel de terceros a un creativo, use el Servicio creativo. Ejemplo: "creatives":[{"id":860851}] Solo lectura
format	string	Formato del píxel. Valores posibles para las creatividades: - "raw-js" - "url-html" - "url-js" - "url-image" - "raw-url" Obligatorio activado: POST y PUT si cambia contentlos campos , secure_content, urlo url_secure . Valor predeterminado: "raw-js"
id	Entero	Identificador del píxel de terceros. Obligatorio en: PUT y DELETE.
members	matriz de objetos	Opcional. Si se especifica, este campo contendrá el identificador del miembro propietario del píxel y este píxel se representará en todas las creatividades propiedad de ese miembro. Ejemplo: "members":[{"id":1}]
member_id	Entero	Identificador del miembro o red propietario de este píxel. Obligatorio activado: POST
name	string	Nombre del píxel de terceros.
secure_content	string	Si el píxel format es "raw-js", el contenido de JavaScript que se va a servir con la creatividad. Los content campos y/o secure_content son necesarios para POST los raw-js píxeles. También puede agregar macros al píxel. Para obtener una lista de las macros creativas que puede anexar al píxel; Vea Macros creativas en la documentación de la interfaz de usuario. Obligatorio activado: POST si el píxel format es "raw-js".
secure_url	string	Si el píxel format es "url-html", "url-js", "url-image"o "raw-url", la dirección URL del píxel HTML, JavaScript o Image para servir con la creatividad en una llamada segura (https). Los url campos y/o secure_url son necesarios para POST estos tipos de píxeles. También puede agregar macros al píxel. También puede agregar macros al píxel. Para obtener una lista de las macros creativas que puede anexar al píxel, consulte Macros creativas en la documentación de la interfaz de usuario. Obligatorio activado: POST si el píxel format es "url-html", "url-js", "url-image"o "raw-url".
supply_exceptions	matriz de objetos	Los nombres de los miembros en los que debe not servir el píxel. "AdX" es actualmente el único valor aceptable. Ejemplo: "supply_exceptions":[{"name":"AdX"}]
url	string	Si el píxel format es "url-html", "url-js", "url-image"o "raw-url", la dirección URL del píxel HTML, JavaScript o Imagen que se va a servir con la creatividad. Los url campos y/o secure_url son necesarios para POST estos tipos de píxeles. También puede agregar macros al píxel. Para obtener una lista de las macros creativas que puede anexar al píxel, consulte Macros creativas en la documentación de la interfaz de usuario.

Ejemplos

Visualización de un píxel de terceros específico

En este ejemplo, se ve un píxel de terceros con el identificador 123.

$ curl -b cookies -X GET 'https://api.appnexus.com/thirdparty-pixel?id=123'
 
{
    "thirdparty-pixel":{
        "id":123,
        "active":true,
        "member_id":456,
        "advertiser_id": 789,
        "format":"raw-js",
        "content":"var img = new Image(); img.src="https://url.com/event/js?self=" + data;"
        "url":null,
        "secure_url":null,
        "members":null,
        "advertisers":[{"id":789}], 
        "creatives":null
        "audit_status":"unaudited" // admin only
        "supply_exceptions":[
            {"name":"AdX"},
        ]
        "adservers":[
            {"id":123}
        ]
  }
}

Adición de un nuevo píxel de terceros

En este ejemplo, creamos un nuevo píxel de terceros de venta con el identificador 123. Tenga en cuenta que la información del objeto primario se "null" debe a que el archivo JSON que hemos pasado a la API no especificó un objeto primario para el píxel.

$ cat thirdparty-pixel.json
{
  "thirdparty-pixel":
    {
      "format":"url-html",
      "secure_url":"https://secureurl.com"
    }
}  

$ curl -b cookies -c cookies -X POST -d @thirdparty_pixel 'https://api.appnexus.com/thirdparty-pixel'

{
    "response":{
        "status":"OK",
        "count":1,
        "id":123,
        "start_element":0,
        "num_elements":100,
        "thirdparty-pixel":{
            "id":123,
            "active":true,
            "name":null,
            "member_id":456,
            "advertiser_id":789,
            "publisher_id":null,
            "format":"url-html",
            "audit_status":"pending",
            "created_on":"2014-11-05 19:51:44",
            "last_modified":"2014-11-05 19:51:44",
            "url":null,
            "secure_url":"https://secureurl.com",
            "members":null,
            "advertisers":null,
            "publishers":null,
            "creatives":null,
            "supply_exceptions":null,
            "adservers":null
       
    }
}

Actualización de un píxel de terceros

En este ejemplo, actualizamos un píxel de terceros con el identificador 123, aplicándolo a todos los creativos del anunciante propietario.

$ cat pixelupdate.json

{
  "thirdparty-pixel":
    {
      "advertisers":[{"id":789}]
    }
}  

$ curl -b cookies -c cookies -X PUT -d @pixelupdate 'https://api.appnexus.com/thirdparty-pixel?id=123'

{
   "response":{
      "status":"OK",
      "id":123
   }
}

Eliminación de un píxel de terceros

En este ejemplo, eliminamos un píxel de terceros con el identificador 123.

$ curl -b cookies -X DELETE 'https://api.appnexus.com/thirdparty-pixel?id=123'

{
   "response":{
      "status":"OK"
   }
}

Temas relacionados

• Semántica de API
• Procedimientos recomendados de API
• Creative Service
• Servicio de anunciantes