Meta Ads Integration

Overview

Meta (Facebook/Instagram) is the dominant paid social channel for ecommerce, but reliable attribution requires pairing the browser-based Meta Pixel with server-side Conversions API (CAPI). Post-iOS 14, browser signals alone under-report 30–60% of conversions; CAPI restores signal fidelity by sending purchase events directly from your server. For Shopify, WooCommerce, and BigCommerce, official integrations handle both Pixel and CAPI automatically — no custom code required. Custom code only belongs in the Custom/Headless section.

When to Use This Skill

When setting up Meta advertising for a new ecommerce store
When conversion data in Ads Manager looks under-reported after iOS 14 rollout
When launching Dynamic Product Ads (DPA) and needing catalog feed sync
When ROAS is declining and you need to restore the signal quality Meta's algorithm relies on
When adding retargeting audiences based on product viewers and add-to-cart events

Core Instructions

Step 1: Choose your integration approach

| Platform | Recommended Method | CAPI Support | Catalog Sync | |----------|--------------------|-------------|-------------| | Shopify | Native Meta Sales Channel | Yes (built-in) | Yes (automatic) | | WooCommerce | Facebook for WooCommerce plugin | Yes (built-in) | Yes (automatic) | | BigCommerce | Meta channel in Channel Manager | Yes (built-in) | Yes (automatic) | | Custom / Headless | Meta Pixel + facebook-nodejs-business-sdk | Manual CAPI implementation | Manual feed generation |

All three major platforms have official Meta integrations that install both the Pixel and CAPI in a single setup — use these rather than manually pasting Pixel code.

Step 2: Connect your platform to Meta

Shopify

Go to Shopify Admin → Sales Channels → + → Facebook & Instagram
Install the Facebook & Instagram sales channel
Connect your Meta Business Manager account and select your Facebook Page and Ad Account
Under Data Sharing, select Maximum — this enables server-side CAPI in addition to the browser Pixel
Shopify automatically:
- Installs the Meta Pixel on all pages
- Fires ViewContent, AddToCart, InitiateCheckout, and Purchase events
- Sends the same events via CAPI from Shopify's servers (deduplication handled automatically)
- Syncs your product catalog to Meta Commerce Manager for Dynamic Product Ads
Go to Facebook & Instagram → Overview to verify pixel connection status
In Meta Events Manager → Data Sources → [Your Pixel]: check Event Match Quality (EMQ) score — aim for 7+/10

WooCommerce

Install Facebook for WooCommerce (free, official Meta plugin) from the WordPress plugin directory
Go to WooCommerce → Facebook → Get Started and connect your Meta Business Manager account
Under Facebook Connection → Data Sharing Level: select Maximum
The plugin installs the Meta Pixel across all pages and fires standard events automatically
CAPI is enabled automatically under the Maximum data sharing setting
Go to WooCommerce → Facebook → Product Sync to trigger an initial product catalog sync to Meta Commerce Manager
Verify catalog sync status in Meta Commerce Manager → Catalog → Data Sources

BigCommerce

Go to BigCommerce Admin → Channel Manager → Add a Channel
Select Facebook & Instagram
Connect your Meta Business Manager account
Enable Enhanced Conversions (CAPI) during setup
BigCommerce syncs your product catalog automatically and registers it in Meta Commerce Manager for Dynamic Product Ads
Check product sync status in Channel Manager → Facebook & Instagram → Products

Custom / Headless

For headless stores, you must install both the browser Pixel and server-side CAPI manually.

Browser-side Pixel (add to <head> on every page):

// Replace YOUR_PIXEL_ID with your Pixel ID from Meta Events Manager
fbq('init', 'YOUR_PIXEL_ID');
fbq('track', 'PageView');

// Product page
fbq('track', 'ViewContent', {
  content_ids: [product.sku],
  content_type: 'product',
  value: product.price,
  currency: 'USD',
});

// Purchase — pass eventID for deduplication with CAPI
const purchaseEventId = `purchase-${orderId}`;
fbq('track', 'Purchase', {
  content_ids: order.lineItems.map(i => i.sku),
  value: order.subtotal,
  currency: order.currencyCode,
  order_id: order.id,
}, { eventID: purchaseEventId });

Server-side CAPI (send from your order webhook):

import { FacebookAdsApi, ServerEvent, UserData, CustomData, EventRequest } from 'facebook-nodejs-business-sdk';

FacebookAdsApi.init(process.env.META_CAPI_ACCESS_TOKEN!);

async function trackPurchaseCapi(order: Order, req: Request) {
  const eventId = `purchase-${order.id}`; // MUST match the eventID passed to fbq()

  const userData = new UserData()
    .setEmail(order.customerEmail)    // SDK hashes PII automatically (SHA-256)
    .setPhone(order.customerPhone)
    .setFirstName(order.customerFirstName)
    .setLastName(order.customerLastName)
    .setZip(order.shippingAddress?.zip)
    .setCountry(order.shippingAddress?.countryCode)
    .setClientIpAddress(req.ip)
    .setClientUserAgent(req.headers['user-agent'] as string)
    .setFbp(req.cookies['_fbp'])   // _fbp cookie = browser identity signal
    .setFbc(req.cookies['_fbc']);  // _fbc cookie = click identity signal

  const customData = new CustomData()
    .setValue(order.subtotal)
    .setCurrency(order.currencyCode)
    .setContentIds(order.lineItems.map(i => i.sku))
    .setContentType('product')
    .setNumItems(order.lineItems.length)
    .setOrderId(order.id);

  const event = new ServerEvent()
    .setEventName('Purchase')
    .setEventId(eventId)
    .setEventTime(Math.floor(Date.now() / 1000))
    .setUserData(userData)
    .setCustomData(customData)
    .setActionSource('website');

  await new EventRequest(process.env.META_CAPI_ACCESS_TOKEN!, process.env.META_PIXEL_ID!)
    .setEvents([event])
    .execute();
}

Product Catalog Feed for Dynamic Product Ads: Generate a CSV feed and serve it at a stable URL. Register it in Meta Commerce Manager → Catalog → Data Sources → Add Data Feed.

// Generate CSV with required columns: id, title, description, availability, condition, price, link, image_link, brand
// Schedule regeneration every 4 hours — serve at a stable /feeds/meta-catalog.csv endpoint

Step 3: Campaign structure for ecommerce

Build a three-tier campaign structure in Meta Ads Manager:

Campaign 1: Prospecting

Objective: Sales → Purchases
Budget: 60% of total Meta budget
Audience: Broad (US 18–65, no interest targeting) — use Advantage+ targeting
Ads: 3–5 creatives (static image, video, carousel, UGC)
Use Advantage+ Shopping Campaigns (ASC) — Meta's automated format consistently outperforms manual campaign structures for ecommerce

Campaign 2: Retargeting

Budget: 30% of total Meta budget
Ad Set 1: Viewed product but did not add to cart (last 7 days)
- Audience: Website custom audience → ViewContent event, last 7 days
- Ads: Dynamic Product Ads (DPA) carousel showing viewed products
Ad Set 2: Added to cart but did not purchase (last 3 days)
- Audience: Website custom audience → AddToCart, last 3 days; exclude Purchases last 3 days
- Ads: DPA + urgency messaging

Campaign 3: Retention / LTV

Budget: 10% of total Meta budget
Ad Set: Customer list audience (upload from Shopify → Customers export)
- Exclude customers who purchased in the last 30 days
- Ads: New arrivals, cross-sell products
Ad Set: 1% Lookalike of top purchasers (great for prospecting)

Step 4: Set up Dynamic Product Ads

For Shopify and WooCommerce, the official integrations auto-sync the product catalog. Verify setup:

Go to Meta Commerce Manager → Catalogs → [Your Catalog]
Check Data Sources — confirm your platform's feed is syncing and last updated within 24 hours
Check Items — verify products show correct prices, availability, and images
In Ads Manager → Create Ad Set: select your catalog under Catalog Sales campaign objective
Choose Dynamic formats and creatives — Meta automatically selects the best ad format per user

Step 5: Verify Event Match Quality

In Meta Events Manager → Data Sources → [Your Pixel] → Overview:

| Signal | How to Improve | |--------|---------------| | EMQ below 6 | Send more user data (email, phone, fbp/fbc cookies) | | CAPI not firing | Check platform integration is set to Maximum data sharing | | Duplicate conversions | Verify deduplication — eventID must match between Pixel and CAPI | | ViewContent not firing | Check the platform integration is active and pixel is on product pages |

Best Practices

Use Advantage+ Shopping Campaigns (ASC) for prospecting — Meta's automated campaign type consistently outperforms manual structure for ecommerce; start here, not manual campaigns
Set data sharing to Maximum on Shopify/WooCommerce — this single setting enables CAPI and is worth significantly more accurate attribution than the default
Pass _fbp and _fbc cookies in CAPI — these are the strongest identity signals for iOS 14+ attribution; include them in every CAPI event
Use order_id as the deduplication key — prevents duplicate conversion counting when both Pixel and CAPI fire for the same purchase
Exclude recent purchasers from prospecting — add a 30-day purchaser exclusion to cold campaigns to protect budget
Refresh creative every 4–6 weeks — Meta campaigns show creative fatigue quickly; rotate 3–5 variations per ad set

Common Pitfalls

| Problem | Solution | |---------|----------| | Duplicate purchase conversions in Ads Manager | Ensure eventID is identical in both Pixel and CAPI calls for the same event; Shopify's native integration handles this automatically | | Conversions under-reported after iOS 14 | Set data sharing to Maximum in the Shopify Facebook channel settings or enable CAPI in WooCommerce Facebook plugin | | Dynamic Product Ads show wrong price | Shopify/WooCommerce catalog syncs happen up to every 24 hours; for time-sensitive price changes, trigger a manual sync | | Low EMQ score despite native integration | Go to Meta Events Manager → check that both browser and server events are showing; verify the integration is fully authorized | | iOS 14+ campaign reach is low | Go to Meta Business Manager → Brand Safety → Domains → Verify your domain; enable Aggregated Event Measurement | | Ad account disabled | Never send raw (unhashed) PII through the API; use the official SDK which hashes all data automatically |

Related Skills

@google-ads-ecommerce
@tiktok-ads-integration
@google-shopping-feed
@email-marketing-automation
@marketing-attribution-dashboard

Meta Ads Integration

Overview

When to Use This Skill

When setting up Meta advertising for a new ecommerce store
When conversion data in Ads Manager looks under-reported after iOS 14 rollout
When launching Dynamic Product Ads (DPA) and needing catalog feed sync
When ROAS is declining and you need to restore the signal quality Meta's algorithm relies on
When adding retargeting audiences based on product viewers and add-to-cart events

Core Instructions

Step 1: Choose your integration approach

All three major platforms have official Meta integrations that install both the Pixel and CAPI in a single setup — use these rather than manually pasting Pixel code.

Step 2: Connect your platform to Meta

Shopify

Go to Shopify Admin → Sales Channels → + → Facebook & Instagram
Install the Facebook & Instagram sales channel
Connect your Meta Business Manager account and select your Facebook Page and Ad Account
Under Data Sharing, select Maximum — this enables server-side CAPI in addition to the browser Pixel
Shopify automatically:
- Installs the Meta Pixel on all pages
- Fires ViewContent, AddToCart, InitiateCheckout, and Purchase events
- Sends the same events via CAPI from Shopify's servers (deduplication handled automatically)
- Syncs your product catalog to Meta Commerce Manager for Dynamic Product Ads
Go to Facebook & Instagram → Overview to verify pixel connection status
In Meta Events Manager → Data Sources → [Your Pixel]: check Event Match Quality (EMQ) score — aim for 7+/10

WooCommerce

Install Facebook for WooCommerce (free, official Meta plugin) from the WordPress plugin directory
Go to WooCommerce → Facebook → Get Started and connect your Meta Business Manager account
Under Facebook Connection → Data Sharing Level: select Maximum
The plugin installs the Meta Pixel across all pages and fires standard events automatically
CAPI is enabled automatically under the Maximum data sharing setting
Go to WooCommerce → Facebook → Product Sync to trigger an initial product catalog sync to Meta Commerce Manager
Verify catalog sync status in Meta Commerce Manager → Catalog → Data Sources

BigCommerce

Go to BigCommerce Admin → Channel Manager → Add a Channel
Select Facebook & Instagram
Connect your Meta Business Manager account
Enable Enhanced Conversions (CAPI) during setup
BigCommerce syncs your product catalog automatically and registers it in Meta Commerce Manager for Dynamic Product Ads
Check product sync status in Channel Manager → Facebook & Instagram → Products

Custom / Headless

For headless stores, you must install both the browser Pixel and server-side CAPI manually.

Browser-side Pixel (add to <head> on every page):

// Replace YOUR_PIXEL_ID with your Pixel ID from Meta Events Manager
fbq('init', 'YOUR_PIXEL_ID');
fbq('track', 'PageView');

// Product page
fbq('track', 'ViewContent', {
  content_ids: [product.sku],
  content_type: 'product',
  value: product.price,
  currency: 'USD',
});

// Purchase — pass eventID for deduplication with CAPI
const purchaseEventId = `purchase-${orderId}`;
fbq('track', 'Purchase', {
  content_ids: order.lineItems.map(i => i.sku),
  value: order.subtotal,
  currency: order.currencyCode,
  order_id: order.id,
}, { eventID: purchaseEventId });

Server-side CAPI (send from your order webhook):

import { FacebookAdsApi, ServerEvent, UserData, CustomData, EventRequest } from 'facebook-nodejs-business-sdk';

FacebookAdsApi.init(process.env.META_CAPI_ACCESS_TOKEN!);

async function trackPurchaseCapi(order: Order, req: Request) {
  const eventId = `purchase-${order.id}`; // MUST match the eventID passed to fbq()

  const userData = new UserData()
    .setEmail(order.customerEmail)    // SDK hashes PII automatically (SHA-256)
    .setPhone(order.customerPhone)
    .setFirstName(order.customerFirstName)
    .setLastName(order.customerLastName)
    .setZip(order.shippingAddress?.zip)
    .setCountry(order.shippingAddress?.countryCode)
    .setClientIpAddress(req.ip)
    .setClientUserAgent(req.headers['user-agent'] as string)
    .setFbp(req.cookies['_fbp'])   // _fbp cookie = browser identity signal
    .setFbc(req.cookies['_fbc']);  // _fbc cookie = click identity signal

  const customData = new CustomData()
    .setValue(order.subtotal)
    .setCurrency(order.currencyCode)
    .setContentIds(order.lineItems.map(i => i.sku))
    .setContentType('product')
    .setNumItems(order.lineItems.length)
    .setOrderId(order.id);

  const event = new ServerEvent()
    .setEventName('Purchase')
    .setEventId(eventId)
    .setEventTime(Math.floor(Date.now() / 1000))
    .setUserData(userData)
    .setCustomData(customData)
    .setActionSource('website');

  await new EventRequest(process.env.META_CAPI_ACCESS_TOKEN!, process.env.META_PIXEL_ID!)
    .setEvents([event])
    .execute();
}

Product Catalog Feed for Dynamic Product Ads: Generate a CSV feed and serve it at a stable URL. Register it in Meta Commerce Manager → Catalog → Data Sources → Add Data Feed.

// Generate CSV with required columns: id, title, description, availability, condition, price, link, image_link, brand
// Schedule regeneration every 4 hours — serve at a stable /feeds/meta-catalog.csv endpoint

Step 3: Campaign structure for ecommerce

Build a three-tier campaign structure in Meta Ads Manager:

Campaign 1: Prospecting

Objective: Sales → Purchases
Budget: 60% of total Meta budget
Audience: Broad (US 18–65, no interest targeting) — use Advantage+ targeting
Ads: 3–5 creatives (static image, video, carousel, UGC)
Use Advantage+ Shopping Campaigns (ASC) — Meta's automated format consistently outperforms manual campaign structures for ecommerce

Campaign 2: Retargeting

Budget: 30% of total Meta budget
Ad Set 1: Viewed product but did not add to cart (last 7 days)
- Audience: Website custom audience → ViewContent event, last 7 days
- Ads: Dynamic Product Ads (DPA) carousel showing viewed products
Ad Set 2: Added to cart but did not purchase (last 3 days)
- Audience: Website custom audience → AddToCart, last 3 days; exclude Purchases last 3 days
- Ads: DPA + urgency messaging

Campaign 3: Retention / LTV

Budget: 10% of total Meta budget
Ad Set: Customer list audience (upload from Shopify → Customers export)
- Exclude customers who purchased in the last 30 days
- Ads: New arrivals, cross-sell products
Ad Set: 1% Lookalike of top purchasers (great for prospecting)

Step 4: Set up Dynamic Product Ads

For Shopify and WooCommerce, the official integrations auto-sync the product catalog. Verify setup:

Go to Meta Commerce Manager → Catalogs → [Your Catalog]
Check Data Sources — confirm your platform's feed is syncing and last updated within 24 hours
Check Items — verify products show correct prices, availability, and images
In Ads Manager → Create Ad Set: select your catalog under Catalog Sales campaign objective
Choose Dynamic formats and creatives — Meta automatically selects the best ad format per user

Step 5: Verify Event Match Quality

In Meta Events Manager → Data Sources → [Your Pixel] → Overview:

Best Practices

Use Advantage+ Shopping Campaigns (ASC) for prospecting — Meta's automated campaign type consistently outperforms manual structure for ecommerce; start here, not manual campaigns
Set data sharing to Maximum on Shopify/WooCommerce — this single setting enables CAPI and is worth significantly more accurate attribution than the default
Pass _fbp and _fbc cookies in CAPI — these are the strongest identity signals for iOS 14+ attribution; include them in every CAPI event
Use order_id as the deduplication key — prevents duplicate conversion counting when both Pixel and CAPI fire for the same purchase
Exclude recent purchasers from prospecting — add a 30-day purchaser exclusion to cold campaigns to protect budget
Refresh creative every 4–6 weeks — Meta campaigns show creative fatigue quickly; rotate 3–5 variations per ad set

Common Pitfalls

Related Skills

@google-ads-ecommerce
@tiktok-ads-integration
@google-shopping-feed
@email-marketing-automation
@marketing-attribution-dashboard

Adoption

finsilabs/meta-ads-integration

$ install --global

Security Scan Results

SKILL.md

Meta Ads Integration

Overview

When to Use This Skill

Core Instructions

Step 1: Choose your integration approach

Step 2: Connect your platform to Meta

Shopify

WooCommerce

BigCommerce

Custom / Headless

Step 3: Campaign structure for ecommerce

Step 4: Set up Dynamic Product Ads

Step 5: Verify Event Match Quality

Best Practices

Common Pitfalls

Related Skills

Related Skills

finsilabs/wishlist-save-for-later

finsilabs/storefront-theming

finsilabs/search-autocomplete

finsilabs/responsive-storefront

finsilabs/meta-ads-integration

$ install --global

Security Scan Results

SKILL.md

Meta Ads Integration

Overview

When to Use This Skill

Core Instructions

Step 1: Choose your integration approach

Step 2: Connect your platform to Meta

Shopify

WooCommerce

BigCommerce

Custom / Headless

Step 3: Campaign structure for ecommerce

Step 4: Set up Dynamic Product Ads

Step 5: Verify Event Match Quality

Best Practices

Common Pitfalls

Related Skills

Related Skills

finsilabs/wishlist-save-for-later

finsilabs/storefront-theming

finsilabs/search-autocomplete

finsilabs/responsive-storefront