Leer en inglés

Compartir a través de


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:

  1. 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.
  2. 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.
  3. 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.

Parámetros de la cadena de consulta

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.

Ejemplo

https://ib.adnxs.com/clktrb?id=1234&cachebuster=[CACHEBUSTER]&ancost=[ANCOST]&redir=https://test-landing-page.com

Reporting

Puede usar la clicktrackersfuente 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 .

API REST

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.

Campos JSON

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.

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 clics.
name string Nombre del publicador al que está asociado el seguimiento de clics.
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 clics.
name string Nombre del elemento de línea al que está asociado el seguimiento de clics.
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 clics.
name string Nombre de la ubicación a la que está asociado el seguimiento de clics.
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 clics.
name string Nombre de la regla de pago a la que está asociado el seguimiento de clics.
Solo lectura.

Ejemplos

Creación de un nuevo seguimiento de clics

$ 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"
            }
        }
    }
}

Actualización de un seguimiento de clics

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

Ver seguimiento de clics 582

$ 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"
            }
        }
    }
}

Ver todos los seguimientos de clics del anunciante 35081

$ 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"
                }
            }
        ]
    }
}