Getting Started with Vortex

Add this script to your landing page to capture clicks, form submissions, and conversions.

<script src="https://vortextrk.com/tf.js" data-vtx="YOUR_TRACKING_ID"></script>

• Place the snippet just before the closing </body> tag on every landing page.
• The script automatically captures: page views, form submissions, UTM parameters, click IDs (fbclid / gclid / ttclid), and device info.
• All events are sent server-side for privacy compliance -- no data is stored in the browser.

Campaigns group your ad spend and conversions across platforms.

1. 1Go to Campaigns → Create Campaign.
2. 2Set a name, select a platform (Meta, Google, or TikTok), and enter your budget.
3. 3A unique Campaign ID is auto-generated for you.
4. 4Use the campaign ID in your tracking links for attribution.

Tracking links let you measure every click from ad to conversion.

1. 1Go to Tracking Links → Create Link.
2. 2Set the Target URL (your landing page).
3. 3Add UTM parameters (source, medium, campaign, content, term).
4. 4Add SubIDs (sub1 – sub5) for affiliate tracking.
5. 5Enable click ID passthrough (fbclid / gclid / ttclid) so conversions can be attributed back to the ad platform.
6. 6Copy the generated tracking link.

Link format:

https://vortextrk.com/api/r/LINK_ID?sub1=...

Send qualified conversions to Meta via the Conversions API so your ad sets optimise for real leads, not spam.

1. 1Go to Settings → Pixels.
2. 2Add your Meta Pixel ID.
3. 3Add your Meta Access Token (found in Events Manager → Settings).
4. 4Go to Postback Rules and set the quality threshold (recommended: 70).
5. 5Vortex will automatically send qualified conversions to Meta in real-time.

Push conversion events to GA4 via the Measurement Protocol for server-side attribution.

1. 1Go to Settings → Pixels.
2. 2Add your GA4 Measurement ID (G-XXXXXXXXXX).
3. 3Add your GA4 API Secret (from GA4 Admin → Data Streams → Measurement Protocol).
4. 4Configure postback rules to control which conversions are forwarded.

Quality scoring lets you separate real leads from bots and spam before they reach your CRM or ad platform.

1. 1Go to Settings → Quality Rules.
2. 2Adjust scoring weights for each factor (form time, email, phone, UTM, referrer, etc.).
3. 3Set quality thresholds:

Go to Bot Rules to add IP blacklists and user-agent block patterns.

Postback rules control which conversions are sent to ad platforms and under what conditions.

1. 1Go to Postback Logs → Templates.
2. 2Choose a platform template (Meta, Google, TikTok, or Custom).
3. 3Set the minimum quality score required to fire a postback.
4. 4Enable duplicate blocking to prevent double-counting.
5. 5Set a daily cap if you need to limit the number of postbacks per day.

Use the REST API to send events, pull data, or build custom integrations.

Core Endpoints

Authentication

All authenticated endpoints require a session cookie or an X-API-Key header. The /api/events/track endpoint is public and does not require authentication.

Example: Track an Event

curl -X POST https://vortextrk.com/api/events/track \
  -H "Content-Type: application/json" \
  -d '{
    "eventName": "formsubmit",
    "contactEmail": "user@example.com",
    "contactPhone": "+972501234567",
    "contactName": "John Doe",
    "pageUrl": "https://example.com/landing",
    "utmSource": "facebook",
    "utmMedium": "cpc",
    "utmCampaign": "summer_sale"
  }'