> ## Documentation Index
> Fetch the complete documentation index at: https://docs.masivo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Facebook Audiences

> Legacy Facebook Custom Audiences destination (deprecated — use v2)

<Warning>
  This destination (`facebook-audiences-destination`) is **deprecated**. Use
  [Facebook Audiences v2](/guides/CDP/integrations/facebook-audiences-v2/overview)
  (`facebook-audiences-v2-destination`) for new connections. Existing v1
  connections continue to process for compatibility.
</Warning>

## What is Facebook Audiences Integration?

The legacy Facebook Audiences integration syncs customer data from Masivo to a
**single** pre-created Facebook Custom Audience (you paste a static
`audience_id`). v2 replaces this model with ad-account credentials and
automatic Meta audience creation per Masivo audience.

## Key Features

<CardGroup cols={2}>
  <Card title="Custom Audiences" icon="users">
    Sync customer data to Facebook Custom Audiences for targeted advertising
  </Card>

  <Card title="Segmentation" icon="layers">
    Create audiences based on loyalty program tiers, engagement, and behavior
  </Card>

  <Card title="Privacy Compliant" icon="shield">
    PII data is hashed and processed according to Facebook's privacy
    requirements
  </Card>
</CardGroup>

## Integration Type

### Facebook Audiences as Destination

When configured as a destination, Masivo syncs customer data to Facebook Custom Audiences:

* **Customer Profiles**: User information, demographics, and contact details
* **Behavioral Data**: Customer engagement and loyalty program activities
* **Segmentation Data**: Customer tiers, tags, and custom attributes
* **Purchase History**: Transaction data and purchase patterns

## Data Flow

<Steps>
  <Step title="Data Collection">
    Customer data is collected in Masivo through loyalty program activities
  </Step>

  <Step title="Data Processing">
    Customer information is processed and PII is hashed for privacy compliance
  </Step>

  <Step title="Audience Building">
    Customer data is organized and prepared for Facebook Custom Audiences
  </Step>

  <Step title="Facebook Sync">
    Data is sent to Facebook Custom Audiences API for audience creation
  </Step>
</Steps>

## Supported Data Types

<AccordionGroup>
  <Accordion title="Contact Information">
    * Email addresses (hashed) - Phone numbers (hashed) - External customer IDs
  </Accordion>

  <Accordion title="Demographic Data">
    * First and last names - Date of birth - Gender - Location data (city,
      state, country, zip code)
  </Accordion>

  <Accordion title="Behavioral Data">
    * Customer engagement events - Loyalty program activities - Purchase history
    * Custom attributes
  </Accordion>

  <Accordion title="Segmentation Data">
    * Customer tiers and levels - Custom tags and attributes - Audience
      membership - Behavioral segments
  </Accordion>
</AccordionGroup>

## Audience Types

<Card title="Custom Audience Types" icon="users">
  <AccordionGroup>
    <Accordion title="Customer List">
      Upload customer email addresses and phone numbers for direct targeting
    </Accordion>

    <Accordion title="Engagement Audiences">
      Target customers based on loyalty program engagement and activities
    </Accordion>

    <Accordion title="Purchase Audiences">
      Create audiences based on purchase history and transaction patterns
    </Accordion>

    <Accordion title="Tier-based Audiences">
      Target customers based on loyalty program tiers and status
    </Accordion>
  </AccordionGroup>
</Card>

## Privacy & Data Protection

<CardGroup cols={2}>
  <Card title="PII Hashing" icon="lock">
    Email addresses and phone numbers are automatically hashed using Facebook's
    required methods
  </Card>

  <Card title="GDPR Compliance" icon="shield">
    Supports Facebook's data processing options and privacy controls
  </Card>

  <Card title="Data Minimization" icon="filter">
    Only necessary customer data is sent to Facebook for audience creation
  </Card>

  <Card title="Opt-out Respect" icon="user-x">
    Respects customer privacy preferences and opt-out requests
  </Card>
</CardGroup>

## Benefits

<CardGroup cols={2}>
  <Card title="Precise Targeting" icon="target">
    Target your most valuable customers with highly relevant Facebook ads
  </Card>

  <Card title="Lookalike Audiences" icon="users">
    Create lookalike audiences based on your best loyalty program customers
  </Card>

  <Card title="Cross-platform Insights" icon="bar-chart">
    Gain insights into customer behavior across your loyalty program and
    Facebook
  </Card>
</CardGroup>

## Audience Examples

<Card title="Common Audience Segments" icon="layers">
  <AccordionGroup>
    <Accordion title="High-Value Customers">
      Customers in top loyalty tiers with high purchase frequency
    </Accordion>

    <Accordion title="At-Risk Customers">
      Customers who haven't engaged recently or are showing churn signals
    </Accordion>

    <Accordion title="New Members">
      Recently registered customers who haven't made their first purchase
    </Accordion>

    <Accordion title="Product-Specific Audiences">
      Customers who have purchased specific product categories
    </Accordion>
  </AccordionGroup>
</Card>

## Integration Requirements

<Card title="Facebook Requirements" icon="facebook">
  <AccordionGroup>
    <Accordion title="App Setup">
      * Facebook App ID and App Secret - Access token with custom\_audiences
        permission
    </Accordion>

    <Accordion title="Audience Setup">
      * Custom Audience ID - Proper audience configuration in Facebook Business
        Manager
    </Accordion>

    <Accordion title="Permissions">
      * ads\_management permission - custom\_audiences permission - Business
        Manager access
    </Accordion>
  </AccordionGroup>
</Card>

## Next Step

<CardGroup cols={2}>
  <Card title="Setup Guide" icon="wrench" href="/guides/CDP/integrations/facebook-audiences/setup">
    Learn how to configure your Facebook Audiences integration
  </Card>
</CardGroup>