Un solo error de formato en tu archivo ads.txt puede activar la supresión de pujas de los DSP y eliminar un porcentaje significativo de tus ingresos publicitarios programáticos - silenciosamente, sin mensaje de error en tu sitio. ads.txt es un archivo de texto plano con reglas de análisis estrictas, y la mayoría de los editores solo descubren los problemas por caídas de CPM inexplicables en su panel publicitario. Esta guía cubre todos los métodos para comprobar archivos ads.txt, los errores que más importan y cómo mantener el archivo saludable a largo plazo.
¿Qué es ads.txt?
ads.txt significa Authorized Digital Sellers (Vendedores Digitales Autorizados). Es un archivo de texto plano alojado en la raíz de tu dominio - `yourdomain.com/ads.txt` - que lista cada ad exchange, red y plataforma del lado de la oferta (SSP) autorizada para vender inventario publicitario en tu sitio web. El IAB Tech Lab introdujo el estándar en 2017 específicamente para combatir la suplantación de dominio: una forma de fraude publicitario donde actores maliciosos venden inventario fingiendo proceder de un dominio de editor premium que no poseen.
Cuando una plataforma del lado de la demanda (DSP) o un anunciante hace una puja programática, su sistema comprueba el archivo ads.txt del editor antes de gastar. Si la entidad vendedora listada en la solicitud de puja no aparece en el archivo ads.txt, el comprador o salta la puja por completo o aplica un descuento significativo. Un archivo ausente, una entrada mal configurada o un registro desactualizado se traducen directamente en menores fill rates y CPM efectivos reducidos.
El formato de línea de ads.txt
Cada línea de un archivo ads.txt válido sigue un formato preciso de cuatro campos. Entender la estructura es esencial para detectar errores - la mayoría de los problemas de validación provienen de líneas que se desvían de este patrón exacto.
# Format: domain, publisher-account-id, account-type, authority-id
# account-type must be DIRECT or RESELLER
# authority-id (TAG-ID) is optional but strongly recommended
google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0
appnexus.com, 1234, RESELLER, f5ab79cb980f11d1
openx.com, 540191398, RESELLER, 6a698e965929
# Lines starting with # are comments - ignored by parsers
# [email protected]
# SUBDOMAIN=sub.yourdomain.com- domain: El dominio raíz del sistema publicitario (p. ej. `google.com`, no `ads.google.com`).
- publisher-account-id: Tu ID de cuenta o editor en esa red publicitaria.
- account-type: O `DIRECT` (tienes un contrato directo) o `RESELLER` (vendido vía intermediario).
- authority-id: El TAG-ID o Seller Account ID opcional pero recomendado del Trustworthy Accountability Group. Omitirlo reduce la confianza del comprador.
Note
Por qué los errores de ads.txt cuestan ingresos
La aplicación de ads.txt en el ecosistema programático no es uniforme - distintos DSP tratan los archivos inválidos de forma diferente, lo que hace que el impacto en ingresos sea difícil de predecir y fácil de pasar por alto hasta que los CPM caen notablemente. Entender cómo responden los compradores a los errores explica por qué vale la pena comprobar ads.txt con regularidad.
Cómo responden los DSP a los problemas de ads.txt
- Archivo ausente (404): La mayoría de los DSP importantes tratan un ads.txt ausente como "inventario sin verificar". Algunos omiten la puja por completo; otros pujan a un precio mínimo fuertemente descontado.
- Formato de línea inválido: Las líneas con número incorrecto de campos o valores de tipo de cuenta inválidos se omiten en silencio - la entrada se trata como si no existiera.
- Discrepancia DIRECT vs RESELLER: Si una red vende como DIRECT pero tu archivo los lista como RESELLER (o viceversa), los compradores marcan la discrepancia y reducen la confianza en el inventario.
- authority-id faltante: El programa TAG Certified Channels exige authority-ids. Los compradores que aplican la certificación TAG omiten las entradas sin ellos.
- Redirección a la página de inicio: Una redirección 301 o 302 desde /ads.txt a la página de inicio se trata como archivo ausente por la mayoría de los rastreadores.
Los compradores de publicidad digital pueden usar ads.txt para determinar si una oportunidad de compra de medios digitales está autorizada por el editor y si se permite a los revendedores vender el inventario del editor.
Google AdSense y las advertencias de ads.txt
Google AdSense es especialmente estricto con la aplicación de ads.txt. Si tu ID de editor de AdSense no está listado correctamente en tu archivo ads.txt, AdSense muestra una advertencia en el panel y puede reducir la publicación en tus espacios de anuncios aprobados. La entrada requerida de AdSense sigue este formato exacto: `google.com, pub-XXXXXXXXXXXXXXXXX, DIRECT, f08c47fec0942fa0`. El authority-id `f08c47fec0942fa0` es el TAG-ID fijo de Google - debe aparecer exactamente como está escrito.
Warning
Cómo comprobar tu archivo ads.txt
Comprobar ads.txt requiere dos verificaciones separadas: accesibilidad (¿es el archivo alcanzable en la URL correcta?) y validez (¿está cada línea formateada correctamente?). Ambas comprobaciones son rápidas y pueden hacerse en menos de dos minutos con las herramientas adecuadas.
Verifica que el archivo sea accesible en el dominio raíz
Abre un navegador en modo incógnito y navega a `yourdomain.com/ads.txt`. El archivo debería cargarse como texto plano sin envoltorio HTML, sin solicitud de inicio de sesión y sin redirección. Si ves un 404 o el archivo redirige a tu página de inicio, el ads.txt no es accesible para los rastreadores de plataformas publicitarias, independientemente de que exista en tu servidor. Revisa la configuración de tu servidor web - muchos sitios de WordPress redirigen accidentalmente todas las rutas no definidas a la página de inicio mediante reglas de `.htaccess`.
Pega el archivo en el validador de Ads.txt de Aback Tools
Copia el contenido completo de tu archivo ads.txt - desde el navegador o directamente de tu servidor - y pégalo en el validador de Ads.txt. La herramienta analiza cada línea contra la especificación del IAB, marca conteos de campos incorrectos, valores de tipo de cuenta inválidos y entradas duplicadas, y reporta cada error con su número de línea. Tus datos se procesan completamente en el navegador - nada se sube a un servidor.
Cruza con tu lista de socios publicitarios
Compara las entradas validadas con las líneas de ads.txt actuales proporcionadas por cada red publicitaria que uses. La mayoría de las redes publican sus entradas requeridas de ads.txt en su documentación para editores o su panel. Las redes ocasionalmente actualizan sus entradas requeridas - un cambio de dominio o un nuevo authority-id - y los editores pasan por alto la actualización. Una discrepancia entre lo que lista tu archivo y lo que una red exige actualmente causa la misma supresión de pujas que una entrada faltante.
Corrige los errores y vuelve a verificar la accesibilidad
Corrige cada error reportado, vuelve a subir el archivo al directorio raíz de tu servidor y navega de nuevo a `yourdomain.com/ads.txt` para confirmar que el archivo actualizado está en vivo. Espera 24-48 horas para que las principales plataformas publicitarias re-rastreen el archivo antes de esperar la recuperación de ingresos. Usa el validador una segunda vez sobre el archivo en vivo para confirmar que ningún error de subida introdujo problemas nuevos.
Validador de Ads.txt
Valida archivos ads.txt en busca de errores de formato, tipos de cuenta inválidos, entradas duplicadas y campos requeridos faltantes - local en el navegador, sin subida.
Errores comunes y cómo corregirlos
La mayoría de los problemas de ads.txt caen en un número reducido de patrones repetitivos. Cada uno tiene una causa específica y una solución específica - una vez que sabes qué buscar, se resuelven en minutos.
Número de campos incorrecto
El error más común es una línea con el número incorrecto de campos separados por comas. Cada línea debe tener exactamente tres campos requeridos (dominio, ID de cuenta, tipo de cuenta) y un campo opcional (authority-id). Las líneas de dos campos (solo dominio e ID de cuenta) y las de cinco campos (campos extra añadidos por errores de copiar-pegar) fallan ambas la validación. Revisa cada línea que tu validador marque - a menudo el problema es una coma suelta o una coma faltante de una edición manual.
Valor de tipo de cuenta inválido
El campo de tipo de cuenta acepta solo dos valores: `DIRECT` y `RESELLER`. Los parsers que no distinguen mayúsculas aceptan `direct` y `reseller`, pero la especificación del IAB recomienda mayúsculas. Cualquier otro valor - `DIRECT/RESELLER`, `Partner`, `Network` o un vacío - falla la validación y la línea se omite por completo por los parsers conformes. Revisa cada línea marcada y corrige el valor exactamente a `DIRECT` o `RESELLER` según tu relación contractual con esa red.
Archivo servido desde la ruta incorrecta o con Content-Type incorrecto
El archivo ads.txt debe ser accesible exactamente en `yourdomain.com/ads.txt` - no en `/ads.txt.php`, no en `/ads-txt`, no en una ruta de subdirectorio. El servidor debería devolver un estado `200 OK` con un `Content-Type` de `text/plain`. Algunas plataformas de hosting sirven los archivos `.txt` con `application/octet-stream`, que algunos rastreadores rechazan. Usa el validador de Robots junto a tu comprobación de ads.txt - si robots.txt tiene problemas de accesibilidad similares, probablemente tengas un problema de configuración del servidor que afecta a todos los archivos `.txt` en la raíz.
| Error | Lo que reporta el validador | Solución |
|---|---|---|
| Número de campos incorrecto | La línea tiene 2 campos, se esperaban 3-4 | Añade el dominio, ID de cuenta o tipo faltante |
| Tipo de cuenta inválido | "partner" no es DIRECT ni RESELLER | Cámbialo a DIRECT o RESELLER |
| Entrada duplicada | Duplicado de la línea 12 | Elimina la línea duplicada |
| Redirección / 404 | Archivo no accesible en /ads.txt | Corrige el enrutamiento del servidor o .htaccess |
| Caracteres Unicode ocultos | Carácter inesperado en la posición 8 | Reescribe la línea - no copies desde PDFs |
| Entrada de subdominio incorrecta | Usa la directiva SUBDOMAIN= en su lugar | Añade el comentario SUBDOMAIN=sub.dominio.com |
| TAG authority-id faltante | Authority-id recomendado | Añade el TAG-ID de la documentación de la red |
Caracteres ocultos y problemas de codificación
Un problema de ads.txt particularmente difícil son las líneas que se ven correctas visualmente pero fallan el análisis porque contienen caracteres Unicode ocultos - espacios de no separación, espacios de ancho cero o comillas tipográficas - introducidos al copiar y pegar desde un PDF, un documento de Word o un correo de texto enriquecido. La mayoría de los editores de texto no muestran estos caracteres. Si una línea falla la validación sin un error de formato evidente, reescríbela manualmente en lugar de copiar y pegar. La herramienta de reparación Unicode y de codificación puede eliminar caracteres Unicode invisibles del texto pegado antes de ponerlo en tu archivo ads.txt.
app-ads.txt y sellers.json
ads.txt fue diseñado para editores web. El ecosistema publicitario programático extendió el estándar a dos especificaciones relacionadas: app-ads.txt para inventario de aplicaciones móviles y sellers.json para la transparencia de la cadena de suministro. Entender los tres formatos te ayuda a construir un panorama completo de autorización.
app-ads.txt para editores de aplicaciones móviles
Los desarrolladores de aplicaciones móviles usan app-ads.txt en lugar de ads.txt. El formato del archivo es idéntico - la misma estructura de línea de cuatro campos, los mismos tipos de cuenta DIRECT/RESELLER, el mismo campo authority-id. La diferencia está en el descubrimiento: para apps, las plataformas publicitarias buscan la URL del sitio web del desarrollador en el listado de la App Store o Google Play y comprueban si hay app-ads.txt en la raíz de ese dominio. Alojas app-ads.txt en tu sitio web de desarrollador, no en la app en sí. Usa el validador de App-ads.txt para comprobar la autorización del inventario de apps móviles con las mismas reglas de validación.
sellers.json - el complemento de la cadena de suministro
sellers.json es el complemento de ads.txt desde la otra dirección: las redes publicitarias y los SSP publican un archivo sellers.json en su propio dominio listando todos los editores (vendedores) que representan. Un comprador puede cruzar tu entrada RESELLER de ads.txt con el sellers.json del SSP para verificar que la cadena de suministro es legítima. Aunque como editor no creas sellers.json, entenderlo explica por qué importa tener authority-ids correctos en tu ads.txt - se usan para emparejar tus entradas con los registros de sellers.json.
Note
Monitorear la salud de ads.txt
Una comprobación puntual de ads.txt no basta - las entradas de las redes cambian, se incorporan nuevos socios y la accesibilidad del archivo puede romperse tras actualizaciones del servidor o del CMS. Construir una rutina ligera de monitoreo previene pérdidas de ingresos silenciosas entre auditorías manuales.
Advertencias del panel de Google AdSense
El panel de AdSense muestra un banner de advertencia de ads.txt si tu ID de editor falta en tu archivo ads.txt o si el archivo no es accesible. Revisa el panel de AdSense tras cualquier migración de servidor, actualización del CMS o cambio de `.htaccess` - estos son los tres eventos más comunes que rompen la accesibilidad de ads.txt sin que el editor lo note. La advertencia aparece en la sección "Cuenta" de la configuración de AdSense.
Notificaciones de socios programáticos
La mayoría de los SSP y redes publicitarias importantes envían notificaciones por correo cuando cambian sus entradas requeridas de ads.txt. Suscríbete a las notificaciones de actualización del portal de editores de cada socio si está disponible. Cuando un socio actualiza su dominio o authority-id, normalmente otorgan una ventana de migración de 30-90 días antes de que las entradas antiguas dejen de honrarse - pero solo los editores que están monitoreando captarán el cambio a tiempo.
Flujo de auditoría técnica
Incluye la validación de ads.txt en tu auditoría técnica de SEO trimestral junto con robots.txt, la validación del sitemap y las comprobaciones de etiquetas canónicas. Usa el explicador de conflictos de reglas de Robots.txt para verificar que ninguna regla de robots.txt bloquee accidentalmente a los rastreadores de plataformas publicitarias, y el validador de Sitemap para revisar la salud del sitemap en la misma sesión. Estos archivos viven al mismo nivel de raíz del servidor y a menudo se ven afectados por los mismos eventos de mala configuración.
Tip
Buenas prácticas de ads.txt
Seguir estas prácticas mantiene tu archivo ads.txt preciso, accesible y efectivo - maximizando la elegibilidad de pujas mientras proteges tu inventario de revendedores no autorizados.
Mantén el archivo ligero y actualizado
Elimina las entradas de las redes publicitarias con las que ya no trabajas. Un ads.txt sobredimensionado con decenas de entradas inactivas no daña directamente los ingresos, pero aumenta la superficie de error y dificulta la auditoría del archivo. Cuando te desvinculas de una red, elimina sus entradas al mismo tiempo que retiras sus etiquetas publicitarias de tus páginas - trata ambas como parte del mismo proceso de desvinculación.
Usa siempre authority-ids cuando estén disponibles
El TAG authority-id (también llamado TAG-ID o Seller Account ID) es técnicamente opcional en la especificación de ads.txt, pero los DSP importantes prefieren entradas que lo incluyan. Permite a los compradores verificar toda la cadena de suministro desde el editor hasta el exchange mediante el cruce con sellers.json. Cada red publicitaria importante publica su authority-id en su documentación para editores - inclúyelo en cada entrada donde esté disponible.
- Una entrada por línea: Nunca combines varias redes en una sola línea - cada relación de vendedor autorizado tiene su propia línea.
- Valida antes de cada subida: Ejecuta el validador de Ads.txt sobre el archivo antes de subirlo para capturar errores introducidos durante la edición.
- Usa codificación UTF-8 sin BOM: Guarda el archivo como UTF-8 simple. Un BOM (Byte Order Mark) al inicio del archivo puede romper el análisis en algunos rastreadores de plataformas publicitarias.
- No uses espacios finales: Muchos editores de texto añaden espacios finales invisibles. Pueden causar fallos de análisis por línea en validadores estrictos.
- Control de versiones para tu ads.txt: Mantén ads.txt en el repositorio de control de versiones de tu sitio. Un historial de git te permite rastrear exactamente cuándo se añadió o eliminó una entrada si los ingresos caen inesperadamente.
Validador de App-ads.txt
Valida archivos app-ads.txt para inventario publicitario de aplicaciones móviles - mismas reglas de formato que ads.txt, optimizado para el contexto del editor de apps móviles.
Key takeaways
- ads.txt lista todos los vendedores autorizados de tu inventario publicitario - las entradas faltantes o inválidas hacen que los DSP omitan pujas o desciunten tus CPM.
- Verifica primero la accesibilidad: navega a `tudominio.com/ads.txt` y confirma que carga como texto plano con estado 200, sin redirección y sin envoltorio HTML.
- Usa el validador de Ads.txt para comprobar cada línea por errores de formato, tipos de cuenta inválidos y duplicados - todo el procesamiento ocurre en tu navegador.
- Los cinco errores más comunes son el número incorrecto de campos, valores de tipo de cuenta inválidos, el archivo servido en la ruta incorrecta, caracteres Unicode ocultos y authority-ids faltantes.
- Google AdSense requiere la entrada exacta `google.com, pub-XXXXXXXXXXXXXXXXX, DIRECT, f08c47fec0942fa0` - el authority-id `f08c47fec0942fa0` es fijo y debe coincidir exactamente.
- Para aplicaciones móviles, usa app-ads.txt con el mismo formato alojado en la raíz de tu sitio de desarrollador, descubierto vía el listado de tu tienda de apps.
- Revalida ads.txt tras cada migración de servidor, actualización del CMS o cambio de hosting - estos son los eventos más comunes que rompen silenciosamente la accesibilidad del archivo.