Las métricas de tu feed, en tu propio GA4.

Agregar gtm-id al embed

Es el único paso que se hace en tu página, y es una línea.

<story-feed
  endpoint="https://api.storyfeedmedia.com/api/v1/feed?client=TU_CLIENTE"
  client="TU_CLIENTE"
  gtm-id="GTM-XXXXXX"></story-feed>

1. Abrí tu CMS y entrá a la página o plantilla donde está el <story-feed>. Si no sabés cuál es, abrí esa página en el navegador y buscá el feed: el bloque que lo contiene es el que tenés que editar.
2. Copiá el snippet de arriba, pegalo en ese bloque y reemplazá TU_CLIENTE y GTM-XXXXXX por tus valores reales.
3. Guardá y publicá la página. Si tu sitio tiene caché o CDN, vaciala: si no, el cambio no se va a ver.
4. Abrí la página en el navegador y apretá F12 → pestaña Console: no debe aparecer ningún console.warn sobre gtm-id.

• gtm-id tiene que matchear el formato GTM-XXXXXX. Un valor inválido solo deja un console.warn y no carga nada.
• Si tu página ya carga ese mismo contenedor con tu propio snippet, el componente lo detecta y no lo vuelve a cargar.
• Con varios <story-feed> en la página, el mismo gtm-id se carga una sola vez.

Triggers en tu GTM

Creá triggers tipo Custom Event para los eventos del feed. Hay dos modalidades válidas: la agrupada es la más rápida.

page_view|card_view|story_view|story_click|feed_engagement|reel_mute_toggle|feed_load_more|feed_end|feed_error|share

1. Entrá a tagmanager.google.com con la cuenta que administra tu sitio y clickeá tu contenedor (si tenés varios, el que usa tu página).
2. En el menú de la izquierda clickeá Triggers y después New, arriba a la derecha.
3. Clickeá Trigger Configuration —el panel gris de la izquierda— y elegí Custom Event en la lista que se abre.
4. En Event name pegá la expresión de arriba (botón Copiar) y marcá Use regex matching. Es case-sensitive: los nombres van en minúscula y con guion bajo.
5. En This trigger fires on dejá All Custom Events marcado, que es el valor por defecto.
6. Clickeá Save, arriba a la derecha. Si elegís la opción b, repetí los puntos 2 a 6 con el nombre exacto de cada evento —p. ej. card_view— hasta tener los 10 triggers.
7. Cuando esté listo: botón naranja Submit, esquina superior derecha → Publish → poné un nombre de versión (p. ej. StoryFeed triggers) → Publish de nuevo. Hasta publicar, en tu página no se dispara nada de esto.

Variables de capa de datos

Los parámetros llegan anidados bajo eventModel.<param> por interoperabilidad entre gtag.js y GTM. Creá Data Layer Variables con estos nombres:

• eventModel.sfm_client
• eventModel.item_id
• eventModel.item_slug
• eventModel.item_type
• eventModel.cursor
• eventModel.muted
• eventModel.error_code
• eventModel.error_message
• eventModel.page_location
• eventModel.page_title
• eventModel.method
• eventModel.content_type (solo share)

1. Clickeá New dentro de la sección User-Defined Variables —no confundir con Built-In Variables, que están arriba y no se pueden editar—.
2. Clickeá Variable Configuration y elegí Data Layer Variable en la lista de tipos.
3. En Data Layer Variable Name escribí exactamente eventModel.sfm_client: los puntos y las minúsculas importan.
4. Dejá el resto como está y clickeá Save arriba a la derecha.
5. Repetí los puntos 1 a 4 con cada parámetro de la lista de arriba que quieras usar —como mínimo eventModel.sfm_client y los de contenido (item_id, item_slug, item_type)—.
6. No hace falta publicar por cada variable: al final del paso 4 vas a hacer Submit → Publish con todo junto.

Tag GA4 que reenvía a tu propiedad

Creá uno o varios GA4 Event tags con esto:

1. Primero, tu Measurement ID: entrá a analytics.google.com → Admin (engranaje, esquina inferior izquierda) → columna Property → Data streams → clickeá tu stream web → copiá el Measurement ID (G-…), arriba a la derecha.
2. Volvé a tagmanager.google.com → menú Tags → New → Tag Configuration → elegí Google Analytics: GA4 Event.
3. En Measurement ID pegá el G-… que copiaste. Este es tu ID: si pegás el de otra propiedad —o el de StoryFeed—, la medición se duplica o se va donde no debe.
4. En Event Name escribí el mismo nombre del evento —p. ej. card_view—, o —si armaste el trigger agrupado— usá la variable integrada Event (activala en Variables → Configure).
5. En Event Parameters clickeá Add row: en Parameter name escribí sfm_client y en Value clickeá el ícono de variables —el ladrillo— y elegí eventModel.sfm_client. Repetí con item_id y item_slug.
6. Clickeá Triggering, debajo de la configuración → Choose a trigger → seleccioná los triggers del paso 2 —con el trigger agrupado, elegí ese—.
7. Clickeá Save arriba a la derecha; después Submit → Publish para que las variables, los triggers y este tag pasen a estar activos en tu página.

Custom definitions en tu GA4

Los parámetros viajan en el hit, pero GA4 solo los muestra en reportes y exploraciones si los registrás en Admin → Custom definitions como dimensiones personalizadas de alcance Evento. Mínimo: sfm_client. Recomendado sumar item_id, item_slug y item_type. Sin este paso los datos existen pero no aparecen en los reportes estándar.

1. Entrá a analytics.google.com con la cuenta de tu medio y clickeá Admin, el engranaje de la esquina inferior izquierda.
2. En la columna Property —la del medio, no la de Cuenta— buscá el bloque Data display y clickeá Custom definitions.
3. Clickeá el botón Create custom dimension.
4. Completá los tres campos: Dimension name = sfm_client —es el nombre que vas a ver en los reportes—, Scope = Event y Event parameter = sfm_client.
5. Clickeá Save y repetí los puntos 3 a 5 con item_id, item_slug y item_type.
6. Estas dimensiones se aplican a los eventos que lleguen después de crearlas: los eventos de prueba que mandaste antes no aparecen en los reportes con su valor.

Verificar

Cinco chequeos, en este orden:

1. En tagmanager.google.com → tu contenedor, clickeá Preview, arriba a la derecha: se abre Tag Assistant en otra pestaña. Pegá ahí la URL de tu página y clickeá Connect.
2. Interactuá con el feed —scroll, clic en una card, mute de un reel—. En el panel izquierdo del Tag Assistant tenés que ver los Custom Events (card_view, story_click…) y, en Tags Fired, tu tag GA4.
3. En analytics.google.com → Reports, menú de la izquierda → Realtime: tus eventos deberían aparecer ahí en pocos segundos. Si tu sitio corre en modo debug, también en Admin → DebugView.
4. Antes de cerrar, volvé a Submit → Publish en GTM: los cambios guardados pero no publicados no se aplican a tus visitantes reales.
5. Si en Tag Assistant no ves ni el gtm.js, revisá la CSP de tu sitio: tiene que permitir https://www.googletagmanager.com en script-src y connect-src —donde se configuren los headers: nginx, Apache, panel de hosting o tu CMS—.