How does real time line item tracking work
Line Item Macros in DV360
Line item macros in DV360 are special placeholder codes (like \( {CAMPAIGN_ID} or \){CLICK_URL}) that you add inside third-party ad tags (e.g., when uploading third-party display or video creatives).
DV360 automatically replaces these placeholders with real values at the moment the ad serves (during an impression or click). This lets third-party ad servers or verification tools track exactly which line item, creative, campaign, user, etc., caused the view or click.
Explanation: How They Actually Work Step by Step
Add a new creative in DV360 - using 3rd party ad tag
You paste a third-party tag into a creative
Example: A tag from your ad server might look like this (fake example):
You save the creative in DV360
DV360 checks and "wraps" the tag (adds its own tracking if needed). The macro stays as-is for now.
assign that creative to one or more line items
Now the creative is linked to specific line items (each line item has its own ID, targeting, budget, etc.).
An impression or click happens
Someone sees or clicks your ad.
DV360 wins the auction for that specific line item.
Right before sending the ad to the user, DV360 quickly replaces every macro with the real info from that line item.
Example replacements:
- ${LINE_ITEM_ID} → becomes the actual number of the line item that won (e.g., 987654321)
- ${CAMPAIGN_ID} → becomes the line item's parent campaign ID (wait-actually in DV360 it's often called LINE_ITEM_ID for the line item itself, but macros use consistent names)
- ${CLICK_URL} → becomes the full DV360 click-tracker URL (something long like https://ad.doubleclick.net/click?...)
The final tag fires with real values
The third-party server receives:
https://thirdpartytracker.com/impression?adv=123&camp=12345678&line=987654321Now they know exactly which line item delivered the impression/click.
Hence, separate ad tags are not required. Using one ad tags 3rd party ad server tech understands which line item is serving an impression in real time. This only works in real time impressions. If you check the ad in the console it will not trigger the line item.
Key Points to Remember
- Macros only work in third-party tags (not in native DV360-hosted image/HTML5 creatives).
- They are replaced dynamically per impression/click - the same creative can be assigned to 10 different line items, and each time it serves, the macros pull the correct line item's details.
- No manual work needed after setup - DV360 handles the replacement automatically.
- This is how macros make reporting accurate across many line items without creating separate creatives for each one.