Vendors
Enable and configure the ad and analytics platforms that receive your conversion data from CleanClicks.
The Vendors tab in Configuration controls which ad and analytics platforms receive your conversion data. Each vendor can be enabled or disabled independently, and most require platform-specific credentials.
Accessing Vendor Configuration
- Go to Configuration in the sidebar
- Select the domain from the domain picker (if you have multiple)
- Click the Vendors tab
Supported Vendors
Ad Platforms
These count against your plan's ad platform limit.
| Vendor | What It Does | Required Fields |
|---|---|---|
| Google Ads | Uploads offline conversions via the Google Ads API (requires a click ID -- see note) | Customer ID, Conversion Action resource name |
| Meta (Facebook) | Sends events via Meta Conversions API (CAPI) | Pixel ID, Access Token |
| TikTok | Sends events via TikTok Events API | Pixel Code, Access Token |
| Microsoft Ads | Uploads offline conversions via Microsoft Ads | Customer ID, Account ID |
Analytics Platforms
GA4 and Usermaven are analytics-layer connections (Signal and up). They do not count against your ad-platform limit.
| Vendor | What It Does | Required Fields |
|---|---|---|
| GA4 | Sends events via GA4 Measurement Protocol | Measurement ID, API Secret |
| Usermaven | Sends events via Usermaven server-side API | API Key, Server Token |
Note: GA4 and Usermaven are available on Signal, Clarity, and Command plans. Pulse customers can connect ad platforms but not analytics platforms.
Enabling a Vendor
- Find the vendor card on the Vendors tab
- Toggle the vendor on
- Fill in the required fields
- Click Save
Sensitive fields (access tokens, API secrets) are masked after saving. You'll see •••••••• instead of the actual value. To update a token, enter a new value and save again.
Platform Limits
Your plan determines how many vendors you can enable simultaneously:
| Plan | Max ad platforms |
|---|---|
| Pulse | 1 |
| Signal | 5 |
| Clarity | 5 |
| Command | Unlimited |
This limit counts ad platforms only. GA4 and Usermaven are analytics-layer connections (Signal and up) and do not count toward it.
If you try to enable more ad platforms than your plan allows, you'll see an upgrade prompt.
Disabling a Vendor
Toggle a vendor off to stop sending it data. The credentials are retained, so you can re-enable later without re-entering them.
Vendor-Specific Notes
Google Ads
- Customer ID is the 10-digit Google Ads account number
- Conversion Action resource name is the API resource path for the conversion (format:
customers/1234567890/conversionActions/123456789), not theAW-xxx/yyygtag snippet ID - Click conversions require a click ID (
gclid,wbraid, orgbraid); conversions without one are recorded in CleanClicks but not uploaded to Google Ads - The Developer Token is managed by CleanClicks; you don't need to provide one
Meta (Facebook)
- Use a System User Access Token, not a personal access token. Generate it in Meta Business Manager > Business Settings > System Users.
- The token needs
ads_managementandads_readpermissions - Optionally set a Test Event Code to verify events in Meta's Events Manager before going live
TikTok
- Get your Access Token from TikTok Events Manager > Settings > Generate Access Token
- The Pixel Code is on the same page (format:
CXXXXXXXXXXXXXXXXX)
Microsoft Ads
- Requires your Customer ID and Account ID from the Microsoft Ads dashboard
- Both are visible in the top-right of your Microsoft Ads interface
GA4
- Measurement ID is in
G-XXXXXXXXXXformat (found in GA4 Admin > Data Streams) - API Secret is generated in GA4 Admin > Data Streams > your stream > Measurement Protocol API secrets
Usermaven
- API Key and Server Token are both in your Usermaven workspace settings (Settings > API Keys); CleanClicks needs both
Next: Triggers and Events