Ad Intelligence Overview

Role and auth requirements

• Primary roles: OWNER, OPERATOR
• Auth mode: JWT (Authorization: Bearer <token>)

UI flow (draft)

1. Connect ad account for a handle.
2. Ingest performance data.
3. Run optimization analysis modules.

API fallback (draft)

• PUT /v2/handles/{handle}/ad-accounts
• GET /v2/handles/{handle}/ad-accounts
• POST /v2/handles/{handle}/ad-performance
• GET /v2/handles/{handle}/ad-performance

Failure and remediation (draft)

• 400 invalid_payload: validate account identifiers and request shape.
• 401 unauthorized: refresh JWT and retry.
• 403 forbidden: ensure operator/owner access on handle.
• 429 rate_limited: reduce request frequency.