Gravity Conversions API Destination
Send server-side conversions to Gravity to measure how your ads inside AI applications drive purchases, sign-ups, leads, and other conversions.
Use this page to connect Ours Privacy to Gravity, the advertising network that places ads inside AI applications such as chat assistants, coding tools, and AI search. Each conversion you forward is attributed against your Gravity campaigns, so you can measure how those ads drive purchases, sign-ups, leads, and other conversions, and keep that attribution working when the browser pixel can't fire.
Before you start
- A Gravity advertiser account with at least one live campaign.
- Your Gravity API Key, found in the Gravity dashboard under Settings → Organization.
- Ours Privacy's Web SDK installed on your landing pages. Gravity appends a click ID (
grclid) to your landing-page URL when someone clicks an ad, and the Web SDK captures it automatically so conversions can be attributed without the Gravity browser pixel. Gravity still recommends installing its pixel, and it is fine to keep both running: Gravity deduplicates events that arrive from both.
Setup
- Sign in to the Gravity dashboard and open Settings → Organization.
- Copy the API Key.
- In Ours Privacy, add the Gravity Conversions API destination and paste in your API Key.
- Optionally set a Test Event Code while you validate your setup. Gravity checks events without recording them while this is set, so clear it before going live.
- Choose the events you want to send and configure your event mappings. Connect at least one identity field (such as email, phone, or external ID), or rely on the Gravity click ID, so Gravity can match conversions to ad clicks.
- To confirm events are arriving, open Events Manager → Status in the Gravity dashboard. The Conversions API row turns Active within a minute or two of your first real event.
Event types
Map each of your events to one of Gravity's conversion event names, such as Purchase, Lead, CompleteRegistration, Subscribe, StartTrial, AddToCart, and more. The full list is shown in the mapping UI when you configure your mappings. Custom event names are also accepted.
A note on attribution
Gravity deduplicates conversions by event ID within a 48-hour window, so a retried event, or the same conversion arriving from both this destination and the Gravity browser pixel, is only counted once.
Next steps
Need help? Contact support@oursprivacy.com.
How is this guide?