Snapchat CAPI Integration

Send server-side events to Snapchat Ads Manager

Snapchat Conversions API Integration

Connect Anacoic to Snapchat Ads Manager to send server-side events for improved attribution and campaign performance.

Prerequisites

Before you begin:

  1. A Snapchat Ads Manager account
  2. A Snapchat Pixel (recommended for web events)
  3. API credentials for Conversions API access

Setup Instructions

Step 1: Find Your Pixel ID

  1. Log in to Snapchat Ads Manager
  2. Navigate to Events Manager
  3. Select your Pixel or create a new one
  4. Copy the Pixel ID (format: 12345-67890-12345)

Step 2: Generate an Access Token

  1. In Events Manager, go to Settings
  2. Scroll to Conversions API
  3. Click Generate Token
  4. Copy the token (long alphanumeric string)

Security: Keep this token private. It provides write access to your conversion data.

Step 3: Configure in Anacoic

  1. Go to your Gateway → Integrations tab
  2. Find Snapchat and click Connect
  3. Enter:
    • Pixel ID: From Step 1
    • Access Token: From Step 2
  4. Toggle Enable Integration on
  5. Click Save Configuration

Event Mapping

Anacoic maps standard events to Snapchat’s event taxonomy:

Anacoic EventSnapchat Event
PageviewPAGE_VIEW
View ContentVIEW_CONTENT
SearchSEARCH
Add to CartADD_CART
Add to WishlistADD_TO_WISHLIST
Initiate CheckoutSTART_CHECKOUT
Add Payment InfoADD_BILLING
PurchasePURCHASE
LeadSIGN_UP
Sign UpSIGN_UP

User Data for Better Matching

Snapchat uses multiple identifiers for user matching:

Primary (automatically hashed):

  • Email address (required for best performance)
  • Phone number (optional)
  • External ID (your user ID)

Device Data (captured automatically):

  • User agent
  • IP address

Example Event:

anacoic.track('Purchase', {
  value: 49.99,
  currency: 'USD',
  transaction_id: 'TXN-789',
  content_ids: ['SKU-123', 'SKU-456'],
  user: {
    email: '[email protected]',
    phone: '+1-555-0123',
    external_id: 'user_12345'
  }
});

E-commerce Parameters

For purchase and product-related events, include these parameters:

anacoic.track('Purchase', {
  value: 99.99,              // Total value
  currency: 'USD',           // Currency code
  transaction_id: 'ORDER-123',
  content_ids: ['SKU-1', 'SKU-2'],  // Product SKUs
  num_items: 2,              // Total quantity
  delivery_method: 'standard',  // shipping, pickup, etc.
  customer_status: 'returning'  // new or returning
});

Testing Your Integration

Using Live Logs

  1. Go to your Gateway → Live Logs
  2. Send a test event
  3. Verify “Snapchat” appears with status 200

Using Snapchat Events Manager

  1. Go to Events Manager → Test Events
  2. Trigger a conversion on your site
  3. Check for the event in the test tool
  4. Look for “Server” as the event source

Match Quality

Snapchat’s match quality depends on the data you provide:

Data PointsExpected Match Rate
Email only40-60%
Email + Phone50-70%
Email + Phone + External ID60-80%

Enable Auto-Enrichment to automatically capture user data from your platform (Shopify, WooCommerce, etc.).

Troubleshooting

Events Not Appearing

  • Check Live Logs for errors
  • Verify your Pixel ID is correct
  • Ensure the access token hasn’t expired

Low Match Rates

  • Pass email addresses with your events
  • Enable auto-enrichment for automatic user detection
  • Ensure you’re collecting phone numbers at checkout

”Invalid Token” Error

  • Generate a new access token in Events Manager
  • Tokens don’t expire but can be revoked

Data Privacy

  • All PII is SHA256 hashed before transmission
  • Snapchat complies with CCPA and GDPR
  • No raw personal data is sent to Anacoic’s servers

Best Practices

  1. Send events immediately - Don’t batch for more than a few minutes
  2. Include all identifiers - Email + Phone + External ID for best matching
  3. Test thoroughly - Use Snapchat’s test events tool
  4. Monitor match rates - Check Events Manager regularly

Support

Need help? Contact support or check the troubleshooting guide.