Haga clic en Servicio de seguimiento
El servicio Click Tracker le ofrece una manera de realizar un seguimiento de los clics de los usuarios en las creatividades que atienden los servidores de anuncios de terceros (en comparación con los que atiende Xandr). Aquí se muestra cómo funciona:
- Use el servicio Click Tracker para crear un seguimiento de clics. El seguimiento de clics especifica el elemento de línea y el publicador al que está asociado el seguimiento de clics. Por lo general, también especifica la dirección URL de la página de aterrizaje de destino para la creatividad (consulte el
redir
parámetro siguiente para el caso alternativo). Opcionalmente, puede incluir la ubicación específica o la regla de pago a la que está asociada. - La dirección URL se crea en el seguimiento de clics y se pide al servidor de anuncios que la use como dirección URL de la página de aterrizaje del creativo. La dirección URL del seguimiento de clics debe tener el formato
https://ib.adnxs.com/clktr?id=12345
, donde 12345 es el identificador de seguimiento de clics. - Cuando el servidor de anuncios sirve al creativo y alguien hace clic en él, la llamada primero va a
ib.adnxs.com
, donde Xandr registra el clic y, a continuación, se redirige a la página de aterrizaje de destino.
Para obtener ejemplos de uso específicos, vea Ejemplos.
Los parámetros siguientes se pueden pasar a Xandr en la cadena de consulta de la dirección URL del seguimiento de clics:
Parámetro | Descripción |
---|---|
cachebuster |
Impide que el explorador del usuario almacenar en caché la dirección URL del seguimiento de clics. El servidor de anuncios de terceros puede rellenar este parámetro. |
ancost |
El costo multimedia que pagó por el clic externo. El servidor de anuncios de terceros puede rellenar el parámetro. Puede pasar un valor máximo de "9999999.9999999". |
redir |
Dirección URL de redireccionamiento. Si click_url no se establece en el seguimiento de clics, debe usar este parámetro para pasar la dirección URL de la página de aterrizaje de destino a la que Xandr redirigirá una vez que se haya registrado el clic. |
https://ib.adnxs.com/clktrb?id=1234&cachebuster=[CACHEBUSTER]&ancost=[ANCOST]&redir=https://test-landing-page.com
Puede usar la clicktrackers
fuente de informes en masa para ver los datos que los rastreadores de clics externos pasaron a Xandr, como la hora de clic, los objetos Xandr asociados y la cantidad pagada por el clic externo. Para obtener una vista aún más profunda de los clics externos, puedes usar la clicktrackers
fuente en combinación con el informe Conversiones de atributos de anunciante .
Http (método) | Endpoint | Description |
---|---|---|
POST |
https://api.appnexus.com/clicktracker?advertiser_id=ADVERTISER_ID | Agregue un seguimiento de clics. |
GET |
https://api.appnexus.com/clicktracker?id=CLICK_TRACKER_ID | Ver un seguimiento de clics. |
GET |
https://api.appnexus.com/clicktracker?id=1,2,3 | Vea varios seguimientos de clics por identificador mediante una lista separada por comas. |
PUT |
https://api.appnexus.com/clicktracker?id=CLICK_TRACKER_ID | Modificar un seguimiento de clics. |
DELETE |
https://api.appnexus.com/clicktracker?id=CLICK_TRACKER_ID | Elimine un seguimiento de clics. |
Campo | Tipo (longitud) | Descripción |
---|---|---|
id |
Entero | Identificador del seguimiento de clics. - 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 | El identificador del anunciante propietario del seguimiento de clics. Obligatorio On: POST , en la cadena de consulta. |
name |
string | Nombre del seguimiento de clics. Obligatorio activado: POST |
code |
string | Código personalizado para el seguimiento de clics. |
state |
enumeración | Estado del seguimiento de clics. Valores posibles: "active" o "inactive" .Predeterminado: active |
click_url |
string | Página de aterrizaje de destino de la creatividad. Una vez que Xandr ha grabado un clic en la creatividad, esta es la página a la que Xandr redirigirá. Propina: Si no se establece este campo, la dirección URL de la página de aterrizaje de destino debe pasarse como el parámetro "redir" en la cadena de consulta de la dirección URL del seguimiento de clics. Para obtener más información, consulte Parámetros de cadena de consulta anteriores. |
publisher |
objeto | Publicador al que está asociado el seguimiento de clics. Para obtener más información, consulte Publicador a continuación. Obligatorio activado: POST |
line_item |
objeto | Elemento de línea del anunciante al que está asociado el seguimiento de clics. Para obtener más detalles, vea Elemento de línea a continuación. Obligatorio activado: POST |
tag |
matriz | Ubicación a la que está asociado el seguimiento de clics. Para obtener más información, consulte Etiqueta a continuación. |
payment_rule |
matriz | La regla de pago a la que está asociado el seguimiento de clics. Para obtener más información, consulte Regla de pago a continuación. |
last_modified |
Timestamp | Fecha y hora en que se modificó por última vez el seguimiento de clics. Solo lectura. |
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 clics. |
name |
string | Nombre del publicador al que está asociado el seguimiento de clics. Solo lectura. |
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 clics. |
name |
string | Nombre del elemento de línea al que está asociado el seguimiento de clics. Solo lectura. |
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 clics. |
name |
string | Nombre de la ubicación a la que está asociado el seguimiento de clics. Solo lectura. |
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 clics. |
name |
string | Nombre de la regla de pago a la que está asociado el seguimiento de clics. Solo lectura. |
$ cat clicktracker
{
"clicktracker": {
"name": "Test Click Tracker",
"click_url": "https://test-landing-page.com",
"publisher": {
"id": 44449
},
"line_item": {
"id": 74957
}
}
}
$ curl -b cookies -c cookies -X POST -d @clicktracker 'https://api.appnexus.com/clicktracker?advertiser_id=37236'
{
"response": {
"status": "OK",
"count": 1,
"id": 1425,
"start_element": 0,
"num_elements": 100,
"clicktracker": {
"id": 1425,
"member_id": 958,
"advertiser_id": 37236,
"name": "Test Click Tracker",
"code": null,
"state": "active",
"click_url": "https://test-landing-page.com",
"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"
}
}
}
}
En este ejemplo, la PUT
solicitud asocia una ubicación para hacer clic en el seguimiento 1425.
$ cat clicktracker_update
{
"clicktracker": {
"tag": {
"id": 474412
}
}
}
$ curl -b cookies -c cookies -X PUT -d @clicktracker_update 'https://api.appnexus.com/clicktracker?id=1425'
{
"response": {
"status": "OK",
"count": 1,
"id": "1425",
"start_element": 0,
"num_elements": 100,
"clicktracker": {
"id": 1425,
"member_id": 958,
"advertiser_id": 37236,
"name": "Test Click Tracker",
"code": null,
"state": "active",
"click_url": "https://test-landing-page.com",
"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"
}
}
}
}
$ curl -b cookies -c cookies 'https://api.appnexus.com/clicktracker?id=582'
{
"response": {
"status": "OK",
"count": 1,
"start_element": 0,
"num_elements": 100,
"clicktracker": {
"id": 582,
"member_id": 1066,
"advertiser_id": 35081,
"name": "Test Click Tracker 1",
"code": null,
"state": "active",
"click_url": "https://test-landing-page.com",
"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"
}
}
}
}
$ curl -b cookies -c cookies 'https://api.appnexus.com/clicktracker?advertiser_id=35081'
{
"response": {
"status": "OK",
"count": 2,
"start_element": 0,
"num_elements": 100,
"clicktrackers": [
{
"id": 582,
"member_id": 1066,
"advertiser_id": 35081,
"name": "Test Click Tracker 1",
"code": null,
"state": "active",
"click_url": "https://test-landing-page.com",
"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 Click Tracker 2",
"code": null,
"state": "active",
"click_url": "https://another-landing-page.com",
"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"
}
}
]
}
}