Saltar al contenido

Módulo Google Ads para PrestaShop: cookies y API

0,00 €

Gratuito · PrestaShop · Versión 0.4.0

Mide compras pagadas con navegador/cookies, API o ambos. Elige etiqueta directa, gtag existente o Google Tag Manager, con Consent Mode v2 y conversiones mejoradas.

El modo navegador no necesita OAuth. La API requiere autorización y configuración adicional. Añádelo al carrito y completa el pedido gratuito con tu cuenta: incluye ZIP instalable y guía con utilidad OAuth.

SKU: NDC-PS-GOOGLEADS Categoría:

Descripción

PrestaShop · Gratuito · 0.4.0

Una sola configuración para medir compras por navegador, por API o combinando las dos fuentes.

Google tagGoogle Tag ManagerConsent Mode v2Conversiones mejoradasData Manager API

Ver instalación y opciones

Empieza por navegador: no necesita OAuth. Para usar API o ambos, completa la autorización y comprueba el destino de Google Ads. La medición multifuente depende de su disponibilidad en tu cuenta.

Guía de instalación y configuración

Compras pagadas mediante navegador, Data Manager API o ambos. Documentación revisada el 27 de octubre de 2026. Desarrollado por Nivel de Calidad. No es un módulo oficial de Google.

Elige cómo medir

Opción Qué hace Requisitos
Navegador / cookies Envía la compra al volver a la confirmación, cuando el servidor acredita el pago. ID AW, etiqueta de compra y consentimiento. No necesita OAuth ni cron.
Solo API Encola pedidos pagados y los procesa desde el servidor. OAuth Data Manager, destino autorizado, identificadores consentidos y cron.
Navegador + API Combina ambas fuentes usando el mismo pedido, importe y acción de conversión. Todos los requisitos anteriores y acceso multifuente de Google Ads para la acción WEBPAGE.

Google ofrece la medición multifuente con disponibilidad sujeta a la cuenta. No basta con tener OAuth: hay que conectar la fuente adicional en la acción de Google Ads. Una acción offline UPLOAD_CLICKS se admite en Solo API; no se mezcla con otra acción web contando la misma compra. La opción Ambos bloquea esa combinación.

Instalar o actualizar

  1. Haz copia de los archivos y la configuración. En PrestaShop, abre Módulos → Gestor de módulos → Subir un módulo y selecciona ndcgoogleads-prestashop-0.4.0.zip, sin descomprimir.
  2. Si ya estaba instalado, utiliza Actualizar. No lo restablezcas ni borres sus tablas: conservan la deduplicación.
  3. Entra en Configurar. Elige tienda concreta si hay multitienda. Las instalaciones nuevas empiezan desactivadas y en Validación. Una actualización conserva la integración API existente.
  4. Configura modo, consentimiento, destino e importe. Verifica con Tag Assistant antes de pasar a Producción. Limpia la caché/CCC de PrestaShop tras actualizar JavaScript.

Compatibilidad declarada: PrestaShop 1.7.8–8.2 y PHP ≥7.4 con cURL y OpenSSL. Entorno de despliegue verificado: PrestaShop 8.2.3/PHP 8.1.34. No se declara certificación para PrestaShop 9, otros temas o todas las pasarelas.

Tres implementaciones en navegador

1. Etiqueta directa

Selecciona Directa e introduce AW-123456789 y el label de la acción de compra. NDC crea la cola de consentimiento y carga gtag.js cuando corresponde. Reutiliza una biblioteca Google existente. La compra se envía expresamente a AW-ID/LABEL; no usa una compra genérica de GA4.

2. Reutilizar gtag.js existente

Selecciona Reutilizar. El módulo configura el destino y genera la compra, pero no instala la biblioteca. Si no encuentra Google tag, muestra existing_tag_missing en diagnóstico y no da la compra por enviada. El responsable de la etiqueta externa debe respetar el consentimiento antes de cargarla.

3. Google Tag Manager

Selecciona GTM. NDC genera eventos dataLayer, pero no instala el contenedor ni publica etiquetas en él. En el contenedor configura una etiqueta de conversión Google Ads con disparador Evento personalizado ndc_ads_purchase. Fija el ID AW y label de la misma acción del módulo.

Campo de la etiqueta GTM Variable dataLayer, versión 2
Valor ndc_ads.value
Moneda ndc_ads.currency
ID de transacción ndc_ads.transaction_id
Email ya codificado, si EC está habilitado ndc_ads.user_data.sha256_email_address
Datos de cesta, opcionales ndc_ads.items, ndc_ads.discount, ndc_ads.aw_merchant_id, ndc_ads.aw_feed_country, ndc_ads.aw_feed_language

Configura la variable de datos proporcionados por el usuario con email SHA-256 ya normalizado. No vuelvas a aplicar hash. Usa Conversion Linker cuando tu instalación de GTM lo requiera. Desactiva otro disparador que envíe la misma compra a la misma acción. No uses “todas las páginas” para la conversión. Los eventos opcionales del embudo se llaman ndc_ads_view_item, ndc_ads_add_to_cart, etc.; nunca equivalen a un pago.

El contenedor debe gestionar consentimiento mediante una plantilla CMP y las API nativas setDefaultConsentState/updateConsentState. El evento informativo ndc_ads_consent no concede consentimiento por sí mismo. Publica el contenedor solo después de probarlo en Vista previa. NDC limpia su objeto dataLayer después de cada evento para no reutilizar datos de otro pedido.

Consentimiento v2

Las cuatro señales son analytics_storage, ad_storage, ad_user_data y ad_personalization. Por defecto se deniegan. En Básico, NDC no carga Google ni emite la compra sin permiso publicitario. En Avanzado puede emitir señales sin cookies cuando se deniega el permiso; no incluye email ni cesta en ese caso. Elegir Avanzado requiere que encaje con la configuración de tu banner. Las etiquetas ajenas a NDC tienen su propio comportamiento y deben revisarse.

CookiesPlus: configura las categorías GTM del banner. NDC lee la elección explícita más reciente; rechaza elecciones caducadas, malformadas o con fechas futuras. Un conflicto con la misma fecha se resuelve denegando. Prueba aceptar, rechazar, consentimiento parcial y retirada.

CMP propio: comunica el estado inicial y cada cambio. No llames “granted” antes de la decisión real. Puedes emitir el evento aunque NDC aún no esté cargado, guardando también el estado:

window.NDCConsentState = {
  analytics_storage: 'denied', ad_storage: 'denied',
  ad_user_data: 'denied', ad_personalization: 'denied'
};
window.dispatchEvent(new CustomEvent('ndc:consent', {
  detail: window.NDCConsentState
}));

Con NDC ya cargado, también puedes usar NDCGoogleAds.setConsent(estado). En Solo API sigue siendo necesaria la captura del permiso y de los identificadores en la visita. API no significa medición sin consentimiento.

Pagos, importes y duplicados

La URL de confirmación o pulsar Pagar no acreditan una compra. El servidor verifica tienda, autorización del pedido, firma temporal y estado pagado. No expone la clave del pedido al código de medición. Si el pago sigue pendiente, el navegador reconsulta durante el primer minuto. Si el cliente cierra la página o la pasarela confirma más tarde, el navegador puede perder esa compra; la API, correctamente autorizada, cubre ese caso con los datos consentidos disponibles.

El valor se calcula en el servidor: productos netos tras descuentos, total sin IVA o total con IVA. Productos netos excluye envío y envoltorio. Ambas fuentes usan la misma configuración. El ID predeterminado es NDC-{shop_id}-{order_id}: distingue también los pedidos divididos. No cambies este formato con pedidos en cola. Si conservas una etiqueta externa de compra, su ID debe coincidir exactamente.

El navegador evita duplicar hooks en una misma página. Al recargar reutiliza el ID; Google deduplica dentro de la misma acción. No crees dos acciones primarias para las dos fuentes. El modo Validación no emite conversiones del navegador; en API usa validateOnly. Una validación no se reenvía automáticamente al pasar a producción.

Conversiones mejoradas y cesta

Activa conversiones mejoradas en Google Ads y comprueba las condiciones de datos antes de marcarlo en el módulo. NDC puede enviar email normalizado y SHA-256 hexadecimal únicamente con permiso publicitario. El email en claro no aparece en la respuesta del navegador. El hash también es un dato protegido: no debe copiarse en informes de diagnóstico.

Datos de cesta es opcional. Requiere que los IDs coincidan con Merchant Center: producto-combinación, producto padre o SKU. Configura Merchant ID, país e idioma del feed. Usa valor Productos netos. NDC envía precio de línea sin impuestos ni envío, descuento de pedido separado y cantidad. Con cesta, gtag usa un único evento purchase dirigido a la acción Ads; sin cesta usa conversion. No envía ambos para el mismo pedido. En GTM debes activar y mapear los campos de cesta de su etiqueta.

Autorizar la API

  1. En tu proyecto de Google Cloud, habilita Data Manager API. Configura Google Auth Platform y crea un cliente OAuth de escritorio para la utilidad incluida.
  2. Descarga el JSON del cliente en tu ordenador. Ejecuta con Python 3: python3 oauth-google.py client_secret.json credenciales-privadas.json. Autoriza con un usuario que tenga acceso a la cuenta propietaria de la conversión.
  3. La utilidad abre tu navegador, usa PKCE y un callback local 127.0.0.1, y guarda el resultado con permisos privados. Solicita solo https://www.googleapis.com/auth/datamanager. No subas los JSON al servidor web ni los envíes por chat.
  4. Introduce Client ID, Client Secret y Refresh Token en Configurar → API opcional. Los secretos se cifran en la base de datos; dejar el campo vacío conserva el valor anterior.
  5. Completa cuenta propietaria, MCC de acceso si aplica e ID numérico de acción. En multifuente el ID corresponde a la misma acción WEBPAGE que AW/label. Comprueba la fuente adicional y su elegibilidad en Google Ads; un OAuth válido no garantiza esa disponibilidad.
  6. Empieza en Validación. Programa el cron HTTPS POST de la configuración con su cabecera privada X-NDC-Cron-Key, cada minuto. Después valida un pedido nuevo y pasa a Producción. Las aplicaciones OAuth en pruebas pueden tener autorizaciones de corta duración; prepara la publicación/verificación que corresponda en Google.

El envío conserva fecha real, importe y transactionId; utiliza Data Manager v1/events:ingest. Guarda requestId y distingue validación, bloqueo, reintento y aceptación. Un HTTP correcto o un callback de gtag no demuestran recepción ni atribución. Revisa diagnóstico en Google Ads. Multifuente puede tener un periodo inicial de 14 días con comportamiento de puja/ajustes limitado.

Abonos y conservación

La opción de ajustes solo se admite con API multifuente. Conserva el ID original y rectifica el valor acumulado después de confirmar manualmente que la compra original existe en Ads; no elimina el número de conversiones. No admite reimportar como compra un abono offline. En modo navegador los abonos se concilian por separado.

Los registros de deduplicación se conservan al desinstalar. La API elimina identificadores antiguos mediante el cron, según las ventanas del módulo. Solo navegador no guarda contextos API ni IDs de clic en la base de datos. Si retiras la integración API, revisa los identificadores guardados y aplica la conservación correspondiente; el módulo desactivado no ejecuta la limpieza del cron.

Comprobar la instalación

  1. Sesión limpia: rechazar no debe cargar el destino Ads en Básico. Aceptar publicidad debe habilitarlo; retirar detiene las nuevas compras consentidas.
  2. En Tag Assistant comprueba el destino y las señales. En GTM, además, confirma el disparador y las variables en Vista previa.
  3. Pedido nuevo pagado: comprueba ID, moneda e importe. Pedido pendiente/anulado: sin compra. Repite la confirmación: mismo transactionId.
  4. Consola: NDCGoogleAds.diagnostics(). simulation no envía; awaiting_payment espera; queued_browser_not_receipt indica encolado, no recepción. GTM muestra queued_gtm_requires_configured_tag.
  5. API: comprueba primero OAuth y validación, luego requestId/diagnóstico de recepción. No cambies todas las acciones a primarias ni reenvíes históricos para “probar”.

Con otros módulos NDC antiguos, el runtime compartido debe admitir la etiqueta creada por NDC Google Ads 0.4. La distribución incluye un runtime compatible; actualiza el runtime compartido de los otros módulos mediante su mantenimiento, preservando sus cambios específicos. En el despliegue de Laura se aplica una adaptación mínima al runtime GA4 existente.

Fuentes oficiales consultadas