Aller au contenu principal
AdCP API Gateway

Media Buying.
Agent Interface.

Provide a standardized gateway for external AI buying agents to validate briefs and simulate campaigns before creation.

AdCP
brief schema
Pure
validation rules
0
side-effects (preview)
Secure
tenant isolation

Fonctionnalités

Ce que vous pouvez faire

Standardized briefs

AI buyers submit campaigns in unified AdCP format (advertiser, budget, formats, location targets).

Request validation

Validate campaign brief structure (Pydantic model verification) with zero ad server side-effects.

Media plan simulation

Query the preview endpoint to retrieve candidate products and inventory matches.

Transactional deploy

Unified deploy endpoint to convert a validated brief into Orders and Line Items in GAM.

API mapping normalizer

Map custom data feeds into a unified format for future agent-led programmatic transactions.

Security & budget caps

Verify declared budget limits against user account caps stored in Firestore.

Démonstration Interactive

Visualisez le fonctionnement en conditions réelles

Découvrez comment OrbiAds simplifie et automatise vos tâches AdOps quotidiennes.

Simulateur de Traduction AdCP

Brief publicitaire unifié compilé en structure GAM

Dry-Run Simulation
1. Entrée Brief (JSON)
{
  "advertiser": "BrandX",
  "budget": 5000.0,
  "geo": ["FR"],
  "format": "DISPLAY_MPU"
}
AdCP Compilation

Prêt à compiler le brief

2. Objets GAM Traduits
Lancez la traduction pour générer les objets Google Ad Manager.

Translating Unified Advertising Briefs into GAM Campaign Envelopes

Automated media buying by autonomous AI agents requires a standardized, reliable exchange format to prevent targeting issues and API failures. The AdCP (Agent-to-Agent programmatic media buy) gateway is a logical abstraction layer designed by OrbiAds to bridge the gap between unstructured advertising briefs and the complex, rigid hierarchy of Google Ad Manager. When an external buying agent submits a media buy request specifying advertiser profiles, budget boundaries, target locations, and required formats, the AdCP gateway translates it into standard GAM objects: Orders, Line Items, and Creative associations. This abstraction layer eliminates the need for third-party systems to navigate Google Ad Manager's complex SOAP schemas, enabling seamless and automated media buying workflows.

Dry-Run Simulations and Tenant-Level Security Controls

To safeguard against accidental inventory changes or costly execution mistakes, the AdCP gateway prioritizes secure previewing. The `/adcp/validate` and `/adcp/preview` endpoints run in dry-run mode, allowing agents to check request schemas and view recommended inventory paths without writing any real data to Google Ad Manager. Furthermore, all processes are strictly isolated at the Firebase UID tenant level, ensuring secure transactions and preventing information leakage between partners.

Exécution réelle

Voyez-le en action

adcp-gateway.log
$ adcp.validate_request({brief: {advertiser: "BrandX", budget: 5000}})
→ Validating AdCP brief structure... OK
$ adcp.preview_media_buy({brief_id: "adcp_b18f"})
- Found 2 Products
- Recommended 4 Line Items
✓ Simulation completed — Awaiting agent execution token
AdCP API Gateway

Essayez gratuitement

5 crédits offerts. Aucune carte bancaire.