Skip to end of metadata
Go to start of metadata

Impression Tracker Service

The Impression Tracker Service gives you a way to track impressions for creatives served by third-party ad servers (rather than by AppNexus).

Here's how it works:

  1. You use the Impression Tracker Service to create an impression tracker. The impression tracker specifies the line item and publisher to which it is associated. Optionally, it can include the specific placement or payment rule to which it is associated.
  2. You create an image or JavaScript tag with the url to the impression tracker and ask the ad server to use it as a piggyback pixel for the creative. The impression tracker url must be formatted as http://ib.adnxs.com/imptr?id=12345 , where 12345 is the impression tracker ID.
  3. When the ad server serves the creative, the tracker calls ib.adnxs.com, and AppNexus records the impression.

Query String Parameters

The following parameters can be passed to AppNexus in the query string of the impression tracker url:

Parameter

Description

cachebuster

Prevents the user's browser from caching the impression tracker url. This parameter can be populated by the third-party ad server.

ancost

The media cost you paid for the impression. The parameter can be populated by the third-party ad server. 

redir

The redirect URL that AppNexus will redirect to once the impression has been recorded.

Image Tag Example
JavaScript Tag Example

Reporting

You can report on your external impressions using the Network Analytics, Network Publisher Analytics, and Publisher Analytics reports.

REST API

Add an impression tracker:
POST https://api.appnexus.com/imptracker?advertiser_id=ADVERTISER_ID
(imptracker JSON)

Modify an impression tracker:
PUT https://api.appnexus.com/imptracker?id=IMP_TRACKER_ID
(imptracker JSON)

View an impression tracker:
GET https://api.appnexus.com/imptracker?id=IMP_TRACKER_ID

View multiple impression trackers by ID using a comma-separated list:
GET https://api.appnexus.com/imptracker?id=1,2,3

Delete an impression tracker:
DELETE https://api.appnexus.com/imptracker?id=IMP_TRACKER_ID

JSON Fields

Field

Type

Description

Default

Required On

id

int

The ID of the impression tracker.

Auto-incremented number (i.e. 123)

PUT/DELETE, in query string

member_id

int

Read-only. The ID of the member to which the advertiser belongs.

 

 

advertiser_id

int

The ID of the advertiser that owns the impression tracker.

 

POST, in query string

name

string

The name for the impression tracker. 

 

POST

code

string

The custom code for the impression tracker.

 

 

state

enum

The state of the impression tracker. Possible values: "active" or "inactive".

"active"

 

publisher

object

The publisher to which the impression tracker is associated. See Publisher below for more details.

 

POST

tag

array

The placement to which the impression tracker is associated. See Tag below for more details.

 

 

payment_rule

object

The payment rule to which the impression tracker is associated. See Payment Rule below for more details.

 

 

line_item

object

The advertiser line item to which the impression tracker is associated. See Line Item below for more details.

 

POST

clicktracker

object

Not currently in use.

 

 

last_modified

timestamp

Read-only. The date and time when the impression tracker was last modified.

 

 

Publisher

You can use the Publisher Service to get information about publishers.

Field

Type

Description

id

int

The ID of the publisher to which the impression tracker is associated.

name

string

Read-only. The name of the publisher to which the impression tracker is associated.

Tag

You can use the Placement Service to get information about placements.

Field

Type

Description

id

int

The ID of the placement to which the impression tracker is associated.

name

string

Read-only. The name of the placement to which the impression tracker is associated.

Payment Rule

You can use the Payment Rule Service to get information about payment rules.

Field

Type

Description

id

int

The ID of the payment rule to which the impression tracker is associated.

name

string

Read-only. The name of the payment rule to which the impression tracker is associated.

Line Item

You can use the Line Item Service to get information about line items.

Field

Type

Description

id

int

The ID of the line item to which the impression tracker is associated.

name

string

Read-only. The name of the line item to which the impression tracker is associated.

Examples

Creating a new impression tracker
Updating an impression tracker
Viewing impression tracker 582
Viewing all impression trackers for advertiser 35081