Consentl

Consentl en Ghost

Añada Consentl a Ghost con la inyección de código, o en el tema para que el cargador sea el primero en el <head>, y vea qué funciones de Ghost no retiene.

Cargador el primero en el <head>
Depende del método
Método ¿El primero en el <head>? Plan
A. Inyección de código No: cerca del final del <head> (dentro de {{ghost_head}}) Todos los planes y autoalojado
B. default.hbs del tema Sí Ghost(Pro) Publisher o superior (temas personalizados), o autoalojado

Por qué el método A suele bastar. Ghost genera la inyección de código del encabezado del sitio al final de {{ghost_head}}. Casi todos los scripts que Ghost genera antes son diferidos (Portal, la búsqueda, la barra de anuncios, los recursos de las tarjetas, los recuentos de comentarios, la atribución de miembros, las analíticas web de Ghost), por lo que un cargador síncrono de Consentl se ejecuta igualmente antes que ellos. Ejecutarse primero no significa que Consentl los retenga: son scripts propios de Ghost y Consentl no los bloquea (consulte Limitaciones). Las excepciones son Stripe.js (solo cuando las suscripciones de pago están activadas) y cualquier <script> que su tema coloque por encima de {{ghost_head}}.

Su clave del sitio de Consentl está en la página Configuración inicial de su sitio en el panel de control. Añada el nombre de host de la publicación en el campo Dominios; www. y el dominio sin www cuentan como el mismo sitio, así que no hace falta añadir www. por separado.

Qué cubre su plan de Consentl

  • Free: solo banner, registro de consentimientos y bloqueo manual.
  • Pro: añade Google Consent Mode v2.
  • Business: añade el bloqueo automático de rastreadores conocidos y las reglas de bloqueo que añada en el panel de control.

En Free y Pro, solo se retienen las etiquetas que marque manualmente.

A. Inyección de código

  1. Ghost Admin → Settings → Code injection (en Ghost 5 y 6, en Advanced; haga clic en Open).

  2. En Site header, pegue el cargador como primera línea:

    <script src="https://api.consentl.com/v1/loader.js?k=SITE_KEY&l=en"></script>

    Si el sitio también utiliza la plantilla de Consentl para GTM, añada &gcm=ext a la URL para que solo la plantilla envíe comandos de Consent Mode.

  3. Save.

  4. Compruebe si su tema tiene etiquetas <script> por encima de {{ghost_head}} en default.hbs. Si cargan rastreadores, utilice el método B.

B. Tema (realmente el primero)

  1. Descargue su tema: Settings → Site → Theme → Change theme → Installed y, después, descargue el tema activo desde su menú.

  2. En default.hbs, pegue el cargador justo después de <meta charset="utf-8">:

    <head>
    <meta charset="utf-8">
    <script src="https://api.consentl.com/v1/loader.js?k=SITE_KEY&l={{@site.locale}}"></script>

  3. Comprima el tema en un zip y súbalo. Elimine la versión de la inyección de código si la había añadido.

Extras

  • Enlace «Configuración de cookies»: añada un elemento de navegación (Settings → Site → Navigation, navegación secundaria) con la URL #consentl. Los enlaces cuya URL termina en #consentl o #consentl-preferences, y cualquier elemento con el atributo data-consentl-open, abren las preferencias.

  • Declaración de cookies: añada una HTML card a su página de política de cookies:

    <div data-consentl-declaration data-api="https://api.consentl.com" data-key="SITE_KEY" data-locale="en"></div>
<script src="https://api.consentl.com/v1/blocks.js" defer></script>

    Utilice en su lugar data-consentl-request o data-consentl-withdrawal para el formulario de solicitudes sobre datos personales o el formulario de desistimiento de la UE. El formulario de desistimiento requiere el plan Pro o superior y debe activarse en el panel de control; de lo contrario, queda vacío.

  • La inyección de código por entrada o por etiqueta se ejecuta después del encabezado del sitio; allí no hace falta nada.

Comprobar que funciona

Abra la publicación en una ventana privada: aparece el banner. Vea el código fuente para comprobar dónde está el cargador.

La región del visitante se obtiene de su dirección IP: Consentl consulta el país en memoria en cada vista de página (no se almacena nada) y aplica la regla que haya definido para él en el panel de control. No se distingue entre estados de EE. UU.: los visitantes de EE. UU. reciben su regla para todo EE. UU. o, si no la hay, su primera regla de un estado de EE. UU. Un país desconocido recibe su regla para las regiones desconocidas (opt-in de forma predeterminada).

Limitaciones

  • La atribución de miembros almacena el historial de navegación antes del consentimiento. Cuando el seguimiento del origen de los miembros de Ghost está activado, member-attribution.min.js guarda las páginas que ha visto un visitante en sessionStorage (ghost-history) desde la primera vista de página, para poder atribuir un registro posterior. Consentl no lo retiene. Desactive el seguimiento del origen de los miembros (en los ajustes de analíticas de Ghost Admin; el ajuste se llama de forma parecida a «Member sources» / «track member sources», compruebe la etiqueta actual en su versión de Ghost), o trátelo como una decisión jurídica propia y descríbalo en su política de cookies.

  • Las analíticas web de Ghost (Tinybird, ghost-stats) no utilizan cookies y las carga el propio Ghost; el bloqueo automático de Consentl no las cubre. Desactívelas en Settings → Analytics si su evaluación jurídica exige consentimiento.

  • Stripe.js es necesario para las suscripciones de pago y es estrictamente necesario para los pagos; no se bloquea.

  • Portal (registro e inicio de sesión de miembros) no se bloquea. No hemos podido confirmar en la documentación de Ghost qué cookies o qué almacenamiento utiliza. Compruébelo en DevTools → Application (Cookies, Local Storage, Session Storage) en una visita nueva y después de iniciar sesión, y enumere lo que encuentre en su declaración de cookies.

  • Etiquetas escritas directamente. Un <script src>, un píxel <img> o un <iframe> escrito en la inyección de código, en el tema o en una HTML card lo obtiene el navegador antes de que ningún script pueda detenerlo, aunque Consentl impida que se ejecute. Marque manualmente esas etiquetas y elimine los píxeles en <noscript>:

    <script type="text/plain" data-consentl="marketing" src="https://ads.example.com/tag.js"></script>
<iframe data-consentl="marketing" data-src="https://www.youtube-nocookie.com/embed/ID" title="Video"></iframe>
<img data-consentl="marketing" data-src="https://tracker.example.com/pixel.gif" alt="" width="1" height="1">

    Las etiquetas cargadas por código (GTM, el cargador JavaScript de un píxel) se retienen sin solicitud cuando el bloqueo automático está activado (plan Business y superiores).

  • Ghost(Pro) Starter no permite subir temas personalizados, por lo que solo está disponible el método A.

¿Se ha atascado? Escriba a support@consentl.com: respondemos en inglés en días laborables.