An advertiser is a client or brand inside an organization. It's where campaigns, ads, billing, and default settings all live together. Organizations can own multiple advertisers, which is how agencies manage several clients or brands side by side.
API operations
Relationships
organization
Every advertiser belongs to exactly one organization, which is the top-level billing and user management container. An organization can own multiple advertisers.
An advertiser owns zero or more campaigns. All campaigns are scoped to a single advertiser.
Ads are owned by the advertiser through their campaign association.
An advertiser owns media assets in their asset library. Media assets serve as templates for creating ads.
Performance reports are available at the advertiser level (summary across all campaigns) and per-campaign.
Marketing plans are created within an advertiser context.
Key concepts
Organization
Top-level entity. Contains users, advertisers, and billing configuration. Named after the company.
Advertiser
Client or brand container within an organization. Named after the client or brand being advertised. Supports full CRUD: create, list, get, and update.
API Key Scoping
An API key is either advertiser-scoped (carries an advertiser id and operates only on that advertiser) or unscoped at the organization level (no implicit advertiser; the caller selects an advertiser per request and can create new advertisers via POST /v1/advertisers).
When building apps
*Advertiser Provisioning Model
Apps need to decide up front how they handle advertisers. In a per-user-advertiser app, each app user maps 1:1 to an AdCritter advertiser - call POST /v1/advertisers eagerly at signup with an unscoped org-level API key and store the returned id on the user record. In an invite-based app, advertisers are created and managed in the Acorn portal, and the app calls GET /v1/advertisers after sign-in to enumerate accessible advertisers (auto-selecting when there is exactly one). GET /v1/me verifies the credential and returns the user and organization, but does not return an advertiser.