Skip to main content
Facebook Ads

Facebook Pixel Events: The Complete Setup and Mapping Guide

Standard events, custom events, parameters, and the AEM priority mapping that maximizes attribution. Plus a debugging checklist for when something breaks.

Vince Servidad
Vince Servidad
Performance Marketing Consultant
11 min read
Share:

The Facebook Pixel has 17 standard events. Most stores use 5. Most operators don't know which ones to optimize for, what parameters matter, or how AEM priority changes performance.

Here's the complete guide.

TL;DR

The 8 events every Shopify store should fire:

1. PageView (every page)

2. ViewContent (product page)

3. Search (search results)

4. AddToCart (after add to cart)

5. InitiateCheckout (reached checkout)

6. AddPaymentInfo (entered payment)

7. Purchase (order placed)

8. CompleteRegistration (account created)

Optional 9th: Lead (for service-business lead gen).

What standard events are

Standard events are pre-defined by Meta. They're optimized for, reportable, and built into ad account dashboards.

The full list:

  • AddPaymentInfo
  • AddToCart
  • AddToWishlist
  • CompleteRegistration
  • Contact
  • CustomizeProduct
  • Donate
  • FindLocation
  • InitiateCheckout
  • Lead
  • PageView
  • Purchase
  • Schedule
  • Search
  • StartTrial
  • SubmitApplication
  • Subscribe
  • ViewContent
  • What parameters matter

    Each event can include parameters. The most important:

    For Purchase

  • `value` (order total)
  • `currency` (PHP)
  • `content_ids` (product SKUs)
  • `content_type` ("product")
  • `num_items` (quantity)
  • For ViewContent

  • `content_ids`
  • `content_type`
  • `value` (product price)
  • `currency`
  • For AddToCart

  • `content_ids`
  • `content_type`
  • `value` (item price × quantity)
  • `currency`
  • `num_items`
  • For all events (Advanced Matching)

  • `em` (email, hashed)
  • `ph` (phone, hashed)
  • `fn` (first name, hashed)
  • `ln` (last name, hashed)
  • `ct` (city, hashed)
  • `zp` (zip code, hashed)
  • `country` (hashed)
  • `external_id` (your customer ID, hashed)
  • Higher match parameters = better attribution under iOS 14+.

    How to install (Shopify)

    1. Settings → Sales channels → Facebook & Instagram → connect.

    2. Enable Pixel in the channel.

    3. Enable Conversions API.

    4. Enable Customer Data Sharing (advanced matching).

    Shopify automatically fires all standard ecom events with proper parameters.

    How to install (custom site)

    Insert in your site's ``:

    ```html

    ```

    Then trigger events on specific actions:

    ```js

    // Product page

    fbq('track', 'ViewContent', {

    content_ids: ['SKU-123'],

    content_type: 'product',

    value: 1290.00,

    currency: 'PHP'

    });

    // Add to cart

    fbq('track', 'AddToCart', {

    content_ids: ['SKU-123'],

    content_type: 'product',

    value: 1290.00,

    currency: 'PHP',

    num_items: 1

    });

    // Purchase

    fbq('track', 'Purchase', {

    content_ids: ['SKU-123', 'SKU-456'],

    content_type: 'product',

    value: 2380.00,

    currency: 'PHP',

    num_items: 2

    });

    ```

    Custom events

    Sometimes standard events aren't enough. Custom events let you track specific actions:

    ```js

    fbq('trackCustom', 'JoinedWaitlist', {

    product_name: 'Vanilla Hair Oil',

    source: 'productpage'

    });

    ```

    Custom events:

  • Show in Events Manager.
  • Can be optimized for (with caveats — fewer signals than standard).
  • Can be used to build audiences.
  • When to use:

  • Specific high-intent actions standard events don't cover.
  • Funnel-stage tracking (e.g., "ScrolledToReview", "WatchedFullVideo").
  • AEM priority mapping

    Aggregated Event Measurement caps you at 8 events. Order matters.

    Recommended for ecom:

    1. Purchase (highest priority)

    2. InitiateCheckout

    3. AddToCart

    4. ViewContent

    5. AddPaymentInfo

    6. Lead (if you do lead gen too)

    7. CompleteRegistration

    8. Subscribe

    Why order matters: Meta optimizes campaigns toward the highest-priority event that fired during a user's session.

    If you set Purchase as #1 and ViewContent as #4, a campaign optimizing for Purchase will use Purchase if available, else fall back.

    If you set ViewContent as #1, your campaigns can never optimize for Purchase properly.

    Value optimization

    Toggle on for Purchase event in AEM.

    Lets Meta bid based on customer value, not just count. A campaign with Value Optimization will favor:

  • High-AOV customers.
  • High-LTV customers (when CAPI passes long-term value back).
  • Without VO, every purchase counts equally. ₱500 order = ₱5,000 order = same in Meta's eyes.

    Testing your events

    Tools:

    1. Meta Pixel Helper (Chrome extension)

    Install. Visit your site. Helper shows which events fired.

    For each event, check:

  • Pixel ID matches.
  • Event name correct.
  • Parameters present (value, currency, content_ids).
  • No errors.
  • 2. Test Events tab in Events Manager

    Events Manager → your Pixel → Test Events.

    Add your test browser/device. Browse your site. Events appear in real-time.

    3. Diagnostics tab

    Events Manager → Diagnostics. Shows any events with quality issues, missing parameters, or duplicates.

    Common problems

    Duplicate events

    Pixel + CAPI can fire the same event twice if not properly deduplicated.

    Fix: ensure event_id is consistent across browser and server. Meta auto-deduplicates if event_id matches.

    Missing currency

    Without `currency`, value tracking breaks. Always include.

    Wrong content_ids

    If your Pixel `content_ids` doesn't match your Catalog SKUs, dynamic product ads (DPA) break.

    Fix: use consistent SKU format across Pixel and Catalog.

    Pixel firing on every page (PageView only)

    If only PageView fires, your custom events aren't installed correctly. Check theme integration.

    Custom Conversions

    Built from existing events with conditions:

  • Event = ViewContent
  • URL contains "/collections/skincare"
  • → "Skincare browser"

    You can optimize and build audiences off Custom Conversions.

    When to use:

  • Niche product categories within a larger store.
  • Specific funnel stages.
  • Server-side via CAPI

    Always pair browser Pixel with CAPI. CAPI:

  • Bypasses iOS 14+ tracking restrictions.
  • Survives ad blockers.
  • Can include more parameters.
  • See iOS 14+ Facebook Ads Strategy for full setup.

    What to do this week

    1. Install Pixel via Shopify Facebook channel.

    2. Enable CAPI.

    3. Verify all 8 events fire (Pixel Helper).

    4. Configure AEM with 8 events in priority order.

    5. Enable Value Optimization on Purchase.

    6. Enable Customer Data Sharing.

    Most stores miss 1–2 of these. Closing those gaps lifts reported ROAS 15–30%.

    Want help auditing your Pixel?

    A poorly configured Pixel costs 25%+ of attribution. My Facebook Ads Specialist service includes full tracking audits. Or learn the system in the Facebook Ads Course Philippines.

    Related reading:

  • Meta Ads Conversion Tracking & CAPI Guide
  • iOS 14+ Facebook Ads Strategy
  • E-commerce Tracking Setup Guide
  • Vince Servidad

    Written by Vince Servidad

    I've spent over $26M on ads and built my own 7-figure brand from scratch. I don't just 'manage ads'—I build the growth systems that actually scale businesses profitably.

    Want More Marketing Insights?

    Get weekly tips, strategies, and case studies delivered to your inbox.

    Need help with Facebook Ads?

    Get hands-on support from a performance marketing consultant based in the Philippines.

    Related Articles