Ads account connection (deep-dive)
Quick version: Connect Amazon Ads. This page is the deeper reference.
In this guide:
- Why Ads is per-region
- The connection lifecycle
- Marketplace selection within a region
- Disconnecting cleanly
- What persists after disconnect
Why Ads is per-region
The Amazon Advertising API is regional. Three regions exist (NA, EU, FE), each with:
- Its own OAuth endpoints.
- Its own consent screens.
- Its own data — campaigns, keywords, reports — not bridged across regions.
Your Amazon Ads accounts can be different per region (often the same Amazon login, sometimes different). Hilal mirrors this — each region is a separate connection with separate refresh tokens.
The connection lifecycle
Per-region:
- Initial OAuth — you click Connect on a region card; Hilal redirects to Amazon’s regional Ads OAuth; Amazon returns with an authorization code; Hilal exchanges it for refresh + access tokens.
- Marketplace selection — Amazon returns a list of Ads profiles. Hilal asks which marketplaces in that region you want managed; selection persists.
- Initial sync — Hilal pulls campaigns, ad groups, keywords, and recent performance data.
- Steady state — periodic syncs (default: every 60 minutes for active campaigns; longer for archived).
- Token refresh — automatic.
- Disconnect — manual via region card → Disconnect.
Marketplace selection within a region
Amazon’s Ads API exposes Ads profiles — one per (region, marketplace) tuple your Ads account has access to. After OAuth, Hilal shows you the profiles and you tick which ones to manage.
Tick only what you actually advertise in. Untick can be done later via region card → Edit marketplaces without re-OAuth-ing.
Disconnecting cleanly
Region card → Disconnect:
- Hilal revokes the OAuth grant on Amazon’s side (best-effort).
- Hilal stops scheduling syncs for the region.
- Hilal keeps the historical campaign data, performance reports, and your tagged custom data.
Why we keep historical data:
- You may want to report against past campaigns.
- Reconnecting later resumes against the same internal IDs.
- It’s never a destructive action.
To genuinely wipe historical data, contact support — there’s no in-app delete.
What persists after disconnect
| Persists | Doesn’t persist |
|---|---|
| Historical performance reports | New sync data |
| Campaign metadata as of last sync | Live campaign edits |
| Your custom tags / notes | Real-time spend updates |
| The region’s marketplace selection | (Re-confirmed on reconnect) |
Multi-region operators
If you run ads in two or three regions, the recommended setup is:
- Connect all regions on day one.
- Select only the marketplaces you actively advertise in within each region.
- Use the Region filter at the top of the campaign list to focus on the day’s work.
- Use the persisted multi-region selection to bookmark filtered views.