Snapchat Pixel setup

Snap Pixel is a browser tracking snippet. Auto-imported from connected Snap ad accounts. Install JS on your site to track events.

Written By Salvatore Sinigaglia

Last updated About 5 hours ago

Snap Pixel is a browser tracking snippet. Auto-imported from connected Snap ad accounts. Install JS on your site to track events.

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 / Leads (Snapchat objectives in Wevion are Awareness & Engagement, Traffic, Leads, App Promotion, Sales)
  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 / Leads 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.

FAQ

Does Wevion support the Snapchat Conversions API?

No — Wevion's Snapchat integration currently supports browser pixel only. Snap's server-side Conversions API is not yet implemented in Wevion. This means iOS 14.5+ ATT opt-out users may be under-tracked and ad blockers reduce visibility. For higher accuracy you can also send conversions to Snap Ads Manager via Snap's CAPI directly, separate from Wevion.

What events can the Snap Pixel track?

The Snap Pixel fires standard events including PURCHASE, ADD_CART, VIEW_CONTENT, SIGN_UP, PAGE_VIEW, START_CHECKOUT, ADD_BILLING, LIST_VIEW, and SEARCH. Custom events are also supported. Install the base snippet before </head>, add event-specific snippets on conversion pages, then verify firing with Snap's Snap Pixel Helper Chrome extension.

How does Wevion import my Snap Pixels?

When you connect Snapchat, Wevion auto-discovers all pixels associated with the connected ad accounts, creating a snapchat_pixel row per pixel. They appear at /pixels after the first ~15-minute sync, with status synced from Snap (Active, Inactive, or Error). The page shows status badges, per-type event counts, and source domains.

How do I use a Snap Pixel in a campaign?

In Campaign Creator, pick your ad account and select the Sales or Leads objective — a Snap Pixel field appears where you pick from imported pixels, then choose the conversion event (PURCHASE, SIGN_UP, etc.). Snap then optimizes delivery toward users likely to fire that event. Without a configured pixel and event, Snap conversion campaigns cannot launch.

Why is my Snap Pixel showing Inactive in Wevion?

Usually the pixel isn't installed correctly or isn't firing — use Snap Pixel Helper to debug. If the pixel is Active in Snap Ads Manager but Inactive in Wevion, it's typically the 15-minute sync lag; refresh after a cycle and contact support if it persists. Inactive means no events received in the last 7 days.