Dynamische URL-parameters configureren voor Google Analytics en Piano Analytics

1. Wat is een dynamische URL-parameter in Nonli?#

Met dynamische URL-parameters kunt u automatisch trackingparameters toevoegen aan URL's die met Nonli worden gepubliceerd. Ze helpen Google Analytics, Piano Analytics of een andere analysetool om de klikbron, het sociale netwerk, het socialemedia-account, de bot die het bericht heeft gegenereerd of de bijbehorende korte link te herkennen.

Deze parameters zijn standaard uitgeschakeld: ze worden alleen toegevoegd wanneer een merk ze uitdrukkelijk configureert. Ze maken dan deel uit van het taggingplan voor analyses van de klant, en de klant moet controleren of de gekozen parameters, zijn CMP en de meettool op de bestemming voldoen aan zijn eigen nalevingsverplichtingen.

Ze kunnen worden gebruikt bij gewone berichten, door bots gegenereerde berichten en flying links.

2. Hoe configureert u dynamische URL-parameters in Nonli?#

2.1. De URL-instellingen van het merk openen#

Klik op het hamburgermenu, ga naar “Brands” (merken), selecteer het merk dat u wilt configureren en scrol omlaag naar “URL settings” (URL-instellingen).

2.2. Een parameterregel maken#

Elke regel bepaalt:

• het parametertype: ? voor een gewone queryparameter in de URL of # voor een anker zoals xtor;
• de verkeersbron: een specifiek netwerk, of “All” om de regel op elke bron toe te passen;
• de parametersleutel: bijvoorbeeld utm_source, utm_medium, utm_campaign, utm_content, utm_term, at_creation, mtm_campaign of xtor;
• de waarde: een vaste waarde of een dynamische waarde die op basis van het bericht wordt berekend.

💡 Wij raden aan “All” als verkeersbron te selecteren wanneer de dynamische waarde het sociale netwerk of het account al bevat. Zo hoeft u dezelfde configuratie niet per netwerk te herhalen.

2.3. Begrijpen hoe Nonli parameters aan links toevoegt#

Wanneer Nonli de definitieve link opbouwt, analyseert zij de doel-URL, het merk en de verkeersbron, en voegt zij de parameters toe die overeenkomen met de geconfigureerde regels.

Belangrijke details:

• als een parameter al in de doel-URL staat, vervangt Nonli die niet;
• ?-parameters worden aan de querystring toegevoegd;
• #-parameters worden alleen als anker toegevoegd als de URL nog geen anker heeft;
• dynamische waarden gebruiken een sjabloonsyntaxis met dubbele accolades.

Voorbeeld:

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

Deze configuratie stuurt het sociale netwerk, het medium, de campagne, de auteur van het bericht en de ID van de korte link naar de analysetool.

In dit voorbeeld is |slugify een filter dat op de teruggegeven waarde wordt toegepast. Het zet tekst zoals France News Bot om in france-news-bot, zonder spaties of speciale tekens, zodat de waarde schoon en stabiel blijft in een URL.

3. Hoe configureert u Nonli voor Google Analytics?#

Google Analytics herkent de volgende UTM-parameters:

Voorbeeldconfiguratie om Nonli-berichten in Google Analytics te volgen:

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

Ook hier formatteert |slugify de auteur automatisch voordat die aan utm_content wordt toegevoegd. Als het bericht van een bot komt, bevat post.author de naam van de bot.

4. Hoe configureert u Nonli voor Piano Analytics?#

Piano Analytics kan een eigen taggingplan gebruiken of UTM-parameters hergebruiken als UTM-compatibiliteit in uw Piano-configuratie is ingeschakeld.

Er zijn twee benaderingen mogelijk:

• dezelfde UTM-parameters gebruiken als voor Google Analytics, als uw Piano-configuratie die accepteert;
• parameters gebruiken die specifiek voor uw Piano-taggingplan zijn, zoals at_- of mtm_-parameters of een xtor-anker.

Voorbeeld met at_-parameters:

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

Het filter |slugify voorkomt spaties, accenten of speciale tekens in de waarde die naar Piano Analytics wordt gestuurd.

Voorbeeld met een xtor-anker:

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

5. Welke dynamische variabelen zijn beschikbaar in Nonli?#

Dit zijn de nuttigste variabelen om URL-parameters te configureren. URL-parameters gebruiken een kleinere context dan Smart Message-sjablonen: organic en de Smart Message-functies die worden genoemd in Welke Twig-variabelen zijn beschikbaar in Nonli? zijn hier niet beschikbaar.

5.1. Variabelen voor verkeersbron en socialemedia-account#

5.2. Berichtvariabelen#

post.user_id kan een gewone gebruikers-ID zijn of een negatieve technische waarde. De belangrijkste waarden zijn:

5.3. Variabelen voor URL en broncontent#

5.4. Functie om een link in de tekst of in de eerste reactie te herkennen#

U kunt ook deze functie gebruiken om de plaatsing van de link te onderscheiden:

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

6. Welke filters kunt u in dynamische waarden gebruiken?#

Dynamische waarden accepteren ook filters om het resultaat op te schonen of om te zetten.

• lower: {{ post.social_account.type|lower }} zet om naar kleine letters.
• upper: {{ post.social_account.slug|upper }} zet om naar hoofdletters.
• slugify: {{ post.author|slugify }} zet tekst om in een URL-vriendelijke slug; zo wordt France News Bot bijvoorbeeld france-news-bot.
• encode: {{ post.author|encode }} codeert de waarde voor gebruik in een URL.
• clean: {{ post.author|clean }} schoont de tekstwaarde op.

7. Hoe voegt u UTM-, AT- of MTM-parameters toe met flying links?#

Met flying links kunt u automatisch verkeer volgen van sociale kanalen die niet rechtstreeks door Nonli worden beheerd, zoals Threads, Bluesky of WhatsApp.

Zo doet u dat:

1. maak een Target URL aan;
2. maak één flying link per kanaal aan;
3. voeg een achtervoegsel toe aan de shortId, zoals .TH voor Threads, .BS voor Bluesky en .WA voor WhatsApp;
4. configureer de dynamische parameter in de URL-instellingen van het merk.

Voorbeelden van doorverwijzingen:

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

7.1. Het taggingalgoritme toevoegen#

Plak in de URL-instellingen van het merk het onderstaande algoritme als dynamische waarde voor de parameter at_creation, of voor de trackingparameter die u wilt vullen.

Het detecteert de achtervoegsels van flying links (.WA, .BS, .TH) en geeft het juiste kanaal terug. Als er geen specifiek achtervoegsel wordt gevonden, valt het terug op het type sociaal netwerk van het bericht.

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