A tracker belongs to the advertiser, the campaign or the media buy. It never
attaches to a package or a creative.
The levels add up
A tracker at a narrower level adds to the trackers of the wider ones. It never replaces them and never turns one off.- A media buy’s creatives carry the advertiser’s trackers, the campaign’s trackers and the buy’s own, all together.
- A verification pixel on the campaign keeps firing on every seller when you add a publisher pixel to one buy.
- The one way to turn an inherited advertiser tracker off is a campaign override
(
tracking.overridesonsave_campaign), as before. A media buy has no overrides.
One tracker per publisher in a cross-publisher campaign
A third-party ad server often keys its reports on the URL, with the publisher in the path, so one shared URL cannot tell publishers apart. To measure each publisher on its own, put that publisher’s tracker on its media buy:- Put what every seller shares, such as a verification pixel, on the campaign or the advertiser.
- Put each publisher’s own placement URL on that publisher’s media buy only.
{MEDIA_BUY_ID} and the other identity macros are still filled for each buy when
the trackers are sent, so a shared tracker URL can also say which buy it came
from.
How many each level holds
Each level holds at most 10 trackers of its own: 10 for the advertiser, 10 for a campaign and 10 for a media buy. There is no combined limit, so one media buy can carry up to 30 trackers in all. A write that sends more than 10 for one level is refused, and Apostra never drops a tracker to fit a count. A seller’s format can accept fewer trackers than you set. When the whole set is larger than the format’s tracker slots, Apostra sends none of the third-party trackers with that creative, the shared ones on the campaign and advertiser included, and reports the trackers that were not delivered. It never sends part of the list. A buy’s own tracker makes the set larger, so check the format’s slots before adding one. See Trackers to traffic.Set a media buy’s trackers
Sendtracking on its own with the buy’s id:
trackers is the buy’s complete list: a tracker you leave out is removed. Read
the list back with get for the media buy and include: ["tracking"]. It returns
the buy’s own trackers and a trackingRevision; send that back as
tracking.expectedRevision to refuse an update that raced another. The read
does not merge in the campaign’s or the advertiser’s trackers, which you read on
their own.
When you create a media buy, you can send tracking with the create. It is saved
once the draft exists, and the create stages exactly one buy for it. If a create
stages more than one buy, or the trackers cannot be saved, the response says the
draft was created and that the trackers were not saved. Set them with
mediaBuyId and tracking for the buy they belong to.