Click tracking is essential for measuring ad performance in VTEX Ads. This guide explains how to properly send click events when users interact with your advertisements.

• Click events should be sent immediately when a user clicks on an ad.
• Each click is deduplicated within a 1-hour window per user, per device, per ad.
• Click events require both user_id and session_id for proper attribution.
• Click URLs are unique to each ad and should be obtained from the Get ads response.

🚧 Don't construct event URLs manually. Always use the URL provided from the POST Get ads request.

This is extremely important to ensure long-term stability of the integration, because the parameters of the event URL may change over time, but the integration itself does not.

Use the POST Track ad clicks endpoint to send click events. Check the endpoint documentation for detailed information about all available fields.

Request example:

Sucessful response example:

A successful response will have HTTP code 202.

Failed response example:

A failed response will have HTTP code 422. The error message follows the RFC 8927 format.