Skip to main content

​
Prerequisites

Before setting up the Facebook Apps Events integration, ensure you have:

​
Getting Your Facebook Credentials

​
1. Facebook App ID and App Secret

1

Access Facebook Developers

Log in to Facebook Developers and navigate to your app or create a new one
2

Get App ID

Find your App ID in Settings → Basic. Copy this value for the integration
3

Get App Secret

Find your App Secret in Settings → Basic. Click “Show” to reveal it and copy the value
Keep your App Secret secure. Never share it publicly or commit it to version control.

​
2. Access Token

1

Access Business Manager

Log in to Facebook Business Manager and navigate to Business Settings
2

Create System User

Go to System Users and create a new system user or use an existing one
3

Generate Token

Click “Generate New Token” and select the following permissions: - ads_management - ads_read
4

Copy Token

Save the access token securely - you’ll need it for the integration
Use a System User Token, not an App Token. App Tokens (app_id|app_secret) will not work for sending events to Facebook Apps Events API.

​
Configuration Steps

​
Step 1: Access Integration Settings

1

Navigate to CDP

Go to your Masivo dashboard and select the CDP section
2

Open Integrations

Click on “Integrations” in the CDP menu
3

Add New Integration

Click “Add Integration” and select “Facebook Apps Events” from the catalog

​
Step 2: Configure Basic Settings

Required Fields

Enter your Facebook App ID from Facebook Developers. This identifies your mobile app in Facebook’s system.
Enter your Facebook System User Token with ads_management permissions. This token authenticates API requests to Facebook Apps Events.
Enter your Facebook App Secret from Facebook Developers. This is used for event validation and security.

​
Step 3: Configure Optional Settings

Optional Fields

Optional name for your mobile app. If not provided, a default name will be used.
Optional version of your mobile app for tracking purposes (e.g., “1.0.0”).

​
Step 4: Configure App Tracking Settings

Tracking Settings

Enable this option to allow advertiser tracking for iOS 14.5+ devices. This is required for accurate attribution on iOS devices.
Enable this option to allow application-level tracking for analytics and event tracking.

​
Facebook Configuration Details

​
Required Permissions

Facebook Permissions

  • ads_management: Required for sending events to Facebook Apps Events API - ads_read: Required for reading ad account information
Your Facebook App must have the following capabilities enabled: - App Events API access - Mobile app tracking enabled

​
Event Tracking

1

Event Collection

Customer events and purchases are collected in Masivo through mobile app touchpoints
2

Event Mapping

Events are automatically mapped to Facebook App Events standard events (Purchase, CompleteRegistration, AppActivated)
3

Data Processing

Customer data is processed and PII is hashed for privacy compliance
4

Facebook API

Events are sent to Facebook Apps Events API for conversion tracking and audience building

​
Monitoring and Troubleshooting

​
Health Monitoring

1

Event Delivery

Monitor event delivery success rates in Facebook Events Manager
2

Data Quality

Check for data validation errors and missing fields in Facebook Events Manager
3

API Errors

Review error logs and failed API requests in Masivo integration logs
4

Token Expiration

Monitor access token expiration and refresh as needed

​
Common Issues

1

Check Token Type

Ensure you’re using a System User Token, not an App Token
2

Verify Permissions

Verify the token has ads_management and ads_read permissions
3

Token Expiration

Check if the token has expired and generate a new one if needed
1

Verify App ID

Ensure the App ID matches your Facebook App in Facebook Developers
2

Check App Status

Verify your Facebook App is active and not in development mode
3

App Secret Match

Ensure the App Secret matches the App ID
1

Check Event Format

Verify events are formatted correctly according to Facebook Apps Events API requirements
2

Review Event Manager

Check Facebook Events Manager for delivery errors and warnings
3

Test Events

Use Facebook’s Test Events feature to verify event delivery