Analytics Debugger
Open Source

Google Tag Linker

Decodifica, lee y gestiona los parámetros del linker de Google Tag sin cargar la librería gtag.js completa. Perfecto para entornos server-side, configuraciones con consentimiento e implementaciones de tracking personalizadas.

Tracking cross-domain, decodificado

01

Decodificación del Linker

Parsea y decodifica el parámetro _gl del linker de Google para extraer client IDs y datos de sesión.

02

Sin gtag.js

Funciona de forma independiente — no necesitas cargar la librería completa de Google solo para soporte cross-domain.

03

Preparada para Server-Side

Diseñada para casos de uso server-side donde necesitas leer valores del linker desde URLs o cookies.

04

Soporte TypeScript

Completamente tipada con declaraciones TypeScript para una gran experiencia de desarrollo.

Simple API, powerful results

Installation

terminal
npm install @analytics-debugger/google-tag-linker
# or
bun add @analytics-debugger/google-tag-linker

Read linker from URL

client.js
import { GoogleTagLinker } from
  "@analytics-debugger/google-tag-linker";

const linker = new GoogleTagLinker();

// Read linker values from the current URL
const linkerValues = linker.read(window.location.href);

console.log(linkerValues);
// {
//   clientId: "123456789.1234567890",
//   sessionId: "1234567890",
//   timestamp: 1234567890,
//   ...
// }

Server-side usage

server.js
// Server-side: read linker from request
import { GoogleTagLinker } from
  "@analytics-debugger/google-tag-linker";

export function handleRequest(req) {
  const linker = new GoogleTagLinker();
  const url = req.url;

  // Extract cross-domain tracking data
  const data = linker.read(url);

  if (data.clientId) {
    // Use the client ID from the
    // originating domain
    console.log("Client:", data.clientId);
  }
}

Hablemos

Tanto si necesitas una implementación desde cero, una auditoría de tu configuración actual o asesoramiento experto — estamos aquí para ayudarte.