Meta Pixel (Facebook/Instagram) Integration

Track HoloStep 3D viewer interactions with Meta Pixel to measure ad performance and build retargeting audiences on Facebook and Instagram.

Overview

HoloStep sends events to Meta Pixel when users interact with your 3D product viewers. This helps you:

• Measure ad effectiveness - Track which ads drive 3D engagement
• Build audiences - Create retargeting audiences based on 3D interactions
• Optimize campaigns - Use event data for ad optimization

Tracked Events

HoloStep Event	Meta Pixel Event	Description
3D Viewer Open	ViewContent	User opens 3D viewer
AR Mode Open	ViewContent	User launches AR mode
Variant Select	CustomizeProduct	User changes product variant
Add to Cart	AddToCart	User adds product to cart
Purchase	Purchase	User completes purchase
Page View	PageView	Page with HoloStep loads

---

Prerequisites

• A Meta Business Account
• A Meta Pixel created in Events Manager
• A HoloStep account with an active subscription

---

Step 1: Get Your Pixel ID

1.1 Open Events Manager

1. Go to Meta Events Manager
2. Select your Pixel from the Data Sources tab
3. Click Settings

1.2 Copy Your Pixel ID

Find the Pixel ID at the top of the settings page. It's a 15-16 digit number (e.g., 123456789012345).

---

Step 2: Configure HoloStep Integration

2.1 Open Integration Settings

1. Log in to your HoloStep Dashboard
2. Go to Settings → Integrations
3. Click Add Integration

2.2 Select Meta Pixel

1. Choose Meta Pixel (Facebook/Instagram) from the list
2. Enter a name (e.g., "Production Meta Pixel")

2.3 Enter Your Credentials

Field	Value	Required
Pixel ID	Your 15-16 digit Pixel ID	Yes
Access Token	For Conversions API (server-side)	No
Test Event Code	For testing in Events Manager	No

TIP

For most use cases, only the Pixel ID is needed. Access Token is only required if you want server-side event tracking via the Conversions API.

2.4 Save and Validate

1. Click Create Integration
2. Click Validate Connection
3. Toggle the integration ON

---

Step 3: Verify in Events Manager

Test Events Tool

1. Go to Events Manager
2. Select your Pixel
3. Click Test Events tab
4. Open your website in a new tab
5. Interact with a 3D viewer
6. Events should appear in the Test Events view

Event Activity

1. In Events Manager, click Overview
2. Look for ViewContent and CustomizeProduct events
3. Events from HoloStep will include holostep in the content parameters

---

Optional: Test Event Code

For testing without affecting production data:

1. In Events Manager → Test Events
2. Copy the Test Event Code (e.g., TEST12345)
3. Add it to your HoloStep integration settings
4. Events will appear in Test Events but won't affect reporting

WARNING

Remove the Test Event Code before going live, or events won't be recorded in your actual reports.

---

Optional: Conversions API (Server-Side)

For enhanced tracking that bypasses ad blockers, you can enable the Conversions API.

Generate Access Token

1. Go to Events Manager
2. Select your Pixel → Settings
3. Scroll to Conversions API
4. Click Generate access token
5. Copy the token

Add to HoloStep

1. Edit your Meta Pixel integration in HoloStep
2. Paste the Access Token
3. Save changes

INFO

Server-side Conversions API support is coming soon. Currently, HoloStep uses client-side fbq() tracking.

---

Event Parameters

HoloStep sends these parameters with Meta Pixel events:

Parameter	Description	Example
content_name	Product/scene name	Modern Chair
content_ids	Scene ID array	['12345']
content_type	Always product	product
value	Product value (if available)	299.99
currency	Currency code	USD

---

Troubleshooting

Events Not Appearing

Issue	Solution
No events in Test Events	Check Pixel ID format (15-16 digits)
Events blocked	Disable ad blockers for testing
Integration disabled	Verify toggle is ON in HoloStep

Debug Tools

1. Meta Pixel Helper: Install the Chrome extension to see pixel fires
2. Browser Console: Look for [HoloStep] Meta Pixel initialized
3. Network Tab: Filter for facebook.com/tr requests

Events fire but don't appear in Events Manager

Events can take up to 20 minutes to appear. Use the Test Events tool for immediate verification.

"Pixel ID invalid" error

Ensure your Pixel ID is exactly 15-16 digits with no spaces or dashes.

---

Building Audiences

Once events are flowing, create custom audiences:

1. Go to Audiences
2. Click Create Audience → Custom Audience
3. Select Website
4. Choose your Pixel
5. Create rules based on events:
   • Viewed 3D content: ViewContent where content contains "holostep"
   • Customized product: CustomizeProduct event
   • High intent: AddToCart event

---

Related Resources

• Meta Pixel Documentation
• Meta Events Manager
• HoloStep GA4 Integration
• HoloStep Google Ads Integration