Service De suivi d’impression

Le service Suivi d’impression vous permet de suivre les impressions des créatifs servis par des serveurs publicitaires tiers (plutôt que par AppNexus).

Voici le principe de fonctionnement :

1. Vous utilisez le service Suivi d’impression pour créer un dispositif de suivi d’impression. Le suivi d’impression spécifie l’élément de ligne et l’éditeur auxquels il est associé. 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 une image ou une balise JavaScript avec l’URL du suivi d’impression et demandez au serveur publicitaire de l’utiliser comme pixel de piggyback pour le créatif. L’URL du suivi d’impression doit être mise en forme comme https://ib.adnxs.com/imptr?id=12345& t=2, où 12345 est l’ID de suivi d’impression et « t » représente le type de pixel (où t=1 est pour javascript et t=2 est pour l’image).
3. Lorsque le serveur publicitaire sert le créatif, le suivi appelle ib.adnxs.comet AppNexus enregistre l’impression.

Paramètres de chaîne de requête

Les paramètres suivants peuvent être passés à AppNexus dans la chaîne de requête de l’URL du suivi d’impression :

Exemple de balise d’image

<!-- 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 -->

Exemple de balise 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

Vous pouvez créer des rapports sur vos impressions externes à l’aide des rapports Network Analytics, Network Publisher Analytics et Publisher Analytics .

API REST

Champs JSON

Éditeur

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

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.

Élément de ligne

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

Exemples

Create un nouveau dispositif de suivi d’impression

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

Mettre à jour un suivi d’impression

Dans cet exemple, la PUT requête associe un placement au suivi d’impression 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"
            }
        }
    }
}

Afficher le suivi d’impression 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"
            }
        }
    }
}

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