Cómo configurar parámetros dinámicos de URL para Google Analytics y Piano Analytics

1. ¿Qué es un parámetro dinámico de URL en Nonli?#

Los parámetros dinámicos de URL permiten añadir automáticamente parámetros de seguimiento a las URL publicadas con Nonli. Ayudan a Google Analytics, Piano Analytics u otra herramienta de analítica a identificar el origen del clic, la red social, la cuenta social, el bot que generó la publicación o el enlace corto asociado.

Estos parámetros están desactivados por defecto: solo se añaden cuando una marca los configura de forma explícita. A partir de ese momento forman parte del plan de etiquetado analítico del cliente, y este debe comprobar que los parámetros elegidos, su CMP y la herramienta de medición de destino cumplen sus propias obligaciones de cumplimiento normativo.

Se pueden usar con publicaciones normales, publicaciones generadas por bots y flying links.

2. ¿Cómo se configuran los parámetros dinámicos de URL en Nonli?#

2.1. Accede a los ajustes de URL de la marca#

Haz clic en el menú hamburguesa, ve a «Marcas», selecciona la marca que quieres configurar y desplázate hacia abajo hasta «Ajustes de URL».

2.2. Crea una regla de parámetro#

Cada regla define:

• el tipo de parámetro: ? para un parámetro de consulta de URL normal o # para un ancla como xtor;
• la fuente de tráfico: una red concreta o «Todas» para aplicar la regla a cualquier fuente;
• la clave del parámetro: por ejemplo utm_source, utm_medium, utm_campaign, utm_content, utm_term, at_creation, mtm_campaign o xtor;
• el valor: un valor fijo o un valor dinámico calculado a partir de la publicación.

💡 Te recomendamos seleccionar «Todas» como fuente de tráfico cuando el valor dinámico ya contiene la red social o la cuenta. Así evitas duplicar la misma configuración red por red.

2.3. Entiende cómo añade Nonli los parámetros a los enlaces#

Cuando Nonli construye el enlace final, analiza la URL de destino, la marca y la fuente de tráfico, y después añade los parámetros que coinciden con las reglas configuradas.

Detalles importantes:

• si un parámetro ya existe en la URL de destino, Nonli no lo sustituye;
• los parámetros ? se añaden a la cadena de consulta;
• los parámetros # se añaden como ancla solo si la URL no tiene ya una;
• los valores dinámicos usan una sintaxis de plantilla con llaves dobles.

Ejemplo:

1utm_source = {{ post.social_account.type }}
2utm_medium = social
3utm_campaign = nonli
4utm_content = {{ post.author|slugify }}
5utm_term = {{ post.short_id }}

Esta configuración envía a la herramienta de analítica la red social, el medio, la campaña, el autor de la publicación y el identificador del enlace corto.

En este ejemplo, |slugify es un filtro que se aplica al valor devuelto. Convierte un texto como France News Bot en france-news-bot, sin espacios ni caracteres especiales, de modo que el valor se mantiene limpio y estable en una URL.

3. ¿Cómo se configura Nonli para Google Analytics?#

Google Analytics reconoce los siguientes parámetros UTM:

Ejemplo de configuración para el seguimiento de las publicaciones de Nonli en Google Analytics:

1utm_source = {{ post.social_account.type }}
2utm_medium = social
3utm_campaign = nonli
4utm_content = {{ post.author|slugify }}
5utm_term = {{ post.short_id }}

Aquí también, |slugify da formato automáticamente al autor antes de añadirlo a utm_content. Si la publicación procede de un bot, post.author contiene el nombre del bot.

4. ¿Cómo se configura Nonli para Piano Analytics?#

Piano Analytics puede usar su propio plan de etiquetado o reutilizar los parámetros UTM si la compatibilidad con UTM está activada en tu configuración de Piano.

Hay dos enfoques posibles:

• usar los mismos parámetros UTM que en Google Analytics, si tu configuración de Piano los acepta;
• usar parámetros específicos de tu plan de etiquetado de Piano, como los parámetros at_, mtm_ o un ancla xtor.

Ejemplo con parámetros at_:

1at_medium = social
2at_platform = {{ post.social_account.type }}
3at_account = {{ post.social_account.slug }}
4at_campaign = nonli
5at_content = {{ post.author|slugify }}

El filtro |slugify evita espacios, tildes o caracteres especiales en el valor enviado a Piano Analytics.

Ejemplo con un ancla xtor:

1xtor = CS6-2-[{{ post.social_account.type }}]-[{{ post.social_account.slug }}]

5. ¿Qué variables dinámicas hay disponibles en Nonli?#

Estas son las variables más útiles para configurar parámetros de URL. Los parámetros de URL usan un contexto más reducido que las plantillas de Smart Message: organic y las funciones de Smart Message que se indican en ¿Qué variables de Twig hay disponibles en Nonli? no están disponibles aquí.

5.1. Variables de fuente de tráfico y de cuenta social#

5.2. Variables de la publicación#

post.user_id puede ser el identificador de un usuario normal o un valor técnico negativo. Los valores principales que conviene conocer son:

5.3. Variables de URL y de contenido de origen#

5.4. Función para identificar un enlace en el mensaje o en el primer comentario#

También puedes usar esta función para distinguir la ubicación del enlace:

1{{ isComment() ? 'comment' : 'message' }}

6. ¿Qué filtros se pueden usar en los valores dinámicos?#

Los valores dinámicos también aceptan filtros para limpiar o transformar el resultado.

• lower: {{ post.social_account.type|lower }} convierte a minúsculas.
• upper: {{ post.social_account.slug|upper }} convierte a mayúsculas.
• slugify: {{ post.author|slugify }} convierte el texto en un slug apto para URL; por ejemplo, France News Bot pasa a ser france-news-bot.
• encode: {{ post.author|encode }} codifica el valor como URL.
• clean: {{ post.author|clean }} limpia el valor de texto.

7. ¿Cómo se añaden parámetros UTM, AT o MTM con flying links?#

Los flying links permiten hacer un seguimiento automático del tráfico procedente de canales sociales que Nonli no gestiona directamente, como Threads, Bluesky o WhatsApp.

Para ello:

1. crea una URL de destino;
2. crea un flying link por cada canal;
3. añade un sufijo al shortId, como .TH para Threads, .BS para Bluesky y .WA para WhatsApp;
4. configura el parámetro dinámico en los ajustes de URL de la marca.

Ejemplos de redirecciones:

• https://myshortdomain.com/7qz.TH redirige a https://www.example.com/article?at_creation=Threads;
• https://myshortdomain.com/7qz.BS redirige a https://www.example.com/article?at_creation=Bluesky.

7.1. Añade el algoritmo de etiquetado#

En los ajustes de URL de la marca, pega el algoritmo siguiente como valor dinámico del parámetro at_creation, o del parámetro de seguimiento que quieras rellenar.

Detecta los sufijos de los flying links (.WA, .BS, .TH) y devuelve el canal correcto. Si no encuentra ningún sufijo específico, recurre al tipo de red social de la publicación.

1{%- if post.social_account.type == 'flying' -%}
2    {%- if post.short_id ends with 'WA' -%}
3        WhatsApp
4    {%- elseif post.short_id ends with 'BS' -%}
5        Bluesky
6    {%- elseif post.short_id ends with 'TH' -%}
7        Threads
8    {%- else -%}
9        {{- post.social_account.type | capitalize -}}
10    {%- endif -%}
11{%- else -%}
12    {{- post.social_account.type | capitalize -}}
13{%- endif -%}