Como configurar parâmetros de URL dinâmicos para o Google Analytics e o Piano Analytics

1. O que é um parâmetro de URL dinâmico na Nonli?#

Os parâmetros de URL dinâmicos permitem adicionar automaticamente parâmetros de rastreio aos URL publicados com a Nonli. Ajudam o Google Analytics, o Piano Analytics ou outra ferramenta de análise a identificar a origem do clique, a rede social, a conta de rede social, o bot que gerou a publicação ou o link curto associado.

Estes parâmetros estão desativados por predefinição: só são adicionados quando uma marca os configura explicitamente. Passam então a fazer parte do plano de marcação de análise do cliente, e o cliente deve verificar se os parâmetros escolhidos, a sua CMP e a ferramenta de medição de destino cumprem as suas próprias obrigações de conformidade.

Podem ser usados com publicações normais, publicações geradas por bots e flying links.

2. Como configurar parâmetros de URL dinâmicos na Nonli?#

2.1. Aceder às definições de URL da marca#

Clique no menu hambúrguer, aceda a «Brands», selecione a marca que pretende configurar e desloque-se para baixo até «URL settings» (definições de URL).

2.2. Criar uma regra de parâmetro#

Cada regra define:

• o tipo de parâmetro: ? para um parâmetro de consulta de URL normal ou # para uma âncora como xtor;
• a origem do tráfego: uma rede específica, ou «All» para aplicar a regra a todas as origens;
• a chave do parâmetro: por exemplo utm_source, utm_medium, utm_campaign, utm_content, utm_term, at_creation, mtm_campaign ou xtor;
• o valor: um valor fixo ou um valor dinâmico calculado a partir da publicação.

💡 Recomendamos selecionar «All» como origem do tráfego quando o valor dinâmico já contém a rede social ou a conta. Assim evita duplicar a mesma configuração rede a rede.

2.3. Compreender como a Nonli adiciona parâmetros aos links#

Quando a Nonli constrói o link final, analisa o URL de destino, a marca e a origem do tráfego, e depois adiciona os parâmetros que correspondem às regras configuradas.

Pormenores importantes:

• se um parâmetro já existir no URL de destino, a Nonli não o substitui;
• os parâmetros ? são adicionados à query string;
• os parâmetros # só são adicionados como âncora se o URL ainda não tiver uma;
• os valores dinâmicos usam uma sintaxe de modelo com chavetas duplas.

Exemplo:

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

Esta configuração envia para a ferramenta de análise a rede social, o meio, a campanha, o autor da publicação e o identificador do link curto.

Neste exemplo, |slugify é um filtro aplicado ao valor devolvido. Transforma um texto como France News Bot em france-news-bot, sem espaços nem caracteres especiais, para que o valor se mantenha limpo e estável num URL.

3. Como configurar a Nonli para o Google Analytics?#

O Google Analytics reconhece os seguintes parâmetros UTM:

Exemplo de configuração para acompanhar as publicações da Nonli no Google Analytics:

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

Também aqui, |slugify formata automaticamente o autor antes de o adicionar a utm_content. Se a publicação vier de um bot, post.author contém o nome do bot.

4. Como configurar a Nonli para o Piano Analytics?#

O Piano Analytics pode usar o seu próprio plano de marcação ou reutilizar parâmetros UTM se a compatibilidade UTM estiver ativada na sua configuração do Piano.

São possíveis duas abordagens:

• usar os mesmos parâmetros UTM que no Google Analytics, se a sua configuração do Piano os aceitar;
• usar parâmetros dedicados ao seu plano de marcação do Piano, como parâmetros at_, mtm_ ou uma âncora xtor.

Exemplo com 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 }}

O filtro |slugify evita espaços, acentos ou caracteres especiais no valor enviado para o Piano Analytics.

Exemplo com uma âncora xtor:

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

5. Que variáveis dinâmicas estão disponíveis na Nonli?#

Estas são as variáveis mais úteis para configurar parâmetros de URL. Os parâmetros de URL usam um contexto mais restrito do que os modelos de Smart Message: organic e as funções de Smart Message indicadas em Que variáveis Twig estão disponíveis na Nonli? não estão disponíveis aqui.

5.1. Variáveis de origem do tráfego e de conta de rede social#

5.2. Variáveis da publicação#

post.user_id pode ser um identificador de utilizador normal ou um valor técnico negativo. Os principais valores a conhecer são:

5.3. Variáveis de URL e de conteúdo de origem#

5.4. Função para identificar um link na mensagem ou no primeiro comentário#

Também pode usar esta função para distinguir a localização do link:

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

6. Que filtros pode usar nos valores dinâmicos?#

Os valores dinâmicos aceitam também filtros para limpar ou transformar o resultado.

• lower: {{ post.social_account.type|lower }} converte para minúsculas.
• upper: {{ post.social_account.slug|upper }} converte para maiúsculas.
• slugify: {{ post.author|slugify }} transforma um texto num slug adequado a URL; por exemplo, France News Bot passa a france-news-bot.
• encode: {{ post.author|encode }} codifica o valor para URL.
• clean: {{ post.author|clean }} limpa o valor de texto.

7. Como adicionar parâmetros UTM, AT ou MTM com flying links?#

Os flying links permitem acompanhar automaticamente o tráfego proveniente de canais sociais que não são geridos diretamente pela Nonli, como Threads, Bluesky ou WhatsApp.

Para isso:

1. crie um URL de Destino;
2. crie um flying link por canal;
3. adicione um sufixo ao shortId, como .TH para Threads, .BS para Bluesky e .WA para WhatsApp;
4. configure o parâmetro dinâmico nas definições de URL da marca.

Exemplos de redirecionamento:

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

7.1. Adicionar o algoritmo de marcação#

Nas definições de URL da marca, cole o algoritmo abaixo como valor dinâmico do parâmetro at_creation, ou do parâmetro de rastreio que pretende preencher.

Deteta os sufixos dos flying links (.WA, .BS, .TH) e devolve o canal correto. Se não for encontrado nenhum sufixo específico, recorre ao tipo de rede social da publicação.

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 -%}