Introduction

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)

• 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.

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

  • 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

• Purchases

UltraCart includes native Meta Pixel support through the StoreFront Privacy & Tracking settings.

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:

Step 2 — Open Privacy & Tracking Settings in UltraCart

Navigate to:

[Image Placeholder — Privacy & Tracking Facebook Pixel Configuration]

Step 3 — Enter the Pixel ID

1. Locate the Facebook Pixel ID field.

2. Paste the Pixel ID.

3. Click Save.

Step 4 — Verify Pixel Tracking

1. Open your storefront in a browser.

2. Open Meta Events Manager in another tab.

3. Navigate to:

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

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

• Support Lookalike Audience generation

Step 1 — Find Your Facebook Account ID

1. Log in to Facebook Business Manager.

2. Navigate to:

3. Locate your numeric Business Account ID.

Example:

Step 2 — Open Facebook Analytics Settings in UltraCart

Navigate to:

Scroll to the Facebook Analytics section.

[Image Placeholder — Facebook Analytics Configuration]

Step 3 — Connect Your Facebook Account

1. Enter the Facebook Account ID.

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:

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

• 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

• Facebook / Meta product feeds

This means 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:

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:

[Image Placeholder — Google Product Search Configuration Page]

This configuration area controls:

• Feed generation

• Feed activation

• Manual feed updates

• 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

• 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:

[Image Placeholder — Item Editor Google Product Search Tab]

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

• 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 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

• 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

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

Navigate to:

[Image Placeholder — StoreFront File Manager Feeds Folder]

The generated file will be:

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:

4. Select:

5. Choose:

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

7. Configure the refresh schedule

8. Complete the import

[Image Placeholder — Meta Commerce Manager Feed 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

• 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

• 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:

4. Click Generate Access Token.

5. Copy and securely store the token.

Step 2 — Configure CAPI in UltraCart

Navigate to:

[Image Placeholder — UC Analytics Facebook CAPI Configuration]

Enter the Following Values

Save the configuration.

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

• Open Graph tag output

Step 4 — Verify CAPI Delivery

1. Open Meta Events Manager.

2. Navigate to:

3. Place a test order.

4. Confirm that events display both:

   • Browser source

   • 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

Step 1 — Enable the Visual Builder Beta Runtime

Open Graph support requires the Visual Builder beta runtime.

Step 2 — Verify Open Graph Output

1. Open a product page.

2. View the page source.

3. Search for:

Alternatively, use Facebook's Sharing Debugger:

[Image Placeholder — Facebook Sharing Debugger]

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 is correct.

• Remove any duplicate manual Pixel scripts.

• Confirm Privacy & Tracking settings were saved.

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

Feed Not Updating

Verify:

• The feed URL is public

• The file updates correctly

• Meta can access the file

CAPI Issues

Invalid Access Token

Generate a new token in Meta Events Manager.

Low Match Quality

Ensure customer information is collected during checkout, including:

• Email

• Phone

• First name

• 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