Advertiser quickstart

What Gravity does for you

Gravity places your brand inside real conversations on AI platforms — chat apps, coding assistants, AI search. When a conversation is relevant to your product, Gravity generates an ad tuned to that specific conversation. You don’t write ad copy. There are two things you need to set up:

Install the Gravity pixel on your website so we can track who clicked your ad
Send us your conversions so we can tell you which ads are actually driving revenue

That’s the whole integration. Let’s walk through it.

Go to app.trygravity.com/advertiser/signup
Enter your email and company name
Add a credit card (you can set a billing plan later)

Then create your first campaign: Dashboard → Campaigns → New.

Field	What to enter
Name	An internal label (users won’t see this)
URL	Your landing page — Gravity reads it to understand your product and generate relevant ads
Daily budget	The most you want to spend per day

Hit save — your campaign is live.

Step 2 — Install the pixel on your website

This is required. Without the pixel, Gravity can’t track conversions or optimize your campaigns.

Add this snippet to the <head> of your website. It needs to be on every page and every subdomain where a visitor might land or convert.

<script>
  !function(w,d,t,u,n,a,m){w['GravityPixelObject']=n;w[n]=w[n]||function(){
  (w[n].q=w[n].q||[]).push(arguments)},w[n].l=1*new Date();a=d.createElement(t),
  m=d.getElementsByTagName(t)[0];a.async=1;a.src=u;m.parentNode.insertBefore(a,m)
  }(window,document,'script','https://code.trygravity.ai/gr-pix.js','gravity');
  gravity('init', 'YOUR_ADVERTISER_ID');
</script>

Replace YOUR_ADVERTISER_ID with your ID from Settings → Organization in the dashboard.

Put the pixel in your site’s root layout or header template so it loads on every page automatically. Don’t add it to individual pages one by one — that’s error-prone and you’ll miss pages.

Using Shopify? Skip this — connecting Shopify installs the pixel for you.

Verify the pixel is working

Open your website in a browser
Open DevTools (right-click → Inspect → Network tab)
Look for a request to api.trygravity.ai/track/gr-events
A 200 response means it’s working

Step 3 — Set up conversion tracking

CAPI is required for conversion campaigns. Use the pixel for browser activity and CAPI for backend-confirmed purchases, signups, leads, and any other event type. Without it, conversions blocked or missed by browser tracking can go unattributed. Pick the option that matches your setup:

Shopify

One-click connect. Pixel + conversions are automatic — no code needed.

Conversions API

Send conversions from your backend. Works with any platform.

App installs

Track iOS / Android installs via your backend or MMP postback.

Stripe

Connect your Stripe account or point a webhook at Gravity.

Cal.com

Booking webhook for demo / consulting flows.

Quick CAPI example

If you’re not on Shopify, here’s the gist. Full guide: Server-side conversions. 1. On your checkout/thank-you page, read the pixel’s attribution data:

var capiData = window.gravityPixel.getCAPIData();

// Send it to your backend with the order
fetch('/api/complete-order', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    order_id: 'order-123',
    total: 99.99,
    email: 'customer@example.com',
    gravity: capiData
  })
});

2. On your backend, forward it to Gravity:

gravity_data = request.json.get("gravity", {})

requests.post(
    "https://api.trygravity.ai/gateway/events",
    params={"api_key": "YOUR_API_KEY"},
    json={
        "data": [{
            "event_name": "Purchase",
            "event_time": int(time.time()),
            "event_id": f"order-{order_id}",
            "action_source": "website",
            "event_source_url": gravity_data.get("event_source_url", ""),
            "user_data": {
                **gravity_data.get("user_data", {}),
                "em": [customer_email],
            },
            "custom_data": {
                "value": order_total,
                "currency": "USD",
                "order_id": order_id,
            },
        }],
    },
)

That’s it. Gravity handles attribution, deduplication, and reporting from here.

Step 4 — Watch it run

Dashboard → Campaigns → your campaign. You’ll see:

Impressions, clicks, and spend
Conversion count and ROAS (once conversions are flowing)
Top-performing publishers and conversation topics

Optional — Improve attribution accuracy

For even better tracking (especially on Safari and browsers that block third-party cookies), you can route pixel requests through your own domain. It’s a simple forwarding rule — no custom code. See the first-party proxy setup in the Pixel guide.

Conversions API

Full CAPI setup guide with Python, Node.js, and cURL examples.

Campaigns

Targeting, bidding, and creative guidelines.

Questions? support@trygravity.ai

Get started

Measure

Reference

Advertiser quickstart

What Gravity does for you

Step 2 — Install the pixel on your website

Verify the pixel is working

Step 3 — Set up conversion tracking

Shopify

Conversions API

App installs

Stripe

Cal.com

Quick CAPI example

Step 4 — Watch it run

Optional — Improve attribution accuracy

Next

Conversions API

Campaigns

​What Gravity does for you

​Step 1 — Sign up and create a campaign

​Step 2 — Install the pixel on your website

​Verify the pixel is working

​Step 3 — Set up conversion tracking

Shopify

Conversions API

App installs

Stripe

Cal.com

​Quick CAPI example

​Step 4 — Watch it run

​Optional — Improve attribution accuracy

​Next

Conversions API

Campaigns

What Gravity does for you

Step 1 — Sign up and create a campaign

Step 2 — Install the pixel on your website

Verify the pixel is working

Step 3 — Set up conversion tracking

Quick CAPI example

Step 4 — Watch it run

Optional — Improve attribution accuracy

Next