Google Ad Library Ad
Las creatividades de Google Ads Transparency Center son registros publicitarios públicos con la identidad del anunciante, el texto y el contenido multimedia visibles, los enlaces de destino, los formatos, las fechas de entrega, las regiones y los datos de impresiones disponibles. Estos detalles sirven para verificar creatividades, enriquecer anuncios seleccionados, investigar el contexto de entrega y comparar archivos en momentos concretos.
Funcionalidades de la Google Ad Library Ad API
- Resolución exacta de la creatividadResuelve una URL de adstransparency.google.com que contenga /creative/ en, como máximo, un registro público de anuncio normalizado, sin ampliar la solicitud a una búsqueda.
- Campos del anunciante y de la creatividadDevuelve el identificador de la creatividad, la URL pública de origen, el texto disponible, la referencia del anunciante, el destino y el formato en un esquema de anuncio estable.
- Contexto de entregaConserva las fechas de inicio y fin, los países y las ubicaciones disponibles, y un valor escalar de impresiones solo cuando los datos de la fuente se pueden normalizar con seguridad.
- Recursos multimedia normalizadosExpone las referencias disponibles de imagen o video con miniaturas, dimensiones y duración, y omite los valores opcionales ausentes.
Parámetros de la Google Ad Library Ad API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | URL pública obligatoria de una creatividad de Google Ads Transparency Center. El esquema debe ser http o https, el host debe terminar en adstransparency.google.com y la ruta debe contener /creative/. |
Cómo usar la Google Ad Library Ad API
Envíe la URL pública exacta de una creatividad, siga la tarea asíncrona y lea el registro de anuncio normalizado en el contenedor de resultados estándar.
- Prepare una URL http o https en adstransparency.google.com cuya ruta contenga /creative/.
- Envíe url por POST a /v1/google-ad-library/ad y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle.
- Lea data.results.items; la operación de detalle devuelve como máximo un elemento, por lo que has_more normalmente es false y next_cursor normalmente es null.
curl -X POST "https://api.socq.ai/v1/google-ad-library/ad" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR10449491775734153217"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this detail operation returns at most one itemCasos de uso de la Google Ad Library Ad API
- Enriquecer una creatividad seleccionada: Use el ID de la creatividad, la referencia del anunciante, el texto, el destino, el formato, el contenido multimedia y la URL de origen para completar un registro de anuncio descubierto previamente.
- Revisar la evidencia pública de entrega: Compare las fechas, los países, las ubicaciones y las impresiones disponibles para documentar dónde y cuándo se observó públicamente una creatividad conocida.
- Archivar instantáneas de creatividades: Almacene los campos normalizados de texto, contenido multimedia, anunciante, entrega, destino y collected_at para compararlos después en momentos concretos.
Consejos de expertos para la Google Ad Library Ad API
- Envíe la URL completa de la creatividad y no un identificador CR suelto ni la URL del anunciante, para que el host y la ruta /creative/ pasen la validación.
- Trate por separado una tarea exitosa sin elementos y un error del proveedor; una creatividad eliminada, restringida o no disponible puede no producir ningún registro utilizable.
- Conserve como nulos los campos de entrega, texto, destino, anunciante, impresiones y contenido multimedia, en lugar de convertir los valores públicos ausentes en cero o en afirmaciones vacías.
- Use la búsqueda de anunciantes y los anuncios de empresa para tareas de descubrimiento o de inventario; esta operación de detalle resuelve deliberadamente solo la creatividad enviada.
APIs relacionadas
Además de la Google Ad Library Ad API, use estas APIs cuando necesite otro tipo de datos públicos de Google Ad Library.
- Google Ad Library Advertiser Search API — Descubre anunciantes candidatos del Transparency Center por consulta y región opcional, con campos de identidad, sitio web, logotipo, región y cantidad de anuncios disponible.
- Google Ad Library Company Ads API — Recolecta creativos públicos del Transparency Center por dominio de empresa o ID de anunciante, con controles de tema, región, fecha, superficie, formato y límite de resultados.