Cómo GAM decide qué anuncio mostrar cuando gana Prebid
Cada puja de Prebid necesita su espejo en Google Ad Manager: sin line items, el ganador nunca se sirve. Pixalate encontró que Google Ad Exchange aparece en el ads.txt del 98.9% de los sitios con programática abierta (Q2 2024). Estas 6 claves explican la jerarquía, el targeting y la generación vía API con referencias oficiales.
1. Jerarquía GAM en 3 niveles: order, line item y creative
GAM organiza la entrega en 3 niveles: la order agrupa la campaña, el line item define precio, fechas y targeting, y la creative contiene el código que renderiza. Para Prebid se crea 1 order madre que agrupa cientos de line items generados por bucket de precio.
La documentación de Google describe 6+ tipos de line item (sponsorship, standard, price priority, Ad Exchange, AdSense, house); Prebid usa price priority para competir por precio exacto contra el resto de la demanda.
2. Price priority: el line item que iguala la puja
Cada line item price priority declara 1 precio (por ejemplo, $1.20 CPM) y solo gana si el
hb_pb entrante lo iguala. Con granularidad
medium se generan unos 200 line items; con dense, más de 1,000 por formato.
La prioridad de serving evalúa primero sponsorship (prioridad 4), luego standard (6-8) y price priority (12), antes de Ad Exchange en cascada. Por eso el line item Prebid debe tener delivery evenly desactivado y frecuencia sin tope para no filtrar pujas válidas.
3. Key-value targeting: 2 claves que hacen el match
El targeting mínimo usa 2 claves: hb_pb igual al bucket (ej. 1.20) y hb_format igual al formato (ej. banner). Setups avanzados agregan hb_bidder para deals y hb_deal para programático garantizado, hasta
4 claves por line item.
Prebid.org documenta este esquema en su guía de setup con GAM paso a paso, incluyendo los valores exactos de 5 key-values estándar.
4. La creative genérica: 1 snippet para 1,000 line items
En vez de 1,000 creatividades distintas, se usa 1 creative genérica por formato con el
snippet que renderiza hb_adid:
<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/creative.js"></script>
<script>pbuc.renderAd(document, '%%PATTERN:hb_adid%%');</script>El macro %%PATTERN:hb_adid%% se sustituye en
serving en milisegundos, de modo que 1 creative sirve los 1,000 buckets.
5. Generación vía API: de 8 horas manuales a 10 minutos
Crear 1,000 line items a mano toma unas 8 horas con tasa de error típica del 5%. Las herramientas de generación usan la API de GAM con credenciales OAuth2 de 3 piezas (client ID, client secret y refresh token) y plantillas Prebid para crear order, line items, key-values y creatives en unos 10 minutos, con cron de sincronización cada 24 horas.
La industria documenta este flujo como estándar operativo: plantilla versionada, dry-run de 50 line items y despliegue completo tras validación.
Referencias
- Prebid.org — Configuración con Google Ad Manager
- Google — Acerca de los line items (Ad Manager)
- Google — Key-values y targeting (Ad Manager)
- Google — API de Ad Manager
- Pixalate — Seller Trust Index Q2 2024 (AdX en 98.9% de sitios)