Skip to main content
Tutorial

Facebook / Meta Integration Guide

Last Updated: July 3, 2026

Table of Contents​

Overview​

This guide explains how to integrate your UltraCart StoreFront with Facebook and Meta services, including Meta Pixel browser tracking, Facebook Analytics and Custom Audiences, product catalog synchronization for Facebook and Instagram Shopping, Facebook Conversions API (CAPI), and Open Graph sharing metadata.

While UltraCart is not a native Meta Commerce Manager partner platform, UltraCart fully supports the core integration points required for modern Facebook and Instagram advertising, conversion tracking, catalog syndication, and retargeting workflows.

This tutorial provides step-by-step instructions for configuring each integration area using current UltraCart administrative interfaces and StoreFront capabilities. The Facebook configuration form now consolidates controls for browser pixels, server-side CAPI tokens, event opt-ins, and standard event selection.

Note: The Conversions API (CAPI) and Open Graph functionality described in this document require the StoreFront Visual Builder beta runtime as of May 2026.

Prerequisites​

Before beginning, verify the following requirements.

Facebook / Meta Requirements​

You will need:

  • A Meta Business Account

  • A Meta Business Manager account with administrator access

  • A Meta Pixel created in Meta Events Manager

  • A Meta Commerce Manager catalog

  • Your Facebook Pixel ID

  • A Conversions API Access Token (for CAPI configuration)

UltraCart Requirements​

You will need:

  • An active UltraCart account

  • At least one configured StoreFront

  • Administrative access to the UltraCart account

  • UltraCart Analytics enabled

  • A populated product catalog with product titles, descriptions, prices, and product images

Warning: Your Conversions API Access Token provides write access to your Meta conversion tracking data. Store it securely and never expose it publicly.

Part 1 — Install the Meta Pixel​

The Meta Pixel allows Facebook and Instagram to track storefront activity such as page views, product views, add-to-cart activity, checkout activity, and purchases.

UltraCart includes native Meta Pixel support through the StoreFront Privacy & Tracking settings. The current configuration form also supports multiple pixel IDs, server-side event delivery via CAPI, and granular control over standard events.

Step 1 — Locate Your Facebook Pixel ID​

  1. Log in to Meta Business Manager.

  2. Navigate to Events Manager.

  3. Select your Pixel under Data Sources.

  4. Copy the numeric Pixel ID shown at the top of the page.

Example: 1234567890123456

Step 2 — Open Privacy & Tracking Settings in UltraCart​

Navigate to:

Main Menu → StoreFronts → [StoreFront] → Privacy & Tracking → Other (Tab)

The Facebook configuration form and Facebook Analytics & Custom Audiences section may appear on this page or under Conversion and Tracking settings depending on your UltraCart version.

Step 3 — Configure Facebook Pixel and Event Settings​

image-20260703-203224.png

The Facebook section provides the following fields. Complete each relevant field and click Save.

Conversion Pixel Ids (textarea, one per line)
Enter one or more Meta Pixel IDs. Place a single ID on each line. This field supports sending events to multiple pixels when required.

Server Side Access Token (input)
Paste the Conversions API Access Token generated in Meta Events Manager. This enables server-side event delivery.

Important: This token can only be used with a single conversion pixel ID.

Override event_source_url (input, optional)
Enter a custom event source URL when your implementation requires overriding the default source URL sent with events.

Opt in to (dropdown, required for dependent field)
Select the desired opt-in option. This setting is required for the associated secondary dropdown. The exact behavior depends on the selected value and controls additional tracking or matching features.

Standard Events (checkboxes)
Select which standard Meta events UltraCart should automatically track and forward. Available events:

  • AddPaymentInfo

  • AddToCart

  • AddToWishlist

  • CompleteRegistration

  • InitiateCheckout

  • Lead

  • Search

  • ViewContent

PageView events typically fire on all page loads regardless of checkbox selection. The remaining events fire only when their corresponding checkbox is enabled and the triggering storefront action occurs.

Step 4 — Verify Pixel Tracking​

  1. Open your storefront in a browser.

  2. Open Meta Events Manager in another tab.

  3. Navigate to Events Manager → Test Events.

  4. Browse your storefront.

  5. Verify that events begin appearing.

Test the following actions:

  • View a product

  • Add an item to cart

  • Begin checkout

  • Complete a test purchase

Tip: Install the Meta Pixel Helper Chrome extension to verify Pixel activity directly in your browser.

Automatically Tracked Events​

EventDescription
PageViewFires on all storefront page loads
ViewContentFires on product detail pages
AddToCartFires when a product is added to cart
InitiateCheckoutFires when checkout begins
AddPaymentInfoFires when payment information is entered
AddToWishlistFires when a product is added to a wishlist
CompleteRegistrationFires on completion of registration or signup
LeadFires on lead form submissions
SearchFires on internal site search actions
PurchaseFires on the receipt page after checkout

Part 2 — Connect Facebook Analytics & Custom Audiences​

UltraCart Analytics can connect directly to Facebook using the Graph API to import advertising spend data, sync customer lists into Facebook Custom Audiences, and support Lookalike Audience generation.

Step 1 — Find Your Facebook Account ID​

  1. Log in to Facebook Business Manager.

  2. Navigate to Business Settings → Business Info.

  3. Locate your numeric Business Account ID.

Example: 987654321098765

Step 2 — Open Facebook Analytics Settings in UltraCart​

Navigate to:

Main Menu → StoreFronts → [StoreFront] → Conversion and Tracking → Other

image-20260703-204115.png

Scroll to the Facebook Analytics & Custom Audiences section. This section may also appear directly below the Facebook fields on the Privacy & Tracking page in current UI versions.

Step 3 — Connect Your Facebook Account​

  1. Enter the Facebook Account ID in the Account ID field.

  2. Click Connect.

  3. Authorize UltraCart within Facebook.

After authorization:

  • UltraCart downloads Facebook advertising spend data hourly.

  • UltraCart uploads customer audiences for retargeting.

Step 4 — Verify Audience Syncing​

After 24–48 hours:

  1. Open Meta Ads Manager.

  2. Navigate to Audiences.

  3. Confirm that the UltraCart audience appears.

Tip: Use your synced customer audience to generate Lookalike Audiences for prospecting campaigns.

Part 3 — Sync Your Product Catalog with Facebook​

UltraCart can automatically generate a Facebook-compatible product feed through the Google Product Search integration. This feed can then be connected directly to Meta Commerce Manager for Facebook Shop, Instagram Shopping, Dynamic Product Ads, and Catalog Ads.

Unlike a completely manual export workflow, UltraCart automatically generates and maintains the Facebook feed file once the Google Product Search integration is enabled.

Note: The generated Facebook feed file is named facebook.xml and is automatically placed in the StoreFront File Manager under the Feeds folder.

How the Facebook Feed Generation Works​

UltraCart uses the Google Product Search feed configuration as the source for both Google Product feeds and Facebook / Meta product feeds. The product-level feed configuration performed within the item editor also controls which products appear in the generated Facebook feed.

The generated Facebook feed file is facebook.xml. The file is automatically generated and updated by UltraCart after the feed integration is enabled.

Step 1 — Enable the Google Product Search Feed​

Navigate to:

Main Menu → StoreFronts → [StoreFront] → Google Product Search

This configuration area controls feed generation, feed activation, manual feed updates, and global feed settings.

After configuring the feed settings:

  1. Click Save.

  2. Click the Update Now button.

The Update Now button immediately regenerates the product feed files, including Google feed files and facebook.xml.

Tip: The Update Now button is located next to the Save button on the Google Product Search configuration page.

Step 2 — Configure Product Feed Settings Within Each Item​

Each product included in the Facebook feed should be reviewed within the item editor.

Navigate to:

Main Menu → Items → Item Editor → Google Product Search

The Google Product Search section of the item editor controls important feed data including product titles, descriptions, product categories, brand information, availability, GTIN / UPC values, MPN values, product condition, apparel attributes, and feed inclusion settings.

This information is used when generating both the Google and Facebook product feeds.

Excluding Products from the Feed​

Products that should not appear in Facebook or Google Shopping feeds can be excluded individually.

Within the item editor's Google Product Search section:

  1. Locate the Omit from feed checkbox.

  2. Enable the checkbox.

  3. Save the item.

Excluded products will not appear in generated feed files, including facebook.xml.

Common reasons to exclude products include restricted items, internal-only products, incomplete product data, products without valid images, non-shippable products, and products not intended for advertising.

Important: Products omitted from the feed will not be available for Facebook Shop, Instagram Shopping, or Dynamic Product Ads.

Step 3 — Locate the Generated Facebook Feed File​

image-20260703-203901.png

After the feed has been generated, the Facebook feed file is available within the StoreFront File Manager.

Navigate to:

Main Menu → StoreFronts → File Manager → Feeds

image-20260703-203952.png

The generated file will be facebook.xml.

This XML feed file is the file you will provide to Meta Commerce Manager.

Step 4 — Connect the Feed to Meta Commerce Manager​

  1. Open Meta Commerce Manager.

  2. Create or select a catalog.

  3. Navigate to Data Sources → Add Items.

  4. Select Data Feed.

  5. Choose Use a URL.

  6. Enter the public URL to your facebook.xml feed.

  7. Configure the refresh schedule.

  8. Complete the import.

Tip: Daily feed refreshes are recommended for most stores. High-volume stores may prefer more frequent refresh schedules.

Step 5 — Review Feed Diagnostics​

After importing the feed into Meta Commerce Manager:

  1. Review the Diagnostics section.

  2. Resolve any feed warnings or errors.

  3. Confirm products are approved.

Common issues include missing images, invalid pricing formats, missing brand data, invalid availability values, and missing GTIN or MPN values.

Important: Product image URLs must be publicly accessible. If Meta cannot access the image directly, the product may be rejected from the catalog feed.

Part 4 — Configure Facebook Conversions API (CAPI)​

The Conversions API supplements browser Pixel tracking with server-side event delivery.

Benefits include improved conversion attribution, reduced tracking loss from ad blockers, better iOS tracking reliability, and higher Event Match Quality scores.

Note: UltraCart automatically handles event deduplication between browser and server-side tracking.

Step 1 — Generate a CAPI Access Token​

  1. Open Meta Events Manager.

  2. Select your Pixel.

  3. Navigate to Settings → Conversions API.

  4. Click Generate Access Token.

  5. Copy and securely store the token.

Step 2 — Configure CAPI in UltraCart​

The Server Side Access Token is entered in the Facebook configuration form described in Part 1, Step 3.

image-20260703-204452.png

Use the Server Side Access Token field (supports a single pixel ID only). The primary Pixel ID is supplied via the Conversion Pixel Ids field on the same form.

Save the configuration after entering the token.

Step 3 — Enable the Visual Builder Beta Runtime​

Open your StoreFront settings and enable the Visual Builder beta runtime.

This runtime enables enhanced analytics collection, server-side event relay, and Open Graph tag output.

Step 4 — Verify CAPI Delivery​

  1. Open Meta Events Manager.

  2. Navigate to Test Events.

  3. Place a test order.

  4. Confirm that events display both browser source and server source.

Tip: Aim for an Event Match Quality score of 8.0 or higher.

Part 5 — Open Graph Tags for Facebook Sharing​

Open Graph (OG) tags control how product pages appear when shared on Facebook or Instagram.

UltraCart's Visual Builder beta runtime automatically outputs Open Graph metadata for supported pages.

Automatically Generated Open Graph Tags​

TagDescription
og:titleProduct or article title
og:descriptionProduct description
og:imageMain product image
og:urlCanonical page URL
og:typeproduct or article

Step 1 — Enable the Visual Builder Beta Runtime​

note8198eef6be87

Note: Open Graph support requires the Visual Builder beta runtime.
Email UltraCart Support Provide your UltraCart Merchant ID in your request.

Note: Open Graph support requires the Visual Builder beta runtime.
Email UltraCart Support Provide your UltraCart Merchant ID in your request.

Step 2 — Verify Open Graph Output​

  1. Open a product page.

  2. View the page source.

  3. Search for <meta property="og:title">.

Alternatively, use Facebook's Sharing Debugger at <https://developers.facebook.com/tools/debug/.>

Step 3 — Refresh Facebook Cache​

If Facebook displays outdated previews:

  1. Open the Sharing Debugger.

  2. Paste the product URL.

  3. Click Scrape Again.

Tip: Use high-quality images at least 1200 × 630 pixels for best share preview quality.

Troubleshooting​

Pixel Issues​

Pixel Not Firing

  • Verify the Pixel ID(s) entered in Conversion Pixel Ids are correct.

  • Remove any duplicate manual Pixel scripts from themes or content.

  • Confirm Privacy & Tracking settings were saved.

  • Verify at least one standard event checkbox is enabled for the expected action.

Purchase Events Missing

Ensure the storefront uses the UltraCart-hosted receipt page.

Product Feed Issues​

Products Rejected

Common causes:

  • Missing brand field

  • Incorrect price formatting

  • Invalid image URLs

  • Missing GTIN or MPN values

Feed Not Updating

Verify:

  • The feed URL is public

  • The file updates correctly after clicking Update Now

  • Meta can access the file

CAPI Issues​

Invalid Access Token

Generate a new token in Meta Events Manager and update the Server Side Access Token field.

Low Match Quality

Ensure customer information is collected during checkout, including email, phone, first name, and last name.

Open Graph Issues​

Incorrect Share Image

Use the Facebook Sharing Debugger and click Scrape Again.

OG Tags Missing

Confirm the StoreFront Visual Builder beta runtime is enabled.

Quick Reference​

IntegrationPurposeConfiguration Location
Meta PixelBrowser-based trackingStoreFront → Privacy & Tracking (Facebook section)
Facebook AnalyticsAd spend import and audience syncingConversion and Tracking → Other (or combined Facebook form)
Product FeedShopping ads and catalogsGoogle Product Search feed + Commerce Manager
Conversions APIServer-side conversion trackingFacebook form → Server Side Access Token
Open Graph TagsSocial sharing previewsVisual Builder beta runtime

Conclusion​

UltraCart provides all major Facebook and Meta integration capabilities required for advertising attribution, catalog advertising, dynamic product ads, retargeting, server-side conversion tracking, and social sharing optimization.

Although setup involves several independent components, each integration can be configured directly through UltraCart administrative tools and Meta Business Manager.

Next Steps​

After completing this setup, consider reviewing:

  • Facebook Dynamic Product Ads

  • Instagram Shopping setup

  • UltraCart Analytics reporting

  • StoreFront Visual Builder customization

  • Email and SMS retargeting flows

For additional assistance, contact UltraCart Support.

Was this page helpful?