Developer quickstart

Get your first conversion tracked in five steps, from copying the project key to seeing the event in the dashboard.

guide |beginner |4 min |Updated Sep 2026

This is the shortest path from an empty page to a tracked conversion. It takes about 5 minutes.

1. Get your project key

Sign in to the Convultra dashboard and go to Settings → Tracking. The Project API key is shown in full at the top with a Copy button. It looks like proj_abc123....

If you do not have a project yet, click Create Project, enter your domain and timezone, and the key is generated automatically.

Which key is which. The proj_ key is the public tracking key. It goes in your page and can only record events. It is not the secret sk_ key used to read data from the REST API.

2. Add the tracking script

Paste this into your site’s <head>. The stub queues any calls made before the SDK finishes loading, so nothing is lost.

<!-- Convultra stub: queues calls before SDK loads -->
<script>
window.Convultra=window.Convultra||(function(){
  var q=[];var c={q:q,initialized:false,config:{}};
  ['init','track','trackPurchase','trackLead','trackSignup','trackConversion',
   'trackAddToCart','trackViewContent','trackBeginCheckout','enhance',
   'setEnhancedUserData','identify','trackContact','trackSchedule',
   'trackDownload','trackSubscription','trackAddPaymentInfo',
   'trackAddToWishlist','trackSearch'].forEach(function(m){
    c[m]=function(){q.push({m:m,a:Array.prototype.slice.call(arguments,0),t:Date.now()});return c;};
  });
  return c;
})();
</script>
<script async src="https://cdn.convultra.com/ultra.min.js" data-convultra-key="YOUR_API_KEY"></script>

Replace YOUR_API_KEY with the project key from step 1.

The stub creates a light Convultra object that records method calls in a queue. When the async script loads, the SDK drains the queue and processes every call in order. No race conditions, no render blocking.

3. Track your first conversion

Add this anywhere after the snippet: on a thank-you page, in a form submit handler, or inline.

<script>
  Convultra.trackPurchase({
    orderId: 'order_123',
    value: 99.99,
    currency: 'USD'
  })
</script>

Or track a lead:

<script>
  Convultra.trackLead({
    leadId: 'lead_456',
    value: 25.00,
    email: 'jane@example.com',
    source: 'contact-form'
  })
</script>

4. Check the dashboard

Open Conversions. The event appears within a minute or two with its type, value, source and delivery state.

If it does not appear, open the browser console for errors and confirm the key matches your project. Troubleshooting has the full checklist.

5. Connect an ad platform

Go to Integrations and connect Google Ads or OpenAI Ads. Convultra then forwards every tracked conversion through the platform’s API. Forwarding to Meta, Microsoft Ads and TikTok is coming soon; the connections exist today for ad spend sync from Google Ads, Microsoft Ads and OpenAI Ads.

Next steps

I want to	Go here
See every installation method	Installing the tracking script
Track every conversion type	Tracking conversions
Add enhanced conversions	Enhanced conversions in the SDK
Track the shopping funnel	E-commerce events
Send events from my server	Server-side tracking explained
Read my data programmatically	API overview