Skip to main content

​
Prerequisites

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

​
Step 1: Create Facebook App

1

Access Facebook Developers

Log in to Facebook Developers Console
2

Create New App

Click “Create App” and select “Business” as the app type
3

Configure App

Fill in app details and configure basic settings
4

Get App Credentials

Copy your App ID and App Secret from the app settings

​
Step 2: Create Custom Audience

1

Access Business Manager

Log in to your Facebook Business Manager account
2

Navigate to Audiences

Go to Audiences → Custom Audiences
3

Create New Audience

Click “Create Audience” → “Custom Audience”
4

Choose Data Source

Select “Customer List” as the data source
5

Get Audience ID

Copy the Audience ID from the audience settings

​
Step 3: Generate Access Token

1

Access API Explorer

Go to Facebook Developers → Tools → API Explorer
2

Select Your App

Choose the app you created in Step 1
3

Generate Token

Click “Generate Access Token”
4

Set Permissions

Ensure the token has ads_management and custom_audiences permissions

​
Step 4: Configure in Masivo

1

Access Destinations

Navigate to Customers → Connections → Destinations in Masivo
2

Add Facebook Audiences

Click “Add Destination” and select “Facebook Audiences”
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: audience_id Your Facebook Custom Audience ID from Business Manager. Find it in Audiences → Custom Audiences → [Your Audience] → Settings. Format: 15-16 digit number (e.g., 1234567890123456)
Field: access_token Facebook access token with ads_management and custom_audiences permissions. Format: EAAxxxxxxxxxxxxxxxxxxxxx
Field: app_id Your Facebook App ID from Facebook Developers. Find it in Facebook Developers → [Your App] → Settings → Basic. Format: 15-16 digit number (e.g., 1234567890123456)
Field: app_secret Your Facebook App Secret from Facebook Developers. Find it in Facebook Developers → [Your App] → Settings → Basic. Format: 32-character string

Optional Fields

Field: custom_audience_name Optional custom name for the audience. If not provided, a default name will be used. Format: Any string (e.g., “My Custom Audience”)
Field: description Optional description for the custom audience. Format: Any string describing the audience
Field: subtype Type of custom audience (CUSTOM, WEBSITE, APP, OFFLINE_CONVERSION, CLAIM). Default: CUSTOM
Field: retention_days Number of days to retain customer data in the audience (1-180). Default: 30

​
Data Mapping

Customer Data Fields

  • Email: Customer email address (automatically hashed) - Phone: Customer phone number (automatically hashed) - External ID: Customer identifier from your system
  • First Name: Customer first name - Last Name: Customer last name
  • Date of Birth: Customer birth date - Gender: Customer gender
  • City: Customer city - State: Customer state/province - Country: Customer country - Zip Code: Customer postal code

​
Privacy & Data Protection

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.
Set appropriate data retention periods based on your privacy policy.
Respect customer opt-out preferences for data sharing with Facebook.

​
Testing

Test Your Integration

1

Create Test Audience

Create a small test audience in Facebook Business Manager
2

Add Test Data

Add a few test customer records to your Masivo system
3

Verify Sync

Check Facebook Business Manager to confirm customers are being added
4

Test Campaigns

Create a test Facebook ad campaign using your custom audience

​
Audience Management

Best Practices

Create separate audiences for different customer segments (VIP, new customers, etc.)
Keep audiences fresh by regularly syncing updated customer data
Ensure audiences are large enough for effective Facebook advertising (minimum 1000 users)
Use clear, descriptive names for your custom audiences

​
Troubleshooting

Common Issues

  • Verify Audience ID is correct - Check access token permissions - Ensure App ID and App Secret are valid - Check customer data format
  • Verify access token has custom_audiences permission - 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
  • Ensure audience meets Facebook’s minimum size requirements - Check for duplicate customer data - Verify customer data quality

​
Best Practices

Data Quality

Ensure customer data is clean and properly formatted before syncing

Privacy Compliance

Regularly review and update privacy settings to maintain compliance

Audience Segmentation

Create targeted audiences based on customer behavior and value

Regular Monitoring

Monitor audience performance and update regularly