Aller au contenu principal
AdCP API Gateway

Acquisto Spazi.
Interfaccia Agenti.

Fornisce una porta standardizzata per agenti autonomi IA per validare richieste di acquisto e simulare campagne.

AdCP
formato brief
Pure
regole convalida
0
effetti (preview)
Secure
isolamento tenant

Fonctionnalités

Ce que vous pouvez faire

Briefing standard

Gli agenti acquirenti inviano campagne in formato AdCP (inserzionista, budget, formati, targeting).

Validazione brief

Valida la conformità sintattica del brief (modelli Pydantic) senza effetti collaterali sull'ad server.

Simulazione campagna

Richiedi in anteprima i prodotti consigliati e line item generabili in base al brief.

Deployment transazionale

Endpoint per convertire all'istante un brief convalidato in ordini e line item attivi in GAM.

Predisposizione catalogo

Modella l'esposizione futura dei cataloghi di inventario per acquisti automatizzati via agenti.

Controllo budget

Verifica i tetti finanziari dichiarati rispetto ai profili dei tenant salvati 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.

Traduzione di brief pubblicitari unificati in envelope di campagna GAM

L'acquisto automatizzato di spazi pubblicitari da parte di agenti autonomi richiede un formato di scambio standardizzato per evitare errori di targeting e arresti delle API. Il gateway AdCP (Agent-to-Agent programmatic media buy) è un livello di astrazione logica sviluppato da OrbiAds per colmare il divario tra i brief e la gerarchia di Google Ad Manager. Quando un agente acquirente esterno invia una richiesta specificando inserzionisti, budget, targeting geografico e formati, il gateway la traduce in oggetti standard GAM: ordini (Orders), linee di erogazione (Line Items) e associazioni creative. Questo livello di astrazione consente a sistemi esterni di interfacciarsi con GAM senza doverne gestire la complessità SOAP, semplificando l'automazione.

Simulazioni in modalità Dry-Run e sicurezza a livello di tenant

Al fine di evitare modifiche accidentali dell'inventario o costosi errori di trafficking, il gateway AdCP privilegia i processi di simulazione. Gli endpoint `/adcp/validate` e `/adcp/preview` funzionano in modalità dry-run, consentendo agli agenti di verificare la conformità e visualizzare la configurazione dell'inventario consigliata senza scrivere dati reali in Google Ad Manager. Inoltre, tutti i processi sono isolati a livello di tenant Firestore tramite UID Firebase, garantendo sicurezza e riservatezza tra i partner.

Exécution réelle

Voyez-le en action

adcp-gateway.log
$ adcp.validate_request({brief: {advertiser: "BrandX", budget: 5000}})
→ Convalida struttura del brief AdCP... OK
$ adcp.preview_media_buy({brief_id: "adcp_b18f"})
- Trovati 2 Prodotti
- Raccomandati 4 Line Item
✓ Simulazione creata — In attesa del token dell'agente
AdCP API Gateway

Essayez gratuitement

5 crédits offerts. Aucune carte bancaire.