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 Event	Snapchat Event
Pageview	PAGE_VIEW
View Content	VIEW_CONTENT
Search	SEARCH
Add to Cart	ADD_CART
Add to Wishlist	ADD_TO_WISHLIST
Initiate Checkout	START_CHECKOUT
Add Payment Info	ADD_BILLING
Purchase	PURCHASE
Lead	SIGN_UP
Sign Up	SIGN_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: 'customer@example.com',
    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 Points	Expected Match Rate
Email only	40-60%
Email + Phone	50-70%
Email + Phone + External ID	60-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.