> ## 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 Apps Events

> Learn how to integrate Facebook Apps Events with Masivo CDP for mobile app event tracking and conversion optimization

## What is Facebook Apps Events Integration?

The Facebook Apps Events integration allows you to track customer events, purchases, and conversions from Masivo directly to Facebook's App Events API. This integration enables you to measure the effectiveness of your Facebook advertising campaigns for mobile apps and create custom audiences based on your loyalty program data.

## Key Features

<CardGroup cols={2}>
  <Card title="Mobile App Tracking" icon="smartphone">
    Track customer events, purchases, and conversions from mobile apps to
    Facebook App Events
  </Card>

  <Card title="Conversion Optimization" icon="trending-up">
    Optimize Facebook ad campaigns based on actual customer behavior and
    purchases from mobile apps
  </Card>

  <Card title="Custom Audiences" icon="users">
    Create Facebook custom audiences based on mobile app loyalty program
    activities
  </Card>

  <Card title="Attribution Tracking" icon="link">
    Track customer journey and attribution across Facebook ads and mobile app
    engagement
  </Card>
</CardGroup>

## Integration Type

### Facebook Apps Events as Destination

When configured as a destination, Masivo sends customer events to Facebook App Events API:

* **Customer Events**: Registration, identification, and engagement events from mobile apps
* **Purchase Events**: Transaction data with product details and values
* **Custom Events**: Loyalty program specific events and behaviors
* **App Lifecycle Events**: Install, open, and session tracking

## Data Flow

<Steps>
  <Step title="Event Collection">
    Customer events and purchases are collected in Masivo through mobile app
    touchpoints
  </Step>

  <Step title="Event Mapping">
    Events are mapped to Facebook App Events standard events (Purchase,
    CompleteRegistration, AppActivated)
  </Step>

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

  <Step title="App Events API">
    Events are sent to Facebook App Events API for conversion tracking and
    audience building
  </Step>
</Steps>

## Supported Event Types

<AccordionGroup>
  <Accordion title="Customer Events">
    * **CUSTOMER/USER/IDENTIFY** → CompleteRegistration - Customer registration
      and profile creation events - User identification and authentication events
  </Accordion>

  <Accordion title="Purchase Events">
    * **PURCHASE/TRANSACTION** → Purchase - Transaction data with product
      details - Purchase amounts, currencies, and quantities
  </Accordion>

  <Accordion title="Engagement Events">
    * **EVENT/TRACK** → Custom events - Customer behavior and engagement events
    * Custom loyalty program activities
  </Accordion>

  <Accordion title="Page Events">
    * **PAGE/PAGEVIEW** → AppActivated - App lifecycle and navigation events -
      Customer journey tracking
  </Accordion>
</AccordionGroup>

## Data Mapping

<Card title="Event Mapping" icon="arrow-right">
  <AccordionGroup>
    <Accordion title="User Data">
      * Email (hashed) - Phone (hashed) - External ID - Client IP - User Agent -
        Facebook Click ID (fbc) - Facebook Browser ID (fbp) - Device information
        (brand, model, OS)
    </Accordion>

    <Accordion title="App Data">
      * App information and metadata - Install referrer - URL schemes -
        Subscription ID - Facebook Login ID
    </Accordion>

    <Accordion title="Custom Data">
      * Product IDs and names - Product categories and brands - Order IDs and
        values - Currency and quantities - Search terms - Custom properties
    </Accordion>
  </AccordionGroup>
</Card>

## Privacy & Compliance

<CardGroup cols={2}>
  <Card title="PII Protection" icon="shield">
    Email and phone numbers are automatically hashed before sending to Facebook
  </Card>

  <Card title="GDPR Compliance" icon="check-circle">
    Supports Facebook's data processing options for GDPR compliance
  </Card>

  <Card title="Tracking Controls" icon="toggle">
    Supports configurable tracking settings for privacy compliance
  </Card>

  <Card title="Opt-out Support" icon="user-x">
    Respects customer opt-out preferences for data sharing
  </Card>
</CardGroup>

## Benefits

<CardGroup cols={2}>
  <Card title="Mobile Attribution" icon="target">
    Track the complete customer journey from Facebook ads to mobile app
    engagement
  </Card>

  <Card title="Campaign Optimization" icon="trending-up">
    Optimize Facebook ad campaigns based on actual mobile app conversions
  </Card>

  <Card title="Lookalike Audiences" icon="users">
    Create lookalike audiences based on your most valuable mobile app customers
  </Card>

  <Card title="App Analytics" icon="bar-chart">
    Get comprehensive insights into mobile app customer behavior
  </Card>
</CardGroup>

## Next Step

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