Meta Integration

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

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