Skip to main content

​
Prerequisites

Before setting up the Facebook Pixel integration, ensure you have:
  • A Facebook Business Manager account
  • A Facebook Pixel created in your Business Manager
  • A Facebook App with appropriate permissions
  • Access to Facebook Developers Console

​
Step 1: Create Facebook Pixel

1

Access Business Manager

Log in to your Facebook Business Manager account
2

Navigate to Events Manager

Go to Events Manager → Data Sources → Pixels
3

Create New Pixel

Click “Create a Pixel” and follow the setup wizard
4

Get Pixel ID

Copy your Pixel ID from the Pixel settings page

​
Step 2: Generate Access Token

1

Access Facebook Developers

Go to Facebook Developers Console
2

Select Your App

Choose the app associated with your Facebook Pixel
3

Generate Token

Go to Tools → API Explorer → Generate Access Token
4

Set Permissions

Ensure the token has ads_management and pixel_management permissions

​
Step 3: Configure in Masivo

1

Access Destinations

Navigate to Customers → Connections → Destinations in Masivo
2

Add Facebook Pixel

Click “Add Destination” and select “Facebook Pixel”
3

Enter Configuration

Fill in the required fields with your Facebook credentials
4

Test Connection

Save the configuration and test the connection

​
Configuration Fields

Required Fields

Field: pixel_id Your Facebook Pixel ID from Business Manager. Find it in Events → Pixels → [Your Pixel] → Settings. Format: 15-16 digit number (e.g., 1234567890123456)
Field: access_token Facebook access token with ads_management and pixel_management permissions. Format: EAAxxxxxxxxxxxxxxxxxxxxx

Optional Fields

Field: test_event_code Optional test event code for testing in development environments. Format: TEST12345
Field: action_source Source of the event (website, app, phone_call, etc.). Default: website
Field: event_source_url URL where the event occurred. Format: https://yourwebsite.com

​
Event Mapping

Event Types

Masivo Event: CUSTOMER, USER, IDENTIFY Facebook Event: CompleteRegistration Tracks customer registration and profile creation.
Masivo Event: PURCHASE, TRANSACTION Facebook Event: Purchase Tracks customer purchases and transactions.
Masivo Event: EVENT, TRACK Facebook Event: ViewContent Tracks customer engagement and behavior.
Masivo Event: PAGE, PAGEVIEW Facebook Event: ViewContent Tracks page views and navigation.

​
Data Privacy

Privacy Settings

Email addresses and phone numbers are automatically hashed using base64 encoding before sending to Facebook.
Configure data processing options for GDPR compliance if required.
Respect customer opt-out preferences for data sharing with Facebook.

​
Testing

Test Your Integration

1

Enable Test Mode

Add a test event code to your configuration for testing
2

Trigger Test Events

Create test customers and events in Masivo
3

Verify in Facebook

Check Facebook Events Manager to confirm events are being received
4

Remove Test Code

Remove test event code for production use

​
Troubleshooting

Common Issues

  • Verify Pixel ID is correct - Check access token permissions - Ensure test event code is removed in production
  • Verify access token has required permissions - Check if token has expired - Ensure app has proper Business Manager access
  • Check that customer data is properly formatted - Verify required fields are present - Ensure PII data is properly hashed

​
Best Practices

Data Quality

Ensure customer data is clean and properly formatted before sending to Facebook

Privacy Compliance

Regularly review and update privacy settings to maintain compliance

Monitoring

Monitor Facebook Events Manager for data quality and delivery issues

Testing

Always test in development environment before deploying to production