Analytics Debugger
Open Source

Consent String

Un decodificador ligero y sin dependencias para el parámetro gcd que Google envía en los hits de Consent Mode. Consulta el estado efectivo de cada señal de consentimiento y si viene de un default, de un update o si nunca se configuró.

Consent Mode, decodificado

01

Decodificación del gcd

Convierte un valor gcd de 12 caracteres como 13l3l3R2l5l1 en el estado efectivo de ad_storage, analytics_storage, ad_user_data y ad_personalization.

02

Default frente a Update

Mira cómo se fijó cada señal: con un default, un update, una declaración o sin configurar, además de los defaults por contenedor y el flag GPC.

03

Funciona en Cualquier Entorno

ESM, CommonJS y una versión para navegador que expone el global ConsentString, incluida una versión ES5 para navegadores antiguos.

04

Sin Dependencias

Licencia MIT, tipado completo con TypeScript y sin dependencias en tiempo de ejecución.

Simple API, powerful results

Installation

terminal
npm install @analytics-debugger/consent-string
# or
bun add @analytics-debugger/consent-string

Decode a gcd value

client.js
import * as ConsentString from
  "@analytics-debugger/consent-string";

// gcd value taken from a GA4 /collect hit
const consent = ConsentString.decode("13p3lPR2l5l1");

consent.ad_storage;        // "denied"
consent.analytics_storage; // effective state
consent.flags;             // GPC, Consent Mode active...
consent.meta;              // which commands were used

In the browser

server.js
<!-- Browser build: exposes a ConsentString global -->
<script src="https://cdn.jsdelivr.net/npm/@analytics-debugger/consent-string"></script>
<script>
  // Decode the gcd parameter of a captured hit
  var hit = new URL(requestUrl);
  var gcd = hit.searchParams.get("gcd");
  var consent = ConsentString.decode(gcd);
  console.log(consent.ad_user_data);
</script>

Pongamos tu medición en orden

Configuración server-side, APIs de conversiones, implementaciones o una auditoría de lo que ya tienes. Cuéntanos tu configuración y te diremos por dónde empezar.