Meta Integration

The Meta integration allows you to sync and manage all your Meta (Facebook) advertising campaigns, ad sets, and ads directly from Ott.

Overview

With Meta integration, you can:

• Sync Campaigns: Automatically sync all campaigns, ad sets, and ads from your Meta ad accounts
• Daily Metrics Sync: Get daily updates on performance metrics (impressions, clicks, spend, conversions, ROAS, CTR, CPC, CPA)
• Real-Time Data: Access up-to-date campaign performance data
• Conversion Tracking: Send conversion events back to Meta via Conversion API
• Multi-Account Support: Manage multiple Meta ad accounts in one place

Connecting Your Meta Account

Prerequisites

Before connecting, ensure you have:

• A Meta Business account
• Access to Meta Business Manager
• Admin or Advertiser role on the ad accounts you want to sync
• A Meta App with Marketing API access

Step-by-Step Setup

1. Navigate to Integrations

   • Go to Settings → Integrations → Meta
   • Or use the quick access from the dashboard

2. Connect Meta Account

   • Click Connect Meta Account
   • You'll be redirected to Meta's authorization page

3. Grant Permissions

   • Log in with your Meta account
   • Grant the following permissions:
     • ads_read - Read advertising data
     • ads_management - Manage advertising campaigns
     • business_management - Access Business Manager data

4. Select Ad Accounts

   • Choose which ad accounts to sync
   • You can select multiple accounts
   • Click Save to complete the connection

Understanding the Sync Process

Initial Sync

When you first connect:

• All campaigns, ad sets, and ads are imported
• Historical performance data is synced (up to 90 days)
• Account structure is replicated in the dashboard

Daily Sync

Automatic daily syncs occur:

• Time: Typically runs overnight (configurable)
• Frequency: Once per day for each connected account
• Data: Campaigns, ad sets, ads, and performance metrics

Manual Sync

You can trigger a manual sync:

1. Go to Integrations → Meta
2. Click Sync Now next to your connected account
3. Wait for the sync to complete (usually 1-5 minutes)

Managing Connected Accounts

Viewing Connected Accounts

• Navigate to Integrations → Meta
• See all connected accounts with their sync status
• View last sync time and next scheduled sync

Disconnecting an Account

1. Go to Integrations → Meta
2. Find the account you want to disconnect
3. Click Disconnect
4. Confirm the action

Note: Disconnecting will stop syncing but won't delete historical data.

Reconnecting an Account

If you need to reconnect:

1. Disconnect the account (if still connected)
2. Follow the connection steps again
3. Your historical data will be preserved

Troubleshooting

Sync Failures

If sync fails:

• Check Permissions: Ensure you still have access to the ad account
• Verify API Access: Confirm your Meta App has the required permissions
• Check Rate Limits: Meta API has rate limits; wait and retry
• Review Error Logs: Check the integration logs for specific errors

Missing Data

If data is missing:

• Wait for Sync: Some data may take time to sync
• Check Date Range: Ensure you're viewing the correct date range
• Verify Account Access: Confirm you have access to the ad account
• Contact Support: If issues persist, contact support

API Errors

Common API errors:

• Invalid Token: Reconnect your Meta account
• Permission Denied: Check your Meta account permissions
• Rate Limit Exceeded: Wait before retrying
• Account Not Found: Verify the ad account ID

Best Practices

• Regular Monitoring: Check sync status regularly
• Permission Management: Keep Meta permissions up to date
• Account Organization: Use Meta Business Manager to organize accounts
• Data Backup: Export important data regularly
• Error Monitoring: Set up alerts for sync failures

Next Steps

• Telegram Conversion Tracking
• Dashboard Overview
• Custom Metrics