Cliquez sur Service de suivi

Le service De suivi des clics vous permet de suivre les clics des utilisateurs sur les contenus créatifs servis par des serveurs publicitaires tiers (par rapport à ceux servis par Xandr). Voici le principe de fonctionnement :

1. Vous utilisez le service Click Tracker pour créer un dispositif de suivi des clics. Le dispositif de suivi des clics spécifie l’élément de ligne et l’éditeur auxquels le suivi des clics est associé. En règle générale, il spécifie également l’URL de la page d’accueil cible pour le créatif (voir le redir paramètre ci-dessous pour l’autre cas). Si vous le souhaitez, il peut inclure la règle de placement ou de paiement spécifique à laquelle il est associé.
2. Vous créez l’URL du dispositif de suivi des clics et demandez au serveur publicitaire de l’utiliser comme URL de la page d’accueil du créateur. L’URL du suivi des clics doit être au https://ib.adnxs.com/clktr?id=12345format , où 12345 est l’ID de suivi de clic.
3. Lorsque le serveur publicitaire sert le créatif et que quelqu’un clique dessus, l’appel passe d’abord à ib.adnxs.com, où Xandr enregistre le clic, puis est redirigé vers la page d’accueil cible.

Pour obtenir des exemples d’utilisation spécifiques, consultez Exemples.

Paramètres de chaîne de requête

Les paramètres suivants peuvent être passés à Xandr dans la chaîne de requête de l’URL de suivi des clics :

Exemple

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

Reporting

Vous pouvez utiliser le clicktrackersflux de rapports en bloc pour afficher les données que vos suivis de clics externes ont passées à Xandr, telles que le temps de clic, les objets Xandr associés et le montant payé pour le clic externe. Pour une vue encore plus approfondie de vos clics externes, vous pouvez utiliser le clicktrackers flux en combinaison avec le rapport Conversions attribuées par l’annonceur .

API REST

Champs JSON

Éditeur

Vous pouvez utiliser le service serveur de publication pour obtenir des informations sur les éditeurs.

Élément de ligne

Vous pouvez utiliser le service d’élément de ligne pour obtenir des informations sur les éléments de ligne.

Tag

Vous pouvez utiliser le service placement pour obtenir des informations sur les placements.

Règle de paiement

Vous pouvez utiliser le service de règle de paiement pour obtenir des informations sur les règles de paiement.

Exemples

Create un nouveau dispositif de suivi des 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"
            }
        }
    }
}

Mettre à jour un dispositif de suivi des clics

Dans cet exemple, la PUT demande associe un placement pour cliquer sur le suivi 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"
            }
        }
    }
}

Afficher le suivi des 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"
            }
        }
    }
}

Afficher tous les suivis de clics pour l’annonceur 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"
                }
            }
        ]
    }
}