Haga clic en Servicio de seguimiento

Artículo
07/05/2024

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.

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

Compartir a través de