Connect & manage Meta Ads with Wevion — complete guide

TL;DR: Wevion's Meta integration uses OAuth with scopes ads_management + pages_read_engagement + business_management. Connect → pick accounts → 15-min sync → manage via Campaign Creator + Ads Manager + Rules + Analytics. Meta is the most-supported platform (write actions enabled, all platforms read).

Table of contents

• Connect Meta account (OAuth)

• Pick ad accounts

• Permissions + scopes

• Sync data

• Manage campaigns

• Troubleshoot

• FAQ

• Next steps

Connect Meta account (OAuth)

/connect/meta → OAuth consent screen → grant permissions → tokens stored encrypted in Wevion DB.

• meta-101 connect Meta account — full flow

OAuth flow includes business validation + ad-account selection.

Pick ad accounts

After OAuth: Wevion lists ad accounts visible to your Meta user. Pick which to manage in Wevion (typically all relevant for your team).

Per-account: data syncs independently, can be enabled / disabled.

Permissions + scopes

Verified scopes (per apps/backend/src/lib/meta/):

Refresh tokens auto-handle long-term access; full re-auth required on permission change OR after platform-enforced expiry.

Sync data

Cron syncs from Meta every 15 minutes (apps/backend/src/sqs/workers/sync/). Insights flow into:

• campaign_daily_insight (per-day, per-campaign)

• adset_daily_insight

• ad_daily_insight

Postback conversions lag 24-72h. See am-121 postback vs Meta conversions.

Manage campaigns

Once connected, full lifecycle in Wevion:

• Launch: cc-101 Campaign Creator (3 modes: Express / Pro / Bulk)

• Monitor: am-101 Ads Manager + an-101 Analytics

• Automate: rul-101 Rules Engine

• Creative: ch-101 Creative Hub — generate + manage assets

Meta-only actions:

• relaunch rule action (copy ad with new creative — Meta-only)

Troubleshoot

Connection issues, sync failures, permission errors:

• meta-108 Meta troubleshooting — deep dive

Common: token expired → re-auth via /connect/meta. See tr-109 token expired.

FAQ

Can I connect multiple Meta accounts?

Yes. Connect once (OAuth flow) → pick multiple ad accounts. Wevion manages each independently. For multi-Business-Manager scenarios: connect each via separate flow.

What if I lose access to my Meta user?

Re-authorize via OAuth flow with new Meta user. Wevion re-picks accessible accounts.

Does Wevion work with WhatsApp / Instagram Ads?

Yes — both are part of Meta's ad platform. Same OAuth flow + same ads_management scope.

Token expiring notification?

Meta access tokens have refresh tokens. Wevion auto-refreshes. If refresh fails: notification + re-auth needed. See tr-109 token expired.

Sync frequency?

Every 15 minutes per Wevion cron. Postback conversions lag separately (24-72h via Meta API).

iOS 14.5+ ATT impact?

Meta's iOS ATT limits per-user attribution. Use postback / tracker data for fuller picture. See am-121 postback vs Meta conversions.

Next steps

• First-time Meta setup: meta-101 connect Meta account

• Launch first campaign: cc-101 Campaign Creator

• Monitor performance: am-101 Ads Manager

• Automation: rul-101 Rules Engine

• Stuck: meta-108 Meta troubleshooting OR tr-110 contacting support

Related

• meta-101 connect Meta account

• meta-108 Meta troubleshooting

• cc-101 Campaign Creator overview

• am-101 Ads Manager overview

• an-101 Analytics overview