Cómo instalar y configurar el plugin de WordPress¶
El plugin AdPulse sGTM hace que su sitio WordPress sirva los scripts de Google Tag Manager desde su propio dominio y reenvíe las solicitudes al servidor de tags de AdPulse. Esto mantiene la carga en primera parte, en lugar de depender de un dominio de terceros.
Interfaz del plugin en inglés
El panel del plugin está disponible solo en inglés. Los nombres de campo citados más abajo son exactamente los que aparecen en WordPress. El panel de AdPulse, a su vez, está disponible solo en portugués — sus etiquetas se citan tal como aparecen en el producto.
Prerrequisitos¶
- Un contenedor de servidor creado en el panel de AdPulse y con estado Ativo.
- El ID numérico de ese contenedor — aparece en la página del contenedor y en las instrucciones de integración.
- WordPress 5.8 o superior y PHP 7.4 o superior.
Paso a paso¶
- En el panel de WordPress, vaya a Plugins → Añadir nuevo → Subir plugin y suba el ZIP descargado desde wordpress.org/plugins/adpulse — o busque AdPulse sGTM en el directorio y haga clic en Instalar ahora.
- Haga clic en Activar.
- En el menú lateral de WordPress, abra AdPulse → Settings.
- Marque Enable AdPulse sGTM integration.
- En Container ID, informe el ID numérico de su contenedor — por ejemplo,
12345. - Haga clic en Save Settings.
Dónde está el ID del contenedor
En el panel de AdPulse: Server GTM → Contêineres → haga clic en el contenedor → el ID aparece en la parte superior de la página, junto al ID do contêiner destacado.
Qué empieza a ocurrir en su sitio¶
Con el plugin activado, WordPress sirve el script de GTM en https://<su-sitio>/c/gtm.js y reenvía todo lo que llega en /c/ al servidor de tags de AdPulse, en el contenedor que usted configuró.
La propia página de configuración muestra la URL resultante en la sección Status, en la línea GTM URL.
Referencia de configuración¶
| Campo | Predeterminado | Descripción |
|---|---|---|
| Enable AdPulse sGTM integration | desactivado | Activa la inyección de los scripts de GTM en las páginas. |
| Container ID | vacío | ID numérico del contenedor server-side en el panel de AdPulse. |
| Proxy Path | /c/ |
Ruta de su sitio en la que se sirve GTM. |
| Proxy Timeout | 15 |
Tiempo máximo, en segundos (1 a 60), de espera de la respuesta del servidor de tags. |
| Include visitor IP address when consent is granted | activado | Envía el IP del visitante a GTM solamente cuando se concedió el consentimiento. |
La sección Status de la misma página muestra el estado del plugin (Active/Inactive), la versión instalada, el ID configurado y la URL de GTM.
Cambiar la ruta del proxy¶
Si cambia Proxy Path, las reglas de URL de WordPress deben regenerarse — se actualizan en la activación y en la desactivación del plugin. Después de guardar la nueva ruta, vaya a Ajustes → Enlaces permanentes y haga clic en Guardar cambios sin modificar nada, o desactive y reactive el plugin.
Solución de problemas¶
| Situación | Qué significa | Qué hacer |
|---|---|---|
| "Plugin is enabled but no Container ID is set." | El plugin está activado, pero sin ID de contenedor. | Informe el Container ID en AdPulse → Settings y guarde. |
Aviso "Container ID not configured" o página en error 400/500 en la ruta /c/ |
El plugin recibió una solicitud sin contenedor configurado. | Confirme el ID y guarde la configuración. |
| El script de GTM no carga en la página | El plugin está desactivado o la ruta del proxy cambió sin regenerar las reglas. | Active el plugin y regenere las reglas de enlaces (vea arriba). |
| El servidor de tags responde lento o expira | El tiempo de espera es corto para su región o para su tema. | Aumente Proxy Timeout (hasta 60 segundos). |
| GTM no aparece en ciertas páginas | El plugin inyecta el script en las páginas generadas por WordPress. | Confirme que la página es servida por WordPress y no por una caché estática pre-renderizada. |
| El ID está correcto pero no se rastrea nada | El contenedor aún no está en Ativo en el panel de AdPulse. | Verifique el estado del contenedor en Server GTM → Contêineres. |
URL del dashboard
El plugin muestra un enlace al panel de AdPulse. La dirección actual es app.adpulse.com.br.