Cómo exportar creatividades de anuncios de Google y conservar su evidencia de origen

Definiciones

• Creatividad: Un ítem de anuncio público. No es una campaña.
• ID de anunciante: La identidad de cuenta de Google para un anunciante.
• ID de creatividad: La identidad de Google para una creatividad de un anunciante.
• Observación: Un registro de una creatividad en el momento de la recolección.
• Puntero: Un enlace a un recurso remoto de medios o de vista previa.
• Manifiesto: Un archivo de configuración y de resumen de la recolección.
• Variación: Un ítem de medios o de vista previa dentro de un registro de creatividad. No es necesariamente una prueba de anuncio separada.
• Vista previa: Un recurso de origen que se usa para mostrar una creatividad. Puede requerir renderizado y no siempre es un archivo descargable.
• Actor: Un programa alojado de recolección de datos.
• Tarea publicada: Una configuración pública guardada de un Actor.
• **`null`**: No hay un valor utilizable disponible. No es cero.

Configuración y alcance de la recolección

Para recolectar datos de creatividades, configure un Actor como el Google Ads Transparency Scraper público. El Actor acepta de uno a cien objetivos, que pueden ser nombres, dominios, IDs, URL de anunciantes o URL de creatividades. El ajuste `maxItems` va de uno a cinco mil, con un valor predeterminado de diez compartido entre todos los objetivos.

La tarea publicada usa de forma predeterminada `nike.com`, la región `ANYWHERE`, la plataforma `ALL`, el formato de anuncio `ALL`, los detalles de entrega desactivados y un tope de veinte ítems Google Ads Creative Library Export | Ads Data. Las búsquedas por dominio pueden coincidir con varias cuentas de anunciante, así que debe usar un ID o una URL de anunciante exactos y verificados cuando investiga una cuenta específica. Use una búsqueda por dominio solo si planea revisar y separar las cuentas después. Reduzca el tope de recolección y mantenga los detalles de entrega desactivados, salvo que su investigación requiera de forma específica los metadatos de entrega. Los filtros de fecha opcionales aceptan fechas reales hasta hoy. Recuerde que un tope de recolección es un límite, no un historial completo de anuncios.

Mapa de campos y límites de los datos

Cada fila guardada asigna campos de datos específicos de la plataforma de origen. `advertiserId` y `creativeId` forman un par único de identidad de la creatividad. Nunca debe identificar una cuenta solo por el nombre de la marca. `creativeUrl` apunta a la página pública de detalle del origen. Tanto `mediaUrl` como `previewUrl` son punteros de origen remotos que pueden devolver `null`, y una vista previa puede ser un recurso JavaScript en lugar de un archivo directo. La lista `variations` y `variationCount` registran activos hijos anidados con sus URL y dimensiones, pero estos activos hijos no son variantes de campaña independientes.

Los campos `firstShownAt` y `lastShownAt` aportan, cuando están disponibles, las fechas públicas en las que se mostró, pero no garantizan una entrega continua ni el momento de la recolección. El campo `approxDaysShown` es un valor aproximado del origen y no debe convertirse en días continuos exactos, gasto en anuncios ni éxito de campaña. La marca de tiempo `observedAt` registra cuándo el Actor recolectó el registro. Los campos solicitados de región, plataforma y formato aportan contexto de la recolección, y no una lista completa de ubicaciones de entrega. Los campos `status` y `statusReason` indican la calidad de la fila, donde `ok` significa una recolección correcta y `partial` puede significar un formato ausente. Los campos opcionales del pagador pueden estar ausentes o desactivados, y un pagador no es necesariamente el anunciante. Además, el repositorio de origen de Google puede exponer campos específicos de la ubicación que este Actor no devuelve Ayuda de transparencia de Google Ads.

Claves de observación y manifiestos creados por el lector

Los IDs de anunciante y de creatividad deben tratarse como un par, porque el mismo ID de creatividad bajo dos anunciantes distintos representa dos identidades distintas. El Actor elimina los duplicados de este par solo dentro de una misma ejecución, mientras que las ejecuciones posteriores conservan una observación nueva. Como la fila del Actor no aporta un ID de ejecución, debe crear campos creados por el lector.

Cree un `collection_batch_id` creado por el lector para la agrupación de su lote. Conserve el ID real de la ejecución, la versión de compilación, la identidad del conjunto de datos, la configuración de la recolección, los momentos de recolección y el resumen de la ejecución en un manifiesto de recolección separado, creado por el lector. La clave de observación sugerida combina el ID del lote, el ID del anunciante y el ID de la creatividad. Mantenga sus comprobantes internos de la ejecución separados de su informe final de evidencia.

Almacenamiento de datos JSON y variaciones

JSON es un formato de datos de texto que conserva jerarquías estructuradas. Los archivos JSON completos conservan las variaciones anidadas, mientras que una exportación CSV es solo una vista opcional de tabla plana. Una fila de observación padre puede contener filas de variación anidadas, pero esas variaciones hijas no son pruebas separadas de creatividad ni de campaña. Conserve siempre los valores `null`, en lugar de reemplazarlos por cero o por datos inventados. Una biblioteca de visualización es una vista derivada; por eso, siempre debe conservar debajo de ella sus archivos de observación originales.

Método completo de recolección y conservación

1. Configure el alcance de su objetivo, la región, la ventana de fechas públicas y el tope de ítems. Use un ID o una URL de anunciante exactos y verificados cuando investiga una cuenta específica, y use búsquedas por dominio solo con una revisión posterior a la recolección. Mantenga los detalles de entrega desactivados, salvo que sean necesarios.
2. Realice la ejecución del Actor Google Ads Transparency Scraper con la configuración de la tarea publicada Google Ads Creative Library Export | Ads Data.
3. Registre su configuración de recolección en un manifiesto creado por el lector. Guarde el ID de la ejecución, la versión de compilación, la identidad del conjunto de datos, la configuración de la recolección, los momentos de recolección y el resumen de la ejecución por separado de su informe público de evidencia.
4. Revise los campos de resumen de OUTPUT, incluidos `creativesSaved`, `duplicatesSkipped`, `unusableCreativesSkipped`, `stopReason` y `targetOutcomes`. Mantenga separados los registros parciales, los objetivos fallidos, los resultados en cero y las detenciones por tope. Recuerde que un conjunto de datos de salida vacío o reducido no puede probar que un anunciante no publicó anuncios.
5. Aplique la regla exacta de aceptación: exija que `advertiserId`, `creativeId`, `creativeUrl` y `observedAt` no estén en blanco para una observación identificada. Revise los campos `status` y `statusReason`. Conserve los valores de `mediaUrl` o `previewUrl` que falten de forma explícita; no convierta `null` en cero ni invente un enlace. Ponga en cuarentena las filas con identidad ausente en un archivo de revisión separado, en lugar de fusionar valores en blanco.
6. Cree columnas creadas por el lector, separadas de los campos del Actor. Asigne un `collection_batch_id` creado por el lector y construya su clave de observación al combinar el ID del lote, el ID del anunciante y el ID de la creatividad.
7. Guarde archivos de observación JSON completos para conservar las variaciones anidadas. Conserve los registros de variación hijos bajo su fila de observación padre, sin contar los activos hijos como pruebas independientes de creatividad o de campaña.
8. Realice y registre verificaciones de enlaces separadas e independientes, con el momento de la verificación, el tipo de puntero, el método y el resultado. Conserve los punteros anteriores cuando lleguen punteros nuevos, y conserve los registros de observación incluso cuando los enlaces remotos dejen de estar disponibles.
9. Anexe lotes de recolección posteriores sin reemplazar sus archivos de observación anteriores. Conserve los registros históricos junto con su visualización derivada de la vista más reciente.
10. Entregue su biblioteca de origen finalizada, el manifiesto de recolección, los registros fechados de verificación de enlaces y la vista más reciente derivada al paso de informe. Use el par original de ID de anunciante y de creatividad para encontrar de nuevo el origen, y deténgase antes de cualquier puntuación de creatividades o recomendaciones de campaña.

Verificaciones de enlaces independientes y solicitudes HTTP HEAD

Cree un registro separado de verificación de enlaces que contenga la identidad padre y el lote, el tipo de puntero, el momento de la verificación, el método y el resultado. Una solicitud HTTP HEAD pide a un servidor solo las cabeceras de la respuesta, y no el contenido del archivo. Renderizar significa mostrar con éxito una vista previa dentro de un navegador. Un código de respuesta HTTP 200 significa que el recurso respondió en esa verificación, pero una respuesta `image/png` es distinta de una respuesta `application/javascript`.

Ninguna de estas respuestas prueba una imagen renderizada, la archivación permanente de un archivo, derechos de reutilización ni una disponibilidad duradera. La pequeña verificación de metadatos del 13 de octubre de 2026 guardó dos observaciones `ok` de dos cuentas, pero las verificaciones de cabeceras solo probaron respuestas fechadas, y no un historial repetido ni una cobertura completa. Descargar activos y renderizar vistas previas queda fuera del alcance de este método de enlaces de origen.

Anexar lotes posteriores y tratar punteros no disponibles

Anexe los lotes posteriores sin reemplazar sus archivos de observación anteriores. Una visualización actual puede mostrar la observación más reciente de cada par de identidad, pero debe enlazar de vuelta con los registros históricos. Cuando falla un puntero antiguo, conserve su registro de origen, registre la verificación fallida e inspeccione la página pública de origen durante una revisión posterior autorizada, si es necesario. Un puntero fallido o una observación ausente por el tope no prueba que un anuncio haya sido eliminado. No adivine URL ni intente recuperar anuncios eliminados. Como no se realizaron pruebas de ejecuciones repetidas ni pruebas de largo plazo, el ejemplo enseña únicamente el razonamiento de conservación.

Ejemplo ficticio y análisis del conteo

Todos los registros y los IDs de este ejemplo son ficticios. A/B/C1/C2 son etiquetas de enseñanza y no son datos fijos reales del origen. No se descarga ningún archivo de medios.

Esta recolección produce 5 filas de observación, calculadas como 3 filas en el lote S1 más 2 filas en el lote S2 (3 + 2 = 5). Hay 3 pares únicos de identidad de creatividad: A:C1, A:C2 y B:C1. La suma de los conteos de variación de todas las filas conservadas da 6 observaciones de variación, calculadas como 2 más 1 más 1 más 1 más 1 (2 + 1 + 1 + 1 + 1 = 6). Estas observaciones de variación son activos hijos dentro de registros padre, no 6 creatividades únicas ni pruebas de anuncio separadas.

Una vista de lo más reciente por identidad contiene 3 filas que coinciden con las 3 identidades únicas, con dos verificaciones de enlaces disponibles y fechadas y una verificación no disponible. El anunciante B:C1 sigue representado por su observación de S1, y su ausencia en el lote S2 no prueba que el anuncio haya sido eliminado. Las 5 observaciones deben conservarse en la biblioteca. Esta conservación de registros preserva registros de evidencia y punteros sin afirmar un historial completo de anuncios, un almacenamiento permanente de archivos de medios, el éxito del anuncio ni resultados de pruebas en vivo de ejecuciones repetidas.

La visibilidad pública no otorga un permiso general de reutilización Condiciones de Google: Otro contenido. Este método conserva registros de origen y punteros; descargar activos o volver a publicarlos queda fuera de este flujo de trabajo de enlaces de origen.