Snapchat Pixel setup

Last updated: May 19, 2026

Snapchat Pixel setup

Snap Pixel is the browser tracking snippet for Snapchat (similar to Meta Pixel). Wevion auto-imports pixels from connected Snap ad accounts (snapchat_pixel model). You install the pixel JS on your site, configure standard events, verify firing — then use the pixel as a conversion target for Snap campaigns.

Who is this for

Mediabuyers running Snap conversion campaigns (Sales objective on Snap), e-commerce brands tracking purchases from Snap traffic.

What Snap Pixel tracks

The Snap Pixel fires events when users do things on your site:

  • PURCHASE — completed a transaction

  • ADD_CART — added item to cart

  • VIEW_CONTENT — viewed a product / page

  • SIGN_UP — registered an account

  • PAGE_VIEW — generic page view (auto-fired by base code)

  • START_CHECKOUT — initiated checkout

  • ADD_BILLING — added payment info

  • LIST_VIEW — viewed product list / category

  • SEARCH — site search

These match Snap's standard event names. Custom events also supported.

How Wevion imports pixels

When you connect Snapchat, all pixels associated with the connected ad accounts are auto-discovered:

  • snapchat_pixel row created per pixel (verified in prisma schema)

  • Visible at /pixels after first sync (~15 min)

  • Status synced from Snap (Active / Inactive / Error)

How to set up a new pixel

If you don't have a Snap Pixel yet:

Step 1: Create the pixel in Snap Ads Manager

Snap Ads Manager → Events Manager → Snap Pixel → Create New Pixel. Enter:

  • Pixel name (e.g. "My Store - Main")

  • Associated ad account

Snap generates a pixel ID + JavaScript snippet.

Step 2: Install the pixel JS

Add the snippet to your site before </head>:

<script type='text/javascript'>
  (function(e,t,n){if(e.snaptr)return;var a=e.snaptr=function(){
  /* Snap pixel base code */
  })(window,document,'https://sc-static.net/scevent.min.js');
  snaptr('init', 'YOUR_PIXEL_ID');
  snaptr('track', 'PAGE_VIEW');
</script>

Copy the exact snippet from Snap Ads Manager (the actual code has more lines).

Step 3: Add event tracking

On conversion pages (checkout success, signup confirmation), add an event-specific snippet:

<script>
  snaptr('track', 'PURCHASE', {
    'currency': 'USD',
    'price': 49.99,
    'transaction_id': 'order_12345'
  });
</script>

Available parameters per event vary — see Snap's official documentation in Snap Ads Manager.

Step 4: Verify with Snap Pixel Helper

Snap provides a Chrome extension called Snap Pixel Helper that shows pixel events firing on any page. Install + open on your site to verify.

Step 5: Wait for Wevion sync

After events start firing, Wevion's next 15-min sync picks up the pixel. View at /pixels with Active badge + event counts.

Pixel health at /pixels

/pixels page shows Snap pixels with:

  • Status badge: Active (events received last 7d), Inactive (no events 7d)

  • Event counts per type per day (last 7d)

  • Source domains (where events fire from)

A healthy Snap Pixel for an active e-commerce site shows hundreds of events/day with Active badge.

Conversions API (not yet implemented in Wevion)

Note: Wevion's Snapchat integration currently supports browser pixel only. Conversions API (Snap's server-side equivalent) is not yet implemented in Wevion. This means:

  • iOS 14.5+ ATT opt-out users may be under-tracked

  • Ad blockers reduce visibility

  • For higher accuracy: also send your conversions to Snap Ads Manager via Snap's CAPI directly (separate from Wevion) when needed

If your business heavily depends on iOS attribution on Snap, talk to your CSM about CAPI implementation timeline.

Using the pixel in a campaign

When you launch a Snap conversion-objective campaign in Campaign Creator:

  1. Pick ad account

  2. Select objective: Sales / Lead Generation

  3. Snap Pixel field appears → pick from imported pixels

  4. Conversion event → pick which event (PURCHASE, SIGN_UP, etc.)

  5. Snap optimizes campaign delivery toward users likely to fire that event

Without a configured pixel + event, Snap conversion campaigns cannot launch.

What you'll see

A correctly set up Snap Pixel:

  • /pixels shows the pixel with Active badge

  • Event counts visible per type per day

  • Snap Pixel Helper confirms events firing

  • Snap Ads Manager → Events Manager: pixel events tab shows recent events

  • Campaign Creator: pixel selectable for Sales / Lead Gen campaigns

Common issues

  • Pixel showing Inactive: pixel not installed correctly or not firing. Use Snap Pixel Helper to debug.

  • Pixel events arriving but with $0 value: event-level params not sent (missing price field). Update your event snippet.

  • Duplicate pixel events: pixel snippet installed twice on the same page. Inspect HTML for duplicate snaptr( calls; remove one.

  • No events on iOS 14.5+ users: expected — Snap CAPI would help but isn't in Wevion yet.

  • Pixel imported but Active in Snap Ads Manager, Inactive in Wevion: 15-min sync lag. Refresh after a cycle. If persistent, contact support.

Wevion's snapchat_pixel model

Verified in apps/backend/prisma/schema.prisma:

  • snapchat_pixel.connected boolean (true if currently tracked)

  • snapchat_pixel.deleted_at for soft delete

  • session_id for workspace data isolation

Wevion respects connection state — disconnected pixels stop appearing in Campaign Creator.

Related