API Reference

πŸ“Š Analytics Pixels Integration Guide

This guide covers how to configure and use all available analytics pixels on the Web2Wave platform, including event mappings, data transmission, and testing recommendations.

🎯 Available Analytics Pixels

The platform supports the following analytics and advertising pixels:

  • Facebook Pixel (Meta Pixel) - For Facebook/Instagram advertising
  • TikTok Pixel - For TikTok advertising campaigns
  • Snapchat Pixel - For Snapchat advertising
  • Pinterest Tag - For Pinterest advertising
  • AppLovin AXON - For mobile advertising attribution
  • Google Analytics & Google Ads - For web analytics and Google advertising

General Setup Process

  1. Navigate to Project Settings β†’ Analytics Tab
  2. Enable the desired pixel by checking the checkbox
  3. Configure required fields (Pixel ID, Access Tokens, etc.)
  4. Test configuration using the "Check token" buttons where available
  5. Save settings - The pixel will automatically load on your pages

Configuration Fields by Platform

PlatformRequired FieldsOptional FieldsServer Events
FacebookPixel ID & Access TokenTest Event Code & Server Events Onlyβœ… Full Support
TikTokPixel ID & Access TokenServer Events Onlyβœ… Full Support
SnapchatPixel IDNone❌ Browser Only
PinterestTag IDNone❌ Browser Only
AppLovinEvent KeyNone❌ Browser Only
GoogleAnalytics ID & Tag Manager IDAdWords Tag ID❌ Browser Only

Note: Snapchat and Pinterest currently support browser tracking only. Server-side event fields are commented out in the current implementation.


πŸ“ˆ Event Mappings by Platform


Facebook Pixel Events

Internal EventFacebook EventEvent Type
PurchasePurchaseStandard
SubscribeSubscribeStandard
InitiateCheckoutInitiateCheckoutStandard
CompleteRegistrationCompleteRegistrationStandard
AddPaymentInfoAddPaymentInfoStandard
StartTrialStartTrialStandard
PageViewViewContentStandard
Paywall Prices visibleViewContentStandard
Paywall click priceViewContentStandard
Other eventsCustom EventsCustom

Special Features:

  • βœ… Enhanced matching with hashed email and user_id (SHA-256)
  • βœ… Event deduplication using eventID
  • βœ… Facebook Click ID (fbclid) and Browser ID (fbp) tracking
  • βœ… Automatic cookie management (_fbc, _fbp)

TikTok Pixel Events

Internal EventTikTok EventNotes
PurchasePurchaseWith transaction data
SubscribeSubscribeWith subscription data
InitiateCheckoutInitiateCheckoutWith cart data
CompleteRegistrationCompleteRegistrationUser signup
AddPaymentInfoAddPaymentInfoPayment info added
StartTrialStartTrialTrial started
PageViewViewContentPage view
All eventsForwardedAll events sent

Special Features:

  • βœ… Enhanced matching with email and external_id
  • βœ… TikTok Click ID (ttclid) tracking
  • βœ… Full event forwarding with currency/value data

Snapchat Pixel Events

Internal EventSnapchat EventNotes
PurchasePURCHASEWith price/currency
SubscribePURCHASESubscription purchase
InitiateCheckoutSTART_CHECKOUTCheckout initiated
CompleteRegistrationSIGN_UPUser registration
AddPaymentInfoADD_BILLINGPayment info
StartTrialPURCHASETrial signup
PageViewPAGE_VIEWPage view
Paywall Prices visibleVIEW_CONTENTContent view
AddToCartADD_TO_CARTCart addition
SearchSEARCHSearch performed

Special Features:

  • βœ… Client deduplication ID (client_dedup_id) prevents duplicate events
  • βœ… Snapchat Click ID (sccid, ScCid) tracking
  • βœ… Enhanced user matching with email
  • βœ… Only sends mapped standard events (filters irrelevant events)

Pinterest Tag Events

Internal EventPinterest EventNotes
PurchasecheckoutWith transaction data
SubscribesignupUser signup
InitiateCheckoutaddtocartCheckout process
CompleteRegistrationsignupUser registration
AddPaymentInfoaddtocartPayment process
StartTrialcheckoutTrial conversion
PageViewpagevisitPage view
Paywall Prices visibleviewcategoryCategory view
AddToCartaddtocartCart addition
SearchsearchSearch performed

Special Features:

  • βœ… Enhanced match with email and external_id
  • βœ… Pinterest Click ID (pinclid) tracking
  • βœ… Automatic email hashing for privacy
  • βœ… Cross-device checkout tracking

AppLovin AXON Events

Internal EventAXON EventCategory
PurchasepurchaseRequired
SubscribepurchaseRequired
InitiateCheckoutbegin_checkoutRequired
CompleteRegistrationsign_upRecommended
AddPaymentInfoadd_payment_infoRecommended
PageViewpage_viewRequired
Paywall Prices visibleview_itemRequired
AddToCartadd_to_cartRequired
SearchsearchRecommended

Special Features:

  • βœ… Rich ecommerce data with items array
  • βœ… Product categorization (item_category_id: 317)
  • βœ… Automatic additional events (land on page_view, add_to_cart on checkout)
  • βœ… Mobile-optimized attribution

Google Analytics Events

Internal EventGoogle EventNotes
PurchasepurchaseEnhanced ecommerce
SubscribeconversionGoal conversion
InitiateCheckoutbegin_checkoutEcommerce funnel
CompleteRegistrationsign_upUser action
AddPaymentInfoadd_payment_infoCheckout step
PageViewpage_viewStandard tracking
Paywall Prices visibleview_itemProduct view

Special Features:

  • βœ… Enhanced ecommerce tracking
  • βœ… Multiple tag support (Analytics + Tag Manager + Ads)
  • βœ… Data Layer and gtag support
  • βœ… Custom send_to targeting

    πŸ“Š Data Transmitted with Events


Facebook Pixel

{
    eventID: "user123_Purchase", // Deduplication
    fbc: "fb.1.1703123456000.abc123", // Facebook Click ID
    fbp: "fb.1.1703123456000.xyz789", // Facebook Browser ID
    external_id: "hashed_user_id", // SHA-256 hashed
    em: "hashed_email" // SHA-256 hashed email
}

TikTok Pixel

{
    external_id: "user_123",
    email: "[email protected]",
    // Full event properties forwarded
}

Snapchat Pixel

{
    client_dedup_id: "user123_Purchase", // Deduplication
    user_id: "user_123",
    user_email: "[email protected]",
    price: 29.99,
    currency: "USD",
    transaction_id: "subscription_123"
}

Pinterest Tag

{
    external_id: "user_123",
    em: "[email protected]", // Auto-hashed
    value: 29.99,
    currency: "USD",
    order_id: "subscription_123"
}

AppLovin AXON

{
    items: [{
        item_id: "price_123",
        item_name: "Subscription",
        quantity: 1,
        price: 29.99,
        currency: "USD",
        item_category_id: 317
    }],
    value: 29.99,
    currency: "USD",
    transaction_id: "subscription_123"
}



πŸ” Testing Pixels with Browser Extensions


Facebook Pixel Helper

TikTok Pixel Helper


Snapchat Pixel Helper


Pinterest Tag Helper


Google Tag Assistant


Generic Analytics Debuggers