Jak skonfigurować dynamiczne parametry URL dla Google Analytics i Piano Analytics

1. Czym jest dynamiczny parametr URL w Nonli?#

Dynamiczne parametry URL pozwalają automatycznie dodawać parametry śledzenia do adresów URL publikowanych za pomocą Nonli. Pomagają one Google Analytics, Piano Analytics lub innemu narzędziu analitycznemu zidentyfikować źródło kliknięcia, sieć społecznościową, konto społecznościowe, bota, który wygenerował post, lub powiązany krótki link.

Te parametry są domyślnie wyłączone: są dodawane tylko wtedy, gdy marka wyraźnie je skonfiguruje. Stają się wtedy częścią planu tagowania analityki klienta, a klient musi sprawdzić, czy wybrane parametry, jego CMP i docelowe narzędzie pomiarowe są zgodne z jego własnymi obowiązkami w zakresie zgodności z przepisami.

Można ich używać w zwykłych postach, postach generowanych przez boty i flying linkach.

2. Jak skonfigurować dynamiczne parametry URL w Nonli?#

2.1. Otwórz ustawienia URL marki#

Kliknij menu hamburgerowe, przejdź do „Brands” (marki), wybierz markę, którą chcesz skonfigurować, a następnie przewiń w dół do „URL settings” (ustawienia URL).

2.2. Utwórz regułę parametru#

Każda reguła określa:

• typ parametru: ? dla zwykłego parametru zapytania w adresie URL lub # dla kotwicy, takiej jak xtor;
• źródło ruchu: konkretną sieć lub „All” (wszystkie), aby zastosować regułę do każdego źródła;
• klucz parametru: na przykład utm_source, utm_medium, utm_campaign, utm_content, utm_term, at_creation, mtm_campaign lub xtor;
• wartość: stałą lub dynamiczną, obliczaną na podstawie posta.

💡 Zalecamy wybranie „All” jako źródła ruchu, gdy wartość dynamiczna zawiera już sieć społecznościową lub konto. Pozwala to uniknąć powielania tej samej konfiguracji dla każdej sieci osobno.

2.3. Zrozum, jak Nonli dodaje parametry do linków#

Gdy Nonli tworzy ostateczny link, analizuje docelowy adres URL, markę i źródło ruchu, a następnie dodaje parametry zgodne ze skonfigurowanymi regułami.

Ważne szczegóły:

• jeśli parametr już istnieje w docelowym adresie URL, Nonli go nie zastępuje;
• parametry ? są dodawane do ciągu zapytania;
• parametry # są dodawane jako kotwica tylko wtedy, gdy adres URL nie ma jeszcze kotwicy;
• wartości dynamiczne korzystają ze składni szablonów z podwójnymi nawiasami klamrowymi.

Przykład:

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

Ta konfiguracja przesyła do narzędzia analitycznego sieć społecznościową, medium, kampanię, autora posta i identyfikator krótkiego linku.

W tym przykładzie |slugify to filtr stosowany do zwracanej wartości. Zamienia tekst, taki jak France News Bot, na france-news-bot, bez spacji i znaków specjalnych, dzięki czemu wartość pozostaje czysta i stabilna w adresie URL.

3. Jak skonfigurować Nonli dla Google Analytics?#

Google Analytics rozpoznaje następujące parametry UTM:

Przykładowa konfiguracja do śledzenia postów z Nonli w Google Analytics:

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

Także tutaj |slugify automatycznie formatuje autora przed dodaniem go do utm_content. Jeśli post pochodzi od bota, post.author zawiera nazwę bota.

4. Jak skonfigurować Nonli dla Piano Analytics?#

Piano Analytics może korzystać z własnego planu tagowania lub ponownie wykorzystywać parametry UTM, jeśli w konfiguracji Piano włączona jest zgodność z UTM.

Możliwe są dwa podejścia:

• używanie tych samych parametrów UTM co w Google Analytics, jeśli Twoja konfiguracja Piano je akceptuje;
• używanie parametrów przeznaczonych dla Twojego planu tagowania Piano, takich jak parametry at_, mtm_ lub kotwica xtor.

Przykład z parametrami at_:

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

Filtr |slugify pozwala uniknąć spacji, znaków diakrytycznych i znaków specjalnych w wartości przesyłanej do Piano Analytics.

Przykład z kotwicą xtor:

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

5. Jakie zmienne dynamiczne są dostępne w Nonli?#

Oto najbardziej przydatne zmienne do konfigurowania parametrów URL. Parametry URL korzystają z węższego kontekstu niż szablony Smart Message: zmienna organic i funkcje Smart Message wymienione w artykule Jakie zmienne Twig są dostępne w Nonli? nie są tu dostępne.

5.1. Zmienne źródła ruchu i konta społecznościowego#

5.2. Zmienne posta#

post.user_id może być zwykłym identyfikatorem użytkownika lub ujemną wartością techniczną. Najważniejsze wartości to:

5.3. Zmienne adresu URL i treści źródłowych#

5.4. Funkcja identyfikująca link w wiadomości lub pierwszym komentarzu#

Możesz też użyć tej funkcji, aby rozróżnić umiejscowienie linku:

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

6. Jakich filtrów można używać w wartościach dynamicznych?#

Wartości dynamiczne akceptują też filtry, które oczyszczają lub przekształcają wynik.

• lower: {{ post.social_account.type|lower }} zamienia na małe litery.
• upper: {{ post.social_account.slug|upper }} zamienia na wielkie litery.
• slugify: {{ post.author|slugify }} zamienia tekst na slug przyjazny dla adresów URL, na przykład France News Bot staje się france-news-bot.
• encode: {{ post.author|encode }} koduje wartość na potrzeby adresu URL.
• clean: {{ post.author|clean }} oczyszcza wartość tekstową.

7. Jak dodać parametry UTM, AT lub MTM za pomocą flying linków?#

Flying linki pozwalają automatycznie śledzić ruch z kanałów społecznościowych, którymi Nonli nie zarządza bezpośrednio, takich jak Threads, Bluesky czy WhatsApp.

Aby to zrobić:

1. utwórz Target URL (docelowy adres URL);
2. utwórz jeden flying link dla każdego kanału;
3. dodaj sufiks do shortId, na przykład .TH dla Threads, .BS dla Bluesky i .WA dla WhatsApp;
4. skonfiguruj parametr dynamiczny w ustawieniach URL marki.

Przykładowe przekierowania:

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

7.1. Dodaj algorytm tagowania#

W ustawieniach URL marki wklej poniższy algorytm jako wartość dynamiczną parametru at_creation lub parametru śledzenia, który chcesz wypełnić.

Wykrywa on sufiksy flying linków (.WA, .BS, .TH) i zwraca właściwy kanał. Jeśli nie znajdzie żadnego konkretnego sufiksu, używa typu sieci społecznościowej posta.

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