Quickstart

From zero to a server-side conversion event in your Meta Events Manager — in five minutes.

Before you start: have your Meta Pixel ID, TikTok Pixel Code, and access tokens ready. We'll show you where to find each below.

1. Create your pixel

  1. Go to adsping.io/signup and create your account.
  2. Click + New pixel. Each domain gets its own pixel (and its own subscription).
  3. Enter your domain (no https://, just example.com). Add subdomains if needed, or check "Allow all subdomains" for a wildcard.
  4. Pick a plan: Standard ($29/mo) for up to 100K events/month, Pro ($79/mo) for up to 1M. 14-day free trial — no charge today.
  5. Complete the checkout. Trial starts immediately.

2. Install pb.js

Open the pixel detail page and copy the install snippet. It looks like this:

html
<script src="https://api.adsping.io/pb.js?id=YOUR_PIXEL_ID"></script>

Paste it inside <head> on every page you want to track. Most sites have a single layout file or template that handles this — Shopify themes, Next.js root layout, WordPress header.php, etc.

Verify the install

  1. Open your site in a regular browser tab.
  2. Open DevTools → Network → filter for adsping.
  3. You should see pb.js load (200) and a request to /api/v1/t/YOUR_PIXEL_ID for PageView (200).
  4. In your AdsPing dashboard, the pixel detail page should show "Last event: a few seconds ago" within ~10 seconds.

3. Connect Meta

  1. Go to Meta Events Manager and pick or create your pixel.
  2. Copy the Pixel ID (15-16 digits, top of the page).
  3. Settings tab → Conversions API → Generate access token → copy the token (shown once — save it).
  4. In AdsPing pixel detail → Meta card → either click Connect Meta for OAuth, or Manual setup and paste both values.
  5. Save. The Meta card turns green when the credentials validate.

4. Connect TikTok

  1. Go to TikTok Ads Manager → Tools → Events → Web Events.
  2. Pick or create your pixel. Copy the Pixel Code (looks like D7VH38JC77U3LFDOLGRG, 20-char alphanumeric).
  3. Pixel detail → Settings → Events API → Generate access token (one-time display).
  4. In AdsPing → TikTok card → paste both values → Save.
AdsPing automatically loads TikTok's browser pixel script (events.js) for you — no extra <script> tag needed. Browser + server fires share the same event_id so TikTok deduplicates them.

5. Test with Test Event Code

Both platforms have a Test Events tab where new events appear in real-time. To route AdsPing events there:

Meta Test Events

  1. Meta Events Manager → your pixel → Test Events tab → copy the test event code (e.g. TEST12345).
  2. AdsPing → pixel detail → pipeline list → click the pencil icon on the Meta pipeline.
  3. Paste the code into Test Event Code → Save.
  4. Trigger an event on your site (refresh the page, submit a form). Watch it appear in Meta's Test Events tab within 2 seconds.
  5. When done testing, clear the Test Event Code field → Save → events go to production reporting.

TikTok Test Events

Identical flow: TikTok Ads Manager → pixel → Test Events tab → copy the code → paste into AdsPing's pipeline → Save.

Test mode is per-pipeline, not global. Setting a Test Event Code on the Meta pipeline routes only Meta events to its Test tab — TikTok events still go to production until you set a code there too.

What's next