links.10x.in/docs/end-user/ad-intelligence-overview Published:

Ad Intelligence Overview

Note

This is a draft stub. Full onboarding and workflow screenshots will be expanded in a follow-up documentation pass.

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.