Quick Start

1. Create Your Gateway Tenant

1. Sign in to the PixelsCleared dashboard.
2. Go to Gateway in the sidebar and click Create Tenant.
3. Enter your preferred subdomain prefix (for example, track or events).
4. Copy the CNAME target shown on the screen — it will look like gateway.pixelscleared.com.
5. In your DNS provider, create a CNAME record:

- Host: track.yourdomain.com

- Points to: gateway.pixelscleared.com

1. Click Verify DNS in the dashboard. A green checkmark means your subdomain is live.

DNS changes can take up to an hour to propagate. You can continue setup while waiting.

2. Copy Your API Key

1. In the dashboard, go to Gateway > Settings.
2. Your API Key is displayed at the top of the page.
3. Copy and store it securely — you will not be able to view it again after leaving this page.

The API key is embedded into your tracking script automatically. You only need it if you are sending events from a custom backend.

3. Install the Tracking Script

Add this tag to every page of your website, ideally just before the closing </head> tag:

<script src="https://track.yourdomain.com/pixelscleared.js"></script>

Replace track.yourdomain.com with the subdomain you set up in step 1.

The script loads from your own domain, not from PixelsCleared. This means ad blockers and browser privacy features will not block it.

If you use Google Tag Manager, you can add the script as a Custom HTML tag that fires on all pages.

4. Connect Your First Destination

Destinations are the platforms that receive your scrubbed events. Start with Meta or GA4:

Meta Conversions API (CAPI):

1. Open Meta Events Manager and select your Pixel.
2. Go to Settings > Conversions API > Generate Access Token.
3. Copy the Pixel ID (numeric) and the Access Token (starts with EAAB).
4. In PixelsCleared, go to Gateway > Destinations > Add Destination.
5. Select Meta CAPI, paste both values, and click Save.

GA4 Measurement Protocol:

1. Open Google Analytics > Admin > Data Streams > select your web stream.
2. Copy the Measurement ID (format: G-XXXXXXXXXX).
3. Under Measurement Protocol API secrets, click Create and copy the secret.
4. In PixelsCleared, go to Gateway > Destinations > Add Destination.
5. Select GA4, paste both values, and click Save.

5. Verify Events Are Flowing

1. Open your website in a browser.
2. Accept your consent banner (the widget stays dormant until consent is granted).
3. Browse a few pages and trigger any tracked actions (form submit, button click).
4. Return to the PixelsCleared dashboard and go to Gateway > Events.
5. You should see events appearing within a few seconds, with columns for event type, consent status, and which destinations received them.

If events are not appearing, check that your consent banner is granting consent and that the script tag URL matches your verified subdomain.