Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trygravity.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
What a Gravity campaign is

Your brand represented inside conversations on AI platforms (chat apps, coding assistants, AI search). When users have a conversation Gravity’s engine recognizes as relevant to you, we generate an ad tuned to that specific conversation — you don’t write ad copy per placement. The whole integration is pretty short.

​
1. Sign up + fund

app.trygravity.ai/advertiser/signup. Email + company name. Fund the account with a credit card — you can set up a billing plan later.

​
2. Create your campaign

Dashboard → Campaigns → New. The minimum you need:
FieldWhat it is
NameInternal label, not shown to users.
URLYour landing page. Gravity reads it to understand the brand, product, and audience — that’s what drives the ad copy we generate at serve-time.
Daily budgetMax spend per 24 hours.
Optional:
FieldWhat it is
Negative contextTopics / categories / competitor names you don’t want to show alongside. Brand-safety constraints. Anything you want Gravity to avoid.
Save → the campaign is live. Impressions start flowing as conversations matching your brand show up on the network.

​
3. Install the pixel

This is required. Without the advertiser pixel installed on your landing and conversion pages, you can’t measure ROAS, and Gravity can’t optimize against your real outcomes. Pixel install gates every downstream reporting and optimization capability.
Quick install: 
<!-- Before </body> on your landing + conversion pages -->
<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>
Full docs with Shopify OAuth one-click install, Direct API, Cal.com webhook, event types, and verification: Pixel.

​
4. Wire up conversions

Shopify

OAuth connect. Auto-subscribes to checkout_completed.

Direct API

POST conversions from your backend. A few lines.

Cal.com

Booking webhook for demo / consulting flows.

App installs

iOS / Android install tracking via S2S or MMP postback.
Segment, GTM, and Stripe webhooks aren’t supported today — use Direct API if you’re on one of those stacks.

​
5. Watch it run

Dashboard → Campaigns → your campaign. You’ll see impressions, spend, eCPM, and — once conversions are wired up — conversion count, ROAS, top-performing publishers and topics. Full metric glossary: Analytics.

​
Next

Campaigns

Pixel + conversions + monitoring in one place.

Pixel

Every conversion integration Gravity supports.
Questions: support@trygravity.ai.