IntegrationsAdvertisingSnapchat Ads

Snapchat Ads

Datafly Signal delivers conversion events to Snapchat server-to-server, replacing the client-side Snap Pixel with lightweight server-side delivery. This provides reliable campaign attribution and ad performance measurement without loading vendor JavaScript.

Prerequisites

Before configuring Snapchat Ads in Signal, you need a Snapchat Business account with a Snap Pixel created and an API key generated.

Create a Snapchat Business Account

  1. Go to business.snapchat.com and click Create Account.
  2. Enter your business name, email, and business details.
  3. Complete the account setup and verify your email address.

Create a Snap Pixel

  1. In Snapchat Ads Manager, navigate to Events Manager in the left sidebar.
  2. Click New Event Source > Snap Pixel.
  3. Name your Pixel (e.g. “Website Pixel”) and click Create.
  4. Note the Pixel ID — a UUID format string (e.g. abc123de-f456-7890-gh12-ijkl34567890).

You do not need to install the Snap Pixel JavaScript snippet on your website. Signal replaces the client-side tag with server-side delivery.

Generate an API Key

  1. In Snapchat Ads Manager, go to Business Settings > API Access (or navigate to business.snapchat.com/ad-accounts).
  2. Click Generate API Key for server-side event delivery.
  3. Copy the API Key immediately — it may only be shown once.
⚠️

Store the API key securely. If you lose it, you will need to generate a new one.

Configure in Signal

Now that you have your Pixel ID and API key, configure the integration in Signal.

Configuration Fields

FieldRequiredDescription
pixel_idYesYour Snap Pixel ID (UUID format). Found in Snapchat Ads Manager under Events Manager.
api_keyYesAPI key for server-side event delivery. Generated in Snapchat Business Manager under API Access.

Vendor Click IDs

Signal automatically captures the following Snapchat click identifiers from URL parameters:

Vendor IDParameterDescription
sccidsccidSnapchat click ID. Used for click-through attribution.
scidscidSnapchat campaign ID. Used for campaign-level attribution.

These are captured automatically by the Datafly.js collector and forwarded with conversion events.

Management UI Setup

  1. Go to Integrations > Add Integration > Snapchat Ads.
  2. Enter your pixel_id and api_key.
  3. Select consent categories (typically advertising).
  4. Click Save.

Management API Setup

curl -X POST http://localhost:8084/v1/admin/integrations \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source_id": "src_abc123",
    "vendor": "snapchat_ads",
    "name": "Snapchat Ads Production",
    "enabled": true,
    "config": {
      "pixel_id": "abc123de-f456-7890-gh12-ijkl34567890",
      "api_key": "ak_snap_abc123..."
    },
    "consent_categories": ["advertising"]
  }'

Event Mapping

Datafly EventSnapchat EventNotes
page (page view)PAGE_VIEWSent for every page view
Order CompletedPURCHASERequires price, currency, transaction_id
Product AddedADD_CARTIncludes item_ids, price
Checkout StartedSTART_CHECKOUTIncludes price, currency
Product ViewedVIEW_CONTENTIncludes item_ids, content_type
Lead GeneratedSIGN_UPLead form submission
Signed UpSIGN_UPUser registration
Products SearchedSEARCHIncludes search_string
Product Added to WishlistADD_TO_WISHLISTIncludes item_ids
Custom eventsCUSTOM_EVENT_1 – CUSTOM_EVENT_5Mapped to Snapchat custom event slots

Identity Signals

Automatic Signals

These are sent automatically by Signal — no configuration needed:

SignalDescription
sccidSnapchat click ID, captured from URL parameters.
scidSnapchat campaign ID, captured from URL parameters.
IP addressVisitor’s IP address, forwarded from the original request.
User agentVisitor’s User-Agent string, forwarded from the original request.

User-Provided Signals

When a user is identified via _df.identify(), additional signals improve match quality:

SignalDescription
Email (hashed)User’s email address, SHA-256 hashed before sending.
Phone (hashed)User’s phone number, SHA-256 hashed before sending.

All PII hashing is performed server-side by the Delivery Worker before the data leaves your infrastructure.

Testing Your Integration

Step 1: Send a Test Event

  1. Trigger a page view or conversion event on your website.
  2. Check the Signal event debugger in the Management UI to confirm the event was captured and delivered.

Step 2: Verify in Snapchat Events Manager

  1. In Snapchat Ads Manager, go to Events Manager > your Pixel.
  2. Click on the Overview tab to see received events.
  3. Events should appear within a few minutes.

Step 3: Validate Attribution

  1. Create a test campaign with a small audience.
  2. Confirm that conversion events are attributed correctly in campaign reports.
  3. Check that sccid click IDs are being matched for click-through attribution.

Troubleshooting

ProblemSolution
Events not appearing in SnapchatVerify the pixel_id and api_key are correct. Check that the API key has not been revoked.
Authentication errorsRegenerate the API key in Snapchat Business Manager and update the integration config in Signal.
Missing sccid or scidThese are captured from URL parameters when users click Snapchat ads. They will not be present for organic traffic.
Low match rateAdd user identity signals (email, phone) via _df.identify() when users log in or submit forms.
Events delayedSnapchat may take up to 15 minutes to display server-side events. Allow time before investigating further.
Custom events not mappingSnapchat supports up to 5 custom event slots (CUSTOM_EVENT_1 through CUSTOM_EVENT_5). Ensure your events are mapped to available slots.

Visit Snapchat Ads documentation for full API documentation and credential setup instructions.

RTB HouseTeads