Docs / Capability guide
Beacons, conversions and attribution
Record ad events and compare them with delivery reports.
All capabilities · Related guide · Agent prompt for this capability
When to use this example
An auction response does not prove that someone saw an ad. Use this workflow when connecting a player or investigating a reporting discrepancy so impression, playback, click and conversion events reflect what actually happened.
What the example gives you
The serving probe gives you a starting request and inspects its response without sending beacons. The guide explains how to connect the issued event URLs to your application's callbacks and compare recorded events with reports.
Before you start
Sandbox traffic and valid issued beacon URLs; conversion ingestion also needs the authorized attribution configuration and consented identifiers.
Run the example
Extract the archive and follow README.md for setup, commands, and expected results. Start with serving_probe.py. Local tests use sample data.
Python tools accept --help. To connect to your workspace, supply the deployment URLs, credentials and resource IDs required by the tool.
Connect it to your application
Read the signed event URLs from the serving response. Preserve each full URL and call it once when its event occurs. Use only URLs issued for that decision and tenant.
Read getAttributionConfig before ingesting conversions. Use the conversion contract's identifiers, times and decimal values; distinguish ingestion acknowledgement from attribution and billing results.
Compare delivery reports after the event pipeline settles. Test duplicate, expired, and out-of-order events against the documented delivery-window rules.
Check the result
A repeated event must not double-credit delivery. The downloadable probe inspects issued URLs without sending events; a real player or application is needed to test event timing.