Descripción
Analytics Head es una extensión de WordPress deliberadamente sencilla para Google Analytics. Sin paneles, sin conexión a una cuenta de Google, sin funciones de más — solo el código de seguimiento, colocado exactamente donde lo necesitas.
¿Por qué usar esta extensión?
- Ligera — un puñado de opciones, sobrecarga mínima, sin dependencias externas
- Fácil — pega tu ID de medición de GA4 (G-XXXXXXXXXX) y listo
- Ubicación en la cabecera por defecto — necesaria para la verificación de Google Search Console mediante Analytics
- Flexible — ubicación en el pie de página, ocultación por perfiles, modo de consentimiento v2, ID opcionales de Google Ads
- Pensada para desarrolladores — filtros y acciones para personalizar la salida sin bifurcar la extensión
A diferencia de las suites de analítica pesadas, esta extensión hace bien una sola cosa: insertar el fragmento estándar de gtag.js en tu sitio.
Características
- Compatibilidad con ID de etiqueta de Google / medición de GA4 (GT-…, G-XXXXXXXXXX)
- ID de seguimiento adicionales para destinos separados (p. ej. Google Ads AW-)
- Aceptación de ID UA- heredados (con aviso de administración para migrar)
- Código en
<head>por defecto (ubicación opcional en el pie de página) - El seguimiento nunca se inserta en wp-admin
- Ocultar el seguimiento para administradores en el front-end
- Ocultar el seguimiento por perfil de usuario
- Valores predeterminados del modo de consentimiento de Google v2 (para extensiones de RGPD / cookies)
- Conservar los ajustes al desinstalar (opcional)
- Ganchos y filtros para desarrolladores
Servicios externos
Esta extensión se conecta a Google Analytics (mediante Google Tag Manager / gtag.js) para ofrecer analítica del sitio web.
- Cuándo: solo en las vistas de página públicas del front-end (nunca en el área de administración de WordPress), a menos que el seguimiento esté oculto para el visitante actual por los ajustes de la extensión
- Qué se envía: datos de medición estándar de Google Analytics (por ejemplo URL de la página, referente, información del navegador/dispositivo y ubicación derivada de la IP), procesados por Google
- Quién lo recibe: Google LLC / Google Analytics
- Términos del servicio: https://marketingplatform.google.com/about/analytics/terms/us/
- Política de privacidad: https://policies.google.com/privacy
Eres responsable de informar a los visitantes (por ejemplo en tu política de privacidad) y, cuando sea necesario, de obtener el consentimiento. También se ofrece un texto sugerido de política de privacidad en Ajustes Privacidad cuando la extensión está activa.
Requisitos
- WordPress 6.3 o posterior (compatible con WordPress 7+)
- PHP 7.4 o posterior
Ejemplos
Filtrar los ID de seguimiento
add_filter( 'pp_google_analytics_head_tracking_ids', function( $ids ) {
// Add a separate destination only — not a second ID for the same Google tag.
$ids[] = 'AW-123456789';
return $ids;
} );
Cambiar los valores predeterminados del modo de consentimiento (PHP)
add_filter( 'pp_google_analytics_head_consent_defaults', function( $defaults ) {
$defaults['wait_for_update'] = 2000;
$defaults['region'] = [ 'PL', 'DE', 'US-CA' ];
return $defaults;
} );
Conceder el consentimiento después de que el usuario acepte las cookies (JavaScript)
Llama a esto desde el callback de tu extensión de consentimiento o desde el manejador «Aceptar» de tu banner personalizado. Actualiza los cuatro tipos que esta extensión establece como denegados por defecto:
gtag('consent', 'update', {
analytics_storage: 'granted',
ad_storage: 'granted',
ad_user_data: 'granted',
ad_personalization: 'granted'
});
Si solo quieres analítica básica (no anuncios), concede analytics y mantén los anuncios denegados:
gtag('consent', 'update', {
analytics_storage: 'granted',
ad_storage: 'denied',
ad_user_data: 'denied',
ad_personalization: 'denied'
});
Modificar la configuración gtag en línea
add_filter( 'pp_google_analytics_head_inline_script', function( $script, $ids ) {
$script .= "gtag('event','page_view');";
return $script;
}, 10, 2 );
Capturas
Instalación
- Sube el directorio
analytics-heada/wp-content/plugins/ - Activa la extensión desde el menú Plugins de WordPress
- Ve a Ajustes Analytics Head
- Introduce tu ID de medición de GA4 (G-XXXXXXXXXX)
- Guarda — el seguimiento comienza de inmediato
FAQ
-
¿Cómo obtengo un ID de medición?
-
Inicia sesión en Google Analytics, crea una propiedad GA4 para tu sitio y copia el ID de medición (formato
G-XXXXXXXXXX) o el ID de etiqueta de Google (GT-…) desde Administración Flujos de datos. Usa solo un ID por etiqueta de Google — no introduzcas a la vez los ID GT- y G- que pertenecen a la misma etiqueta. -
¿Por qué colocar el código en la sección head?
-
Google Search Console puede verificar la propiedad del sitio mediante tu etiqueta de Analytics, pero solo cuando la etiqueta está en el
<head>. Puedes moverla al pie de página en cualquier momento desde los ajustes de la extensión. -
¿Necesito conectar mi cuenta de Google?
-
No. Esta extensión solo inserta el fragmento de seguimiento — sin OAuth, sin claves de API, sin inicio de sesión en Google.
-
¿Cómo funciona el modo de consentimiento?
-
Activa el modo de consentimiento v2 en Privacidad, en los ajustes de la extensión. Antes de que se cargue gtag.js, esta extensión establece:
analytics_storagedeniedad_storagedeniedad_user_datadeniedad_personalizationdeniedwait_for_update500 ms
El script de seguimiento sigue cargándose (así funciona el modo de consentimiento). Hasta que se otorgue el consentimiento, Google solo recibe señales limitadas, sin cookies.
Cuando el visitante acepta las cookies, tu extensión de RGPD / banner de cookies (o JavaScript personalizado) debe llamar a
gtag('consent', 'update', …)y conceder los mismos cuatro tipos de almacenamiento (consulta Ejemplos). Conceder soloanalytics_storageyad_storagedejaría los datos de usuario de anuncios / la personalización denegados de forma permanente.La mayoría de las extensiones modernas de consentimiento que admiten el modo de consentimiento de Google ya lo hacen por ti. Activa el modo de consentimiento aquí y, a continuación, activa el modo de consentimiento de Google / el soporte de Analytics en tu extensión de consentimiento.
-
¿Bloquea el script de Analytics hasta el consentimiento?
-
No. El modo de consentimiento no es un bloqueo estricto. El script siempre se inserta; los valores predeterminados de consentimiento empiezan como denegados y se actualizan después. Si necesitas retrasar o eliminar el script hasta el consentimiento, usa una extensión de consentimiento que bloquee las etiquetas de forma estricta, o filtra
pp_google_analytics_head_tracking_idspara devolver una lista vacía hasta que se otorgue el consentimiento. -
¿Qué extensiones de RGPD funcionan con esta?
-
Cualquier extensión que pueda ejecutar
gtag('consent', 'update', …)después de que el usuario acepte — por ejemplo Complianz, CookieYes, Borlabs Cookie, Cookiebot (cuando el modo de consentimiento de Google está activado en esa extensión). No hay un puente propietario hacia un único proveedor; nos mantenemos ligeros y usamos la API estándar de Google. -
¿Y si sé PHP?
-
Ganchos y filtros disponibles (consulta la sección Ejemplos para el código):
pp_google_analytics_head_before— acción, antes de encolar los scriptspp_google_analytics_head_after— acción, después de encolar los scriptspp_google_analytics_head_inline_script— filtro, modifica el script de configuración gtag en línea ($script,$ids)pp_google_analytics_head_tracking_ids— filtro, modifica la lista de ID de medición / anuncios ($ids,$options)pp_google_analytics_head_consent_defaults— filtro, modifica los valores predeterminados del modo de consentimiento (analytics_storage,ad_storage,ad_user_data,ad_personalization,wait_for_update,regionopcional con códigos de región ISO 3166-2)pp_google_analytics_head_roles— filtro, modifica los perfiles disponibles en los ajustes de visibilidad
Nota: El antiguo filtro HTML
pp_google_analytics_head_outputse eliminó en la versión 1.7.0 (era incompatible conwp_enqueue_script). Usa en su lugarpp_google_analytics_head_inline_scriptopp_google_analytics_head_tracking_ids. -
¿Es gratuita?
-
Sí, GPLv2 o posterior. Las donaciones son bienvenidas, pero nunca obligatorias.
Reseñas
Colaboradores y desarrolladores
«Analytics Head» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores
«Analytics Head» está traducido en 1 idioma. Gracias a los traductores por sus contribuciones.
Traduce «Analytics Head» a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
1.7.0
- Fecha de lanzamiento: 28-07-2026
- Nombre mostrado cambiado a Analytics Head (directrices de nomenclatura de WordPress.org)
- Compatibilidad con ID de etiqueta de Google / GA4 (GT-, G-) e ID de Google Ads (AW-)
- Requisito de WordPress 6.3+ y PHP 7.4+; estrategia de script async; probado con WordPress 7+
- Traducciones mediante WordPress Polyglots (se eliminaron los archivos de idioma incluidos)
- Salida mediante wp_enqueue_script con estrategia async real (gtag en línea encolado como antes)
- Los ID de seguimiento se resuelven una vez durante wp_enqueue_scripts (funcionan los filtros tardíos / etiquetas condicionales)
- Valores predeterminados del modo de consentimiento v2 para integración con extensiones de RGPD / cookies (incluida región opcional)
- Sin seguimiento en wp-admin; visibilidad en el front-end por perfiles mediante wp_roles()
- Opción de conservar los ajustes al desinstalar (limpieza por lotes en multisitio)
- Documentación de servicios externos y texto de ayuda de la política de privacidad
- Los ID no válidos ya no borran los valores guardados previamente; validación de filtros reforzada
1.6.7
- Fecha de lanzamiento: 21-11-2018
- Etiqueta de compatibilidad establecida