Plugin AdSense Admin Blogger

Cómo usar el Plugin AdSense Admin Shortcodes en NichoClean v2.0 — Guía completa

NichoClean v2.0 incluye un sistema nativo llamado AdSense Admin Shortcodes pensado para centralizar la configuración de tus anuncios y facilitar la inserción de bloques de AdSense (o placeholders) en cualquier parte de la plantilla sin tocar múltiples archivos. Esta guía explica cómo funciona internamente, cómo instalarlo en tu plantilla, cómo configurar sus parámetros data-*, dónde colocar los marcadores (shortcodes) y cómo depurar los problemas más frecuentes.

Requisitos y advertencias

  • Tener una cuenta de Google AdSense (para publicar anuncios reales con data-monetized="true").
  • Hacer una copia de seguridad de la plantilla antes de modificarla (siempre).
  • Respetar las políticas de Google AdSense: no inducir a clics, evitar anuncios superpuestos con contenido interactivo, y revisar límites de anuncios por página.
  • Incluir la llamada oficial al script de Google AdSense, imprescindible para cargar anuncios, tal como se explica en Cómo insertar AdSense.

Cómo funciona el plugin Adsense en Blogger

Resumen del flujo interno:

  1. Existe un gadget oculto en la plantilla: <div id="config-adsense-shortcodes" hidden ...></div>. Allí se definen data-* que controlan el comportamiento global.
  2. Un script busca todos los elementos .adsense-shortcode[data-code] y, según el código (data-code), los reemplaza por el bloque de AdSense (<ins class="adsbygoogle">) o por un placeholder si data-monetized="false".
  3. Si el script detecta que window.adsbygoogle ya está disponible, intenta iniciar el render con (adsbygoogle = window.adsbygoogle || []).push({}) de forma segura (con try/catch).
  4. El sistema usa claves predefinidas de slots (por ejemplo, adsense-index-1) que se emparejan con los valores de data-slot-*.

Instalación paso a paso en NichoClean v2.0

  1. Copiar el gadget de configuración: Inserta el siguiente bloque en tu plantilla. Se recomienda colocarlo un gadget HTML/Javascript que se cargue en todas las páginas.
<div id="config-adsense-shortcodes" hidden
     data-monetized="false"
     data-client="ca-pub-XXXXXXXXXX"
     data-slot-index1="INDEX_SLOT_1"
     data-slot-index2="INDEX_SLOT_2"
     data-slot-post1="POST_SLOT_1"
     data-slot-post2="POST_SLOT_2">
</div>
<!-- Gadget: Configuración AdSense Shortcodes
Opciones:
- data-monetized="true|false" → Activar anuncios o usar placeholder.
- data-client="ca-pub-XXXXXXXXXX" → ID de cliente AdSense.
- data-slot-index1="SLOT_ID" → Slot para Index 1.
- data-slot-index2="SLOT_ID" → Slot para Index 2.
- data-slot-post1="SLOT_ID" → Slot para Post 1.
- data-slot-post2="SLOT_ID" → Slot para Post 2.
-->
  1. Pegar el script procesador: Inserta el siguiente script después del contenido del gadget o en el archivo JS global de la plantilla (que se cargue en todas las páginas). Este script es la implementación del plugin y se encarga de procesar automáticamente todos los shortcodes al cargar la página.
<script>
//<![CDATA[
document.addEventListener("DOMContentLoaded", function () {
  const config = document.getElementById("config-adsense-shortcodes");
  if (!config) return; // salir en silencio si falta gadget

  const monetized = config.dataset.monetized === "true";
  const client = config.dataset.client || "ca-pub-0000000000000000";

  const slots = {
    "adsense-index-1": config.dataset.slotIndex1 || "INDEX_SLOT_1",
    "adsense-index-2": config.dataset.slotIndex2 || "INDEX_SLOT_2",
    "adsense-post-1": config.dataset.slotPost1 || "POST_SLOT_1",
    "adsense-post-2": config.dataset.slotPost2 || "POST_SLOT_2"
  };

  document.querySelectorAll("div.adsense-shortcode[data-code]").forEach(div => {
    const code = div.dataset.code;
    const slot = slots[code];
    if (!slot) {
      div.innerHTML = `<div class="adsense-placeholder">[Slot no definido: ${code}]</div>`;
      return;
    }

    if (monetized) {
      div.innerHTML = `
        <ins class="adsbygoogle"
             style="display:block"
             data-ad-client="${client}"
             data-ad-slot="${slot}"
             data-ad-format="auto"
             data-full-width-responsive="true"></ins>
      `;
      if (window.adsbygoogle) {
        try {
          (adsbygoogle = window.adsbygoogle || []).push({});
        } catch (e) {
          console.warn("Adsense error:", e);
        }
      }
    } else {
      div.innerHTML = `<div class="adsense-placeholder">[Espacio reservado: ${code}]</div>`;
    }
  });
});
//]]>
</script>
  1. Colocar los marcadores (shortcodes) en la plantilla: Añade los <div> donde quieras que aparezcan los anuncios. Estos marcadores son independientes del CSS y puedes moverlos libremente. La plantilla NichoClean V2.0 ya incluye varios de estos marcadores en posiciones estratégicas que generan mayor rentabilidad (por ejemplo en el index y en los posts). Si deseas reubicarlos, entra en la edición de HTML de la plantilla y busca los nombres de cada marcador (adsense-index-1, adsense-index-2, adsense-post-1, adsense-post-2) para moverlos a la sección que prefieras.
<!-- Gadget index 1 -->
<div class="adsense-shortcode" data-code="adsense-index-1"></div>
<!-- algún listado de posts -->
<div class="adsense-shortcode" data-code="adsense-index-2"></div>
<!-- titulo de post -->
<div class="adsense-shortcode" data-code="adsense-post-1"></div>
<!-- contenido post -->
<div class="adsense-shortcode" data-code="adsense-post-2"></div>

Qué editar en el gadget: explicación de data-*

El gadget #config-adsense-shortcodes controla todo. Estos son los atributos y qué hacen:

  • data-monetized="true|false": activa anuncios reales (true) o placeholders (false). Útil para hacer pruebas sin violar políticas de AdSense.
  • data-client="ca-pub-XXXXXXXXXXXX": tu ID de editor AdSense (obligatorio para anuncios reales).
  • data-slot-index1, data-slot-index2: IDs de slot para posiciones en páginas de listados/index.
  • data-slot-post1, data-slot-post2: IDs de slot para posiciones dentro de entradas individuales.

Ejemplos prácticos y lugares recomendados para colocar anuncios

Algunas ubicaciones comunes y por qué:

  • Index / Listados: entre bloques de artículos o al final de la lista (adsense-index-1, adsense-index-2).
  • Debajo del título del post: buena visibilidad, usar con moderación (adsense-post-1).
  • Dentro del contenido: después del primer, segundo párrafo o al final del contenido como lo tiene la plantilla nichoclean por defcto (adsense-post-2).

Posición de los marcadores en una entrada con la plantilla NichoClean:

 <!-- Título principal -->
<h1 class='post-title' itemprop='headline'><data:post.title/></h1>
<!-- Adsense post1 -->
<div class='adsense-shortcode' data-code='adsense-post-1'/>
....
 <!-- Final del contenido -->
<data:post.body/>
<!-- adsense post2 -->
<div class='adsense-shortcode' data-code='adsense-post-2'/>

Modo prueba (placeholders) — cómo usarlo

Si quieres maquetar o probar sin mostrar anuncios reales, pon data-monetized="false" en el gadget. En este modo, todos los shortcodes válidos mostrarán un bloque con el texto [Espacio reservado: ...], lo que te permite diseñar y revisar el posicionamiento sin cargar AdSense.

Cuando uses data-monetized="true" (modo real), el script intentará renderizar el anuncio correspondiente. Si el marcador no tiene un slot definido en el gadget (por ejemplo un data-code inexistente), en lugar del anuncio se mostrará [Slot no definido: ...].

Depuración y errores comunes

  • Mensaje en placeholder: [Slot no definido: adsense-index-1]
    Sale cuando el data-code de un marcador no tiene un data-slot-* correspondiente en el gadget #config-adsense-shortcodes. Revisa que los nombres coincidan exactamente y que no haya errores tipográficos.
  • Anuncios no aparecen (div vacío o solo placeholder):
    Puede pasar si data-monetized="false" (modo prueba), el ID de cliente data-client es incorrecto o si el script de AdSense no está cargado en la plantilla.
  • Warnings en consola al hacer adsbygoogle.push({}):
    El script envuelve la llamada en try/catch para que no rompa la página. Normalmente estos warnings indican problemas con la configuración de AdSense, slots repetidos o bloqueadores de anuncios activos.
  • Anuncios repetidos o no renderizados tras reinsertar contenido:
    El JS del Plugin Adsense Blogger solo procesa los anuncios que ya están en la página cuando esta se carga. Si agregas nuevos anuncios después (por ejemplo al hacer "cargar más"), no se mostrarán automáticamente.

Optimización y buenas prácticas

  • No abuses de la cantidad de anuncios por página; prioriza la experiencia de usuario y velocidad.
  • Probar siempre en móvil y escritorio: el bloque usa data-ad-format="auto" para ser responsive, pero revisa apariencia.
  • Evita colocar anuncios justo encima de elementos con acción (botones, formularios) para reducir clics accidentales.
  • Usa data-monetized="false" para maquetación antes de poner el site en producción.
  • Si cambias slots, evita hacerlo frecuentemente sin necesidad para mantener coherencia estadística en AdSense.

Preguntas frecuentes (FAQ)

  1. ¿Puedo desactivar anuncios solo en ciertas entradas?
    No directamente con el script. Para que ciertos anuncios no se muestren, tendrías que eliminar o no incluir los marcadores en esas páginas desde la edición de la plantilla.
  2. ¿Puedo usar tamaños específicos en vez de auto?
    No, el script inserta data-ad-format="auto" por defecto y no permite cambiar tamaños dinámicamente.
  3. ¿Funciona con AMP?
    No. AMP requiere componentes <amp-ad> y este script no los genera.
  4. ¿Qué hago si veo errores en la consola sobre AdSense?
    El script envuelve el push de AdSense en try/catch para que no rompa la página. Aun así, revisa que el ID de cliente data-client sea correcto y que no tengas bloqueadores de anuncios activos.

El plugin AdSense Admin Blogger en NichoClean v2.0 te permite centralizar la configuración de anuncios, probar posiciones con placeholders y desplegar bloques de AdSense de forma segura y ordenada. Siguiendo esta guía podrás instalarlo en tu plantilla, configurar los data-*, insertar los marcadores y depurar los errores comunes.

¿Qué sigue?

  1. Pega el gadget de configuración en tu plantilla.
  2. Agrega marcadores donde quieras mostrar anuncios.
  3. Inserta el script procesador en tu plantilla o archivo global.
  4. Modifica el data-client y los data-slot en el gadget con los IDs de tus anuncios reales.