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
- Disconnecting cleanly
- What persists after disconnect
Why Ads is per-region
Hilal displays five region cards (North America, Europe, Far East, Middle East & Africa, India), but Amazon’s Advertising API has only three OAuth regions:
- North America — NA OAuth region.
- Europe — EUR OAuth region (also used for MEA and India).
- Far East — FE OAuth region.
Each OAuth region has:
- Its own OAuth endpoint and consent screen.
- Its own campaigns, keywords, reports — not bridged across regions.
- Its own access token and refresh token.
Your Amazon Ads accounts can be different per OAuth region (often the same Amazon login, sometimes different). Within the Europe OAuth region, MEA and India share the same access token. Reconnecting will prompt you to select which specific ads profile (and region) to connect.
The connection lifecycle
Per-region:
- Initial OAuth — you click Connect Ads 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.
- 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.
Disconnecting cleanly
Region card → Disconnect region:
- Hilal revokes the OAuth grant on Amazon’s side (best-effort).
- Hilal stops scheduling syncs for the region.
- Hilal schedules the regional data (campaigns, performance reports, custom data) for permanent deletion after approximately 30 days.
Why the 30-day window:
- Reconnecting within 30 days restores your historical data without re-syncing.
- After 30 days, the data is unrecoverable.
To restore data after disconnection, reconnect before the 30-day window closes. To genuinely wipe historical data sooner, contact support.
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 |
Multi-region operators
If you run ads in two or three regions, connect every region you advertise in from its own card under Settings → Amazon Accounts; each region connects, syncs and disconnects independently. Campaign Manager then shows the campaigns of every connected region — there is no separate region filter in the campaign list in the current build.