Setup Guide

Get started in 3 steps

Integrating Ads Pulse takes less than 5 minutes. No developer needed.

Set Up Meta Ads URL Parameters

When creating or editing an ad in Meta Ads Manager, add the following to the URL Parameters field:

utm_campaign={{campaign.id}}&utm_adset={{adset.id}}&utm_ad={{ad.id}}

Note: These dynamic parameters let Meta automatically append the campaign, ad set, and ad IDs to every click URL.

Add the Tracking Script to Your Site

Paste the following script inside your site's <head> or <body> tag:

<script src="https://ads-pulse.com/tracker.js" data-key="YOUR_API_KEY"></script>

That's it! The script automatically:

Captures UTM parameters from the URL
Stores them in localStorage (30 days)
Listens for all form submissions
Sends form data + tracking IDs to the webhook

Install the Chrome Extension

Download Ads Pulse from the Chrome Web Store and start seeing real submission data right inside Meta Ads Manager.

Install from Chrome Web Store

Advanced Options

Exclude Specific Forms

Add the data-ads-pulse-ignore attribute to exclude a form from tracking:

<form data-ads-pulse-ignore>...</form>

Manual Tracking

Send data programmatically via JavaScript:

AdsPulse.track({
  campaign_id: '123456',
  email: 'test@example.com',
  name: 'John Doe'
});

Read Tracking Data

Access the current tracking data:

const data = AdsPulse.getTrackingData();
console.log(data.utm_campaign); // "123456789"

Webhook API

Send data directly from your own backend to the webhook:

POST https://ads-pulse.com/api/webhook
Content-Type: application/json
X-API-Key: YOUR_API_KEY

{
  "campaign_id": "120208765432",
  "adset_id": "120209876543",
  "ad_id": "120201234567",
  "email": "customer@example.com",
  "name": "Customer Name",
  "phone": "+1234567890"
}

Supported Fields

Field	Type	Description
`campaign_id`	string	Meta campaign ID
`adset_id`	string	Meta ad set ID
`ad_id`	string	Meta ad ID
`email`	string	Email (used for unique count)
`phone`	string	Phone number
`name`	string	Full name

Need Help?

If you run into any issues during setup, we're here to help.

support@ads-pulse.com