Servicio De seguimiento de impresiones
El servicio De seguimiento de impresiones le ofrece una manera de realizar un seguimiento de las impresiones de las creatividades que atienden los servidores de anuncios de terceros (en lugar de appnexus).
Aquí se muestra cómo funciona:
- Use el servicio De seguimiento de impresiones para crear un rastreador de impresiones. El seguimiento de impresiones especifica el elemento de línea y el publicador al que está asociado. Opcionalmente, puede incluir la ubicación específica o la regla de pago a la que está asociada.
- Cree una imagen o una etiqueta de JavaScript con la dirección URL del rastreador de impresiones y pida al servidor de anuncios que la use como píxel de reserva para la creatividad. La dirección URL del seguimiento de impresiones https://ib.adnxs.com/imptr?id=12345&debe tener el formato ; t=2, donde 12345 es el identificador del rastreador de impresiones y "t" representa el tipo de píxel (donde t=1 es para javascript y t=2 es para la imagen).
- Cuando el servidor de anuncios sirve a la creatividad, el rastreador llama a
ib.adnxs.comy AppNexus registra la impresión.
Parámetros de la cadena de consulta
Los parámetros siguientes se pueden pasar a AppNexus en la cadena de consulta de la dirección URL del seguimiento de impresiones:
| Parámetro | Descripción |
|---|---|
cachebuster |
Impide que el explorador del usuario almacenar en caché la dirección URL del seguimiento de impresiones. El servidor de anuncios de terceros puede rellenar este parámetro. |
ancost |
El costo multimedia que pagaste por la impresión. El servidor de anuncios de terceros puede rellenar el parámetro. |
redir |
Dirección URL de redireccionamiento a la que AppNexus redirigirá una vez registrada la impresión. |
Ejemplo de etiqueta de imagen
<!-- Imp Tracker - Test Impression Tracker - DO NOT MODIFY -->
<img src="media/imptr?id=531&cachebuster=[CACHEBUSTER]&ancost=[ANCOST]" width="1" height="1" />
<!-- End of Imp Tracker -->
Ejemplo de etiqueta de JavaScript
<!-- Imp Tracker - Test Impression Tracker - DO NOT MODIFY -->
<script src="https://ib.adnxs.net/imptr?id=531&cachebuster=[CACHEBUSTER]&ancost=[ANCOST]" type="text/javascript"></script>
<!-- End of Imp Tracker -->
Reporting
Puede informar sobre las impresiones externas mediante los informes Análisis de red, Análisis de publicador de red y Análisis de publicador .
API de REST
| Http (método) | Endpoint | Description |
|---|---|---|
POST |
https://api.appnexus.com/imptracker?advertiser_id=ADVERTISER_ID (JSON de imptracker) |
Agregue un rastreador de impresiones. |
PUT |
https://api.appnexus.com/imptracker?id=IMP_TRACKER_ID (JSON de imptracker) |
Modificar un seguimiento de impresiones. |
GET |
https://api.appnexus.com/imptracker?id=IMP_TRACKER_ID | Ver un seguimiento de impresiones. |
GET |
https://api.appnexus.com/imptracker?id=1,2,3 | Vea varios seguimientos de impresiones por identificador mediante una lista separada por comas. |
DELETE |
https://api.appnexus.com/imptracker?id=IMP_TRACKER_ID | Elimine un seguimiento de impresiones. |
Campos JSON
| Campo | Tipo | Descripción |
|---|---|---|
id |
Entero | Identificador del rastreador de impresiones. Predeterminado: Número incrementado automáticamente (es decir, 123). Obligatorio On: PUT/DELETE, en la cadena de consulta. |
member_id |
Entero | Id. del miembro al que pertenece el anunciante. Solo lectura. |
advertiser_id |
Entero | Identificador del anunciante propietario del rastreador de impresiones. Obligatorio On: POST, en la cadena de consulta. |
name |
string | Nombre del rastreador de impresiones. Obligatorio activado: POST |
code |
string | Código personalizado para el seguimiento de impresiones. |
state |
enumeración | Estado del rastreador de impresiones. Valores posibles: "active" o "inactive".Predeterminado: "active" |
publisher |
objeto | Publicador al que está asociado el seguimiento de impresiones. Para obtener más información, consulte Publicador a continuación. Obligatorio activado: POST |
tag |
matriz | Ubicación a la que está asociado el rastreador de impresiones. Para obtener más información, consulte Etiqueta a continuación. |
payment_rule |
objeto | Regla de pago a la que está asociado el seguimiento de impresiones. Para obtener más información, consulte Regla de pago a continuación. |
line_item |
objeto | Elemento de línea del anunciante al que está asociado el rastreador de impresiones. Para obtener más detalles, vea Elemento de línea a continuación. Obligatorio activado: POST |
clicktracker |
objeto | Actualmente no está en uso. |
last_modified |
Timestamp | Fecha y hora en que se modificó por última vez el seguimiento de impresiones. Solo lectura. |
Publisher
Puede usar el servicio publisher para obtener información sobre los publicadores.
| Campo | Tipo | Descripción |
|---|---|---|
id |
Entero | Identificador del publicador al que está asociado el seguimiento de impresiones. |
name |
string | Nombre del publicador al que está asociado el rastreador de impresiones. Solo lectura. |
Etiqueta
Puede usar el servicio de selección de ubicación para obtener información sobre las ubicaciones.
| Campo | Tipo | Descripción |
|---|---|---|
id |
Entero | Identificador de la ubicación a la que está asociado el seguimiento de impresiones. |
name |
string | Nombre de la ubicación a la que está asociado el rastreador de impresiones. Solo lectura. |
Regla de pago
Puede usar el servicio de regla de pago para obtener información sobre las reglas de pago.
| Campo | Tipo | Descripción |
|---|---|---|
id |
Entero | Identificador de la regla de pago a la que está asociado el seguimiento de impresiones. |
name |
string | Nombre de la regla de pago a la que está asociado el seguimiento de impresiones. Solo lectura. |
Elemento de línea
Puede usar el servicio de elementos de línea para obtener información sobre los elementos de línea.
| Campo | Tipo | Descripción |
|---|---|---|
id |
Entero | Identificador del elemento de línea al que está asociado el seguimiento de impresiones. |
name |
string | Nombre del elemento de línea al que está asociado el seguimiento de impresiones. Solo lectura. |
Ejemplos
Creación de un nuevo seguimiento de impresiones
$ cat imptracker
{
"imptracker": {
"name": "Test Impression Tracker",
"publisher": {
"id": 44449
},
"line_item": {
"id": 74957
}
}
}
$ curl -b cookies -c cookies -X POST -d @imptracker 'https://api.appnexus.com/imptracker?advertiser_id=37236'
{
"response": {
"status": "OK",
"count": 1,
"id": 1425,
"start_element": 0,
"num_elements": 100,
"imptracker": {
"id": 1425,
"member_id": 958,
"advertiser_id": 37236,
"name": "Test Impression Tracker",
"code": null,
"state": "active",
"last_modified": "2012-01-10 16:02:15",
"publisher": {
"id": 44449,
"name": "November Publisher"
},
"tag": null,
"payment_rule": null,
"line_item": {
"id": 74957,
"name": "Test Line Item"
}
}
}
}
Actualización de un seguimiento de impresiones
En este ejemplo, la PUT solicitud asocia una ubicación al seguimiento de impresiones 1425.
$ cat imptracker_update
{
"imptracker": {
"tag": {
"id": 474412
}
}
}
$ curl -b cookies -c cookies -X PUT -d @imptracker_update 'https://api.appnexus.com/imptracker?id=1425'
{
"response": {
"status": "OK",
"count": 1,
"id": "1425",
"start_element": 0,
"num_elements": 100,
"imptracker": {
"id": 1425,
"member_id": 958,
"advertiser_id": 37236,
"name": "Test Impression Tracker",
"code": null,
"state": "active",
"last_modified": "2012-01-10 16:10:12",
"publisher": {
"id": 44449,
"name": "November Publisher"
},
"tag": {
"id": 474412,
"name": "[Demo Publisher] - Default"
},
"payment_rule": null,
"line_item": {
"id": 74957,
"name": "Test Line Item"
}
}
}
}
Visualización del seguimiento de impresiones 582
$ curl -b cookies -c cookies 'https://api.appnexus.com/imptracker?id=582'
{
"response": {
"status": "OK",
"count": 1,
"start_element": 0,
"num_elements": 100,
"imptracker": {
"id": 582,
"member_id": 1066,
"advertiser_id": 35081,
"name": "Test Impression Tracker 1",
"code": null,
"state": "active",
"last_modified": "2012-02-28 19:06:01",
"publisher": {
"id": 89287,
"name": "Test Publisher 1"
},
"tag": null,
"payment_rule": null,
"line_item": {
"id": 31189,
"name": "Test Line Item 1"
}
}
}
}
Visualización de todos los rastreadores de impresiones del anunciante 35081
$ curl -b cookies -c cookies 'https://api.appnexus.com/imptracker?advertiser_id=35081'
{
"response": {
"status": "OK",
"count": 2,
"start_element": 0,
"num_elements": 100,
"imptrackers": [
{
"id": 582,
"member_id": 1066,
"advertiser_id": 35081,
"name": "Test Impression Tracker 1",
"code": null,
"state": "active",
"last_modified": "2012-02-28 19:06:01",
"publisher": {
"id": 89287,
"name": "Test Publisher 1"
},
"tag": null,
"payment_rule": null,
"line_item": {
"id": 31189,
"name": "Test Line Item 1"
}
},
{
"id": 584,
"member_id": 1066,
"advertiser_id": 35081,
"name": "Test Impression Tracker 2",
"code": null,
"state": "active",
"last_modified": "2012-02-28 19:40:48",
"publisher": {
"id": 89288,
"name": "Test Publisher 2"
},
"tag": null,
"payment_rule": null,
"line_item": {
"id": 31190,
"name": "Test Line Item 2"
}
}
]
}
}