BYO Mode Setup
Connect your own ad account via OAuth. You retain billing; Layers retains optimization.
BYO (Bring Your Own) mode plugs Layers into your existing ad account. You pay the platforms directly; Layers takes no percentage of media spend.
Step 1: OAuth your ad account
In the ad layer's setup wizard:
- Click Connect via OAuth.
- Sign in to Meta / TikTok / Google with the account that owns the ad account.
- Confirm scopes (varies by platform; minimums are below).
- Pick the ad account if you have multiple.
Step 2: Configure CAPI / Events API
For Meta and TikTok, you'll need to provide:
- Pixel ID / Events Set ID - the asset receiving events.
- CAPI access token - store in the Layers credential vault. Layers gives you the vault entry to copy into.
- Test event code (Meta only) - for the first 30 days while you validate.
The setup wizard handles vault creation; you paste the token once.
Step 3: Verify
A verification step confirms:
- Layers can read campaigns / adsets / ads.
- Layers can publish a test event via CAPI.
- The test event appears in Meta Events Manager / TikTok Events Debugger.
Per-platform specifics
- Meta setup
- TikTok setup
- Apple Search Ads - OAuth-based (
searchadsscope).
OAuth scopes
| Platform | Scope | Why |
|---|---|---|
| Meta | ads_management, ads_read, business_management, pages_read_engagement, pages_show_list | Manage campaigns + Pixel + Business Center + page selection (pages scopes are required dependencies of ads_management). |
| TikTok | Portal-level auth via business-api.tiktok.com/portal/auth (TikTok does not itemize scopes in the OAuth URL; permissions are configured on the app in TikTok Business Center). | Manage campaigns + Pixel. |
| Apple | searchads | Manage ASA campaigns, ad groups, keywords. |
Token expiry
OAuth tokens expire on a platform-specific schedule. Layers auto-refreshes where the platform supports it. When refresh fails, you'll be prompted to reconnect; until you do, the layer is paused (no new launches; existing ads keep running until the platform's own cache invalidates).