Documentation
Feedback
Guides
VTEX IO Apps

VTEX IO Apps
Glossary
vtex.ads-agent
Version: 2.0.0
Latest version: 2.0.0
TermDefinition
Pixel appVTEX IO app type that runs a script in the storefront <head> to forward events to a tracking endpoint.
Publisher IDUUID issued by the VTEX Ads operational team that identifies a store/seller in the Ads platform. Configured per store via app settings.
Offsite bannerA VTEX Ads ad creative served outside the storefront (e.g. on partner sites). A click on it lands the user on the store with tracking params in the URL.
naidURL query parameter — the ad id of the clicked offsite banner. Required for the tracking beacon to fire.
ncidURL query parameter — the optional campaign id attached to the offsite click.
gadv_idURL query parameter — optional Google Ads click identifier propagated to the tracking beacon.
MAC IDAnonymous user identifier persisted in the VtexRCMacIdv7 cookie; used as the user_id on tracking beacons.
BeaconA non-blocking HTTP request (fetch with keepalive) that reports a tracked event to the Newtail endpoint.
Sourcing componentTag (PIXEL_VTEX_ADS_AGENT) added to ads_sourcing_components so downstream attribution knows which surface produced the event.
NewtailThe platform behind VTEX Ads; tracking beacons target events.newtail-media.newtail.com.br.
See also
Vtex.ads Agent
VTEX IO Apps
VTEX App Store
VTEX IO Apps
Was this helpful?