Measure email campaigns with RightLinks
Build a UTM-style link structure for your mailings, open the right screen in the app, and credit installs, re-engagements and purchases to each campaign.
RightLinki dla email marketingu (Food Farmer): ocena dokumentacji i propozycja artykułu
Stan na 18.11.2026, wieczór. Wersja 2: po git fetch wszystko sprawdzone na origin/main repozytoriów (core-go 6fe91a91 z 16.11, management-backend 1951ce16 z 16.11, web-private 1901385 z 16.11, contracts-go 27afce7 z 15.11, android-sdk 61cad60 z 10.11, developer-doc-portal bb4ea9e z 17.11, help-center-strapi 4260a11 z 14.11). Pierwsza wersja opierała się na starych lokalnych klonach; różnice zaznaczone niżej.
Kontekst: Maciej Czekała (CTO Food Farmer) pyta, jak ustalić strukturę linków z parametrami UTM, żeby mierzyć konwersję z email marketingu. Food Farmer ma aplikacje iOS i Android z SDK AdShift, dane wpadają poprawnie (wątek z Kacprem 15–27.10, panel Marketplace). Odpowiedź dla nich to RightLink z retargetingiem, a nie gołe UTM-y.
1. Co jest dziś w dokumentacji
Support (support.adshift.com, sekcja Get started → RightLinks):
| Artykuł | URL | Źródło |
|---|---|---|
| Overview | /docs/rightlinks | tylko w CMS Strapi (nie ma go w repo) |
| RightLinks onboarding | /docs/rightlinks-onboarding | help-center-strapi/frontend/content-overrides/rightlinks-onboarding.md (bez zmian od 6.10) |
| Measure push notification re-engagement | /docs/rightlink-push-reengagement | tylko w CMS Strapi |
Portal deweloperski (dev.adshift.com, repo developer-doc-portal, main z 17.11) ma rozbudowaną sekcję „Deep Links & Rightlink”: Introduction (format linku, parametry i limity, przekazywanie parametrów na strony WWW, EXTRA_PARAMS_JSON w eksporcie kliknięć, minimalne wersje SDK), workflow, Android/iOS initial setup, Interstitial page, Testing links, Branded domain. Cały portal wymaga logowania (src/middleware.ts przepuszcza bez sesji tylko /, /healthz i auth). Link „RightLinks — developer guide” z artykułu Overview prowadzi na stronę logowania; deweloper klienta bez konta AdShift go nie przeczyta. Do decyzji, czy to zamierzone.
2. Czy informacje na support są aktualne
Zgodne z kodem (zostaje): model szablon → link; pid = media source, c = kampania; is_retargeting i okna w URL; deep_link_value i deep_link_sub1; parametry as_channel, as_ad, as_sub1–as_sub5 (contracts-go/reserved/params.json); krótkie linki atrybuowane (Android SDK 4.1.0 z 10.11, testy 8.11 zgodne); przepływ push z as_push_link; branded domains; App Links / Universal Links; „bez retargetingu powrót to zwykłe otwarcie” (TU-A-02, decyzja 28.10).
Do poprawy:
- Brak rodzaju linku „Email”. Kreator „New link” pyta „What is this link for?” i daje: Social media, Referrals, SMS and messaging, QR code, From another app, Custom (
web-private/src/components/CreateTemplateLinkContent/consts.tsx, bez zmian na main). E-mail = Custom + „Custom media source name”. Artykuły tego nie mówią. Propozycja produktowa: rodzaj „Email” z presetami (Email,Mailchimp,Klaviyo,GetResponse,FreshMail,SALESmanago,Braze); do tego czasu artykuł opisuje ścieżkę Custom. - Własne parametry (
utm_*) są dozwolone i przekazywane, ale support o tym milczy. Walidacja (management-backend/apps/mng/src/modules/rightlink/rightlink.validation.ts, kopia w web-private) odrzuca tylko klucze linku i nieznane kluczeas_; bramka dokleja parametry linku do adresu WWW (target/web.go: Forwardable, zasada „klucz już obecny w adresie docelowym wygrywa”) i oddaje je aplikacji (LinkQuery→ SDKDeepLinkResult.queryParams). Portal deweloperski opisuje to dokładnie (sekcja „Parameters on your web pages”), support nie. Korekta wobec wersji 1: to nie jest nieudokumentowane, tylko schowane za logowaniem i nie w artykule dla marketera. - Przykładowy URL w onboardingu zawiera
as_xp=custom. Na main backend już go nie emituje („as_xp is gone”,link-urls.spec.ts); bramka nigdy go nie czytała. Przykład do podmiany na format z portalu:https://yourbrand.rightlink.me/101?pid=email&c=spring_sale&is_retargeting=true&deep_link_value=product/42. - Onboarding nie zna obecnego kreatora. Dziś to 4 kroki: (1) rodzaj, media source, kampania, retargeting; (2) „Deep link and redirects”; (3) „Interstitial page, creative and share preview”; (4) „Parameters” (dodatkowe parametry i lookback). Zamiast „Get URL” jest przycisk Share z zakładkami „Short link”, „Full URL with parameters”, „QR code”, „Link on your domain”. Kroku 3 (strona pośrednia) w artykule nie ma wcale, a dla e-maila jest kluczowy (punkt 6).
- Tabela dodatkowych parametrów za krótka i bez limitów. Dozwolone też
as_prt,as_c_id,as_adset,as_adset_id,as_ad_id,as_ad_type,as_ad_format,as_media_type,as_keywords,as_siteid,as_sub_siteid. Limity:pid≤ 150,c≤ 100,deep_link_valuei inne ≤ 512;pidnie może byćorganic/noneani kończyć się_int; zakazane znaki/ < > * & ? \; cały URL ≤ 2000 znaków w panelu, 2048 bajtów w bramce. - Poczta na iOS w trybie „Automatic” prowadzi do App Store nawet z zainstalowaną aplikacją. Macierz bramki (
core-go/.../decide/MATRIX.md, katalog 2026.10.12.3) ma wiersze Gmail, Apple Mail, Outlook i „Email with click tracking”. Na iOS Gmail, Outlook i mail ze śledzeniem kliknięć to grupa O (Safari bez Universal Links): w trybie Automatic wynik „O3 · O3”, czyli sklep z aplikacją i bez; dopiero tryb Always (albo Custom z grupą „Gmail, Outlook, Slack and links pasted into Safari”) daje stronę z „Open in app”. Apple Mail otwiera aplikację wprost. Na Androidzie Gmail i Outlook otwierają aplikację wprost (grupa N). Pewność tych wierszy to „docs”, nie test na urządzeniu. Korekta wobec wersji 1: klienci poczty są w macierzy, tylko artykuły o tym nie piszą; test na telefonie i tak potrzebny. - Opcja Galaxy Store nadal bez atrybucji instalacji (odłożone 28.10); artykuł nie powinien jej polecać.
- Martwe linki w „See also” onboardingu: artykuł linkuje do
/docs/rightlinks-overviewi/docs/measure-push-notification-re-engagement, a żywe adresy to/docs/rightlinksi/docs/rightlink-push-reengagement(plik w repo ma stare slugi). - Drobne: nigdzie na support nie ma, gdzie szukać konwersji (zakupów) z linku, tylko instalacji i re-engagementów; portal deweloperski podaje, że parametry własne z krótkich linków lądują w
EXTRA_PARAMS_JSONw eksporcie kliknięć (oznaczone jako dane osobowe).
Wycofane z wersji 1: zarzut o nazwach AppsFlyer (af_sub, deep_link_sub1–10) w portalu; na main (PR #58 z 23.10) już poprawione.
3. Jak odpowiedzieć Food Farmerowi
Korekta 18.11 wieczorem, po sprawdzeniu kreatora w web-private: tabela i nazewnictwo poniżej są już po zmianie. Każdy link ma własną kampanię, as_ad wypada, w deep_link_value nie ma ukośników.
Sedno: odbiorcy newslettera to w większości istniejący użytkownicy. Liczy się re-engagement, a to wymaga is_retargeting=true na linku i włączonego re-engagementu w App Settings. Zwykły link z UTM-ami policzy stuknięcie jako zwykłe otwarcie, bez przypisania zakupu do kampanii.
Mapowanie UTM → RightLink:
| UTM | RightLink | Przykład Food Farmer | Uwagi |
|---|---|---|---|
utm_source |
pid (media source) |
email |
stałe, jedno na kanał; raporty grupują po nim; w panelu do 20 znaków |
utm_medium |
as_channel |
newsletter, automation, transactional |
typ wysyłki; w panelu grupowanie po Channel |
utm_campaign + utm_content |
c (campaign) |
2026_11_dynie_hero, 2026_11_dynie_kafelek, winback_30d_hero |
wysyłka i przycisk w jednej nazwie; w panelu do 50 znaków; para pid + c musi być unikalna w szablonie |
utm_term |
as_sub1 |
segment_premium, woj_mazowieckie |
segment; tylko w Data Export, w panelu niewidoczne |
| wariant A/B | końcówka c, opcjonalnie też as_sub2 |
2026_11_dynie_hero_a, 2026_11_dynie_hero_b |
każda wersja musi mieć własne linki |
| cel w aplikacji | deep_link_value (+ deep_link_sub1) |
product_123, seller_45, category_nabial, cart |
lista do ustalenia z deweloperem; kreator nie przyjmuje / |
Jeśli mają stronę WWW z GA: dodać jako „Custom parameter” również utm_source, utm_medium, utm_campaign, utm_content; bramka dołączy je do adresu strony docelowej (desktop, brak aplikacji). Dla AdShift zbędne.
Nazewnictwo: małe litery, snake_case, bez spacji i bez znaków / < > * & ? \; data w c jako rrrr_mm; pid nigdy nie zmieniany. Każdy link ma własne c (wysyłka i przycisk, np. 2026_11_dynie_hero), bo w jednym szablonie dwa linki nie mogą mieć tego samego pid i c. Kreator odpowiada wtedy „This campaign already exists in this template for this source.”. Część „wysyłka” taka sama jak nazwa w narzędziu mailingowym. Jeden link na CTA (inne c i deep_link_value), z tego samego szablonu. Wynik całej wysyłki to suma kampanii o wspólnym początku. as_ad pomijamy: widok Ad w panelu liczy po identyfikatorze reklamy, więc sama nazwa nie rozdzieli przycisków (odczytane z kodu raportów, nie sprawdzone na danych). W mailu wygodniejszy krótki link; długi niesie parametry w URL-u.
Okno re-engagementu dla maila: 7 dni na start; atrybucja last-touch, więc kolejny mail przejmuje kredyt; przy równoległych pushach ustawić „Minimum time between re-engagement conversions” w App Settings.
Dwie pułapki do omówienia:
- Strona pośrednia dla poczty na iOS. W szablonie (albo na linku) ustawić „Interstitial page” na Always lub Custom z grupą Gmail/Outlook/Safari. Inaczej użytkownik z aplikacją, który klika w Gmailu na iPhonie, trafia do App Store.
- Śledzenie kliknięć w narzędziu mailingowym. ESP opakowuje linki własnym przekierowaniem; na iOS Universal Link po przekierowaniu się nie odpala, więc tap kończy się na stronie bramki (z „Open in app” przy trybie Always; w trybie Automatic w sklepie). Na Androidzie Chrome otwiera aplikację także po przekierowaniu. Opcje: wyłączyć śledzenie kliknięć dla linków RightLink w ESP (AdShift liczy kliknięcia sam) albo zaakceptować jeden dodatkowy tap na iOS. Do przetestowania na ich ESP.
Do zapytania przed setupem: narzędzie mailingowe; czy aplikacje mają App Links (Android) i Universal Links (iOS) pod foodfarmer.rightlink.me albo własną domenę; wersje SDK (iOS ≥ 3.0, Android ≥ 4.0, dla krótkich linków 4.1.0); jakie ekrany obsługują z linku; czy mają sklep WWW z GA (foodfarmer.pl to aplikacja jednostronicowa, nie sprawdziłem); co jest konwersją (as_purchase, order_delivered, phone_click, chat_start).
4. Jaki artykuł napisać
Jeden nowy artykuł obok push: „Measure email campaigns with RightLinks”, plus poprawki w onboardingu (punkty 3, 4, 5 z sekcji 2) i zdanie w Overview o własnych parametrach. Overview nie przepisywać; jest poprawny, tylko niepełny.
Struktura: 1) What you get; 2) How it works for email (większość odbiorców ma aplikację → retargeting on); 3) Before you begin; 4) UTM → RightLink mapping, naming, limits; 5) Step by step w obecnym kreatorze (szablon raz; link: Custom + custom media source, kampania, retargeting, okno; deep link; Interstitial page: Always; parametry; Share → short/long URL); 6) Email click tracking; 7) Test before sending (Apple Mail, Gmail iOS, Gmail Android, Outlook, desktop; Analyze → Overview, widok Retargeting); 8) Reading results; 9) Troubleshooting.
Gdzie: plik frontend/content-overrides/rightlinks-email-campaigns.md w help-center-strapi na osobnej gałęzi i PR do review (tak jak onboarding). Poprawki Overview i push przez panel Strapi, bo nie ma ich w repo.
5. Jak poprowadzić Food Farmera przez setup
- Odpowiedź mailowa (sekcja 7): koncepcja, mapowanie, pytania, link do onboardingu.
- Ustalenia z ich deweloperem (30 min): App Links/Universal Links na subdomenie, lista
deep_link_value, obsługaDeepLinkResult, wersje SDK, re-engagement w App Settings,singleTaskna Androidzie (README SDK). - Szablon
foodfarmer.rightlink.me(Android + iOS, Google Play/App Store, desktop → foodfarmer.pl, Interstitial page: Always). - Link testowy
pid=qa,c=test_2026_11(portal zaleca osobny link do testów, nie kampanijny), retargeting on, okno 7 dni,deep_link_valuena produkt; urządzenie na liście testowych albotestMode; test na Apple Mail, Gmail iOS, Gmail Android, Outlook, desktop, z włączonym i wyłączonym śledzeniem kliknięć w ESP; sprawdzenie w Analyze → Overview (Retargeting) i w Snowflake (CLICKS, CONVERSIONS, INAPP_EVENTS popid/c). - Pierwsza wysyłka: 2–3 linki (CTA) jednej wysyłki, każdy z własną kampanią; po tygodniu przegląd wyników z nimi, ewentualnie karta „email” w ich panelu Marketplace.
6. Szkic artykułu (EN)
Wersja 3 (bez powtarzania Overview, onboardingu i push; tylko to, co specyficzne dla e-maila). Plik: release/rightlinks-email-campaigns.md (z nagłówkiem YAML) i release/rightlinks-email-campaigns-body.md (samo body do CMS).
Nieaktualne od 18.11 wieczorem. Szkic poniżej ma stary schemat (jedna kampania na kilka linków, as_ad, ukośniki w deep_link_value), którego kreator nie przyjmie. Aktualna treść jest tylko w dwóch plikach wymienionych wyżej.
slug: rightlinks-email-campaigns title: Measure email campaigns with RightLinks excerpt: Map your UTM scheme onto RightLink parameters, set up links for mailings, and measure re-engagement and purchases from each campaign. category: RightLinks section: "" audience: brands featured: false
This guide covers what is specific to email: how to map a UTM scheme onto RightLink parameters, which settings a mailing needs, and what to test in mail apps. How RightLinks work and how to create a template and a link are in the RightLinks overview and the onboarding guide.
What is different about email
- Most recipients already have your app. Their return is credited only when the link has Retargeting on and re-engagement is enabled in App Settings (see the onboarding guide). Without it, an email tap counts as a plain app open.
- Some mail apps on iPhone cannot open your app directly. In Gmail and Outlook on iOS, and after any email tool's tracking redirect, the link opens in a browser view where Universal Links do not fire. RightLink then needs its Interstitial page to offer Open in app; see Step 1.
- Email tools rewrite links. Click tracking wraps every URL in a redirect; see "Email click tracking".
Map your UTM scheme to RightLink parameters
| You would use | In RightLink | Example | Notes |
|---|---|---|---|
utm_source |
Media source (pid) |
email, or your tool, e.g. mailchimp |
Stable, one per channel. Reports group by it. |
utm_medium |
as_channel |
newsletter, automation, transactional |
Type of mailing. |
utm_campaign |
Campaign name (c) |
2026_11_pumpkin_season, winback_30d |
One per mailing. |
utm_content |
as_ad |
hero_button, product_tile_2, footer_link |
Which element of the email. One link per call to action. |
utm_term |
as_sub1 |
segment_premium, region_mazowieckie |
Audience or segment. |
| A/B variant | as_sub2 |
subject_a |
Optional. |
| In-app destination | Deep link value (deep_link_value), optionally Additional value (deep_link_sub1) |
product/123 |
What the app opens. |
Naming rules: lowercase, snake_case, no spaces, none of / < > * & ? \. Media source up to 150 characters, campaign up to 100. Put the date in the campaign name as yyyy_mm. Never change the media source once you start; change campaign names per mailing and tell calls to action apart with as_ad. Use the same names in your email tool and in AdShift.
Also using Google Analytics on your website? Add utm_source, utm_medium, utm_campaign and utm_content as custom parameters with the same values. AdShift does not need them, but it forwards them to your web page when a recipient without the app (or on desktop) lands there, so the web visit is tagged too. A key already present in your landing page's own address keeps the value you set there.
Step 1: Template setting for email
Create the template as in the onboarding guide, with one change: in Interstitial page choose Always, or Custom with the iOS group "Gmail, Outlook, Slack and links pasted into Safari". With the default Automatic mode, people who tap in Gmail or Outlook on an iPhone are sent to the App Store even though they have your app.
Step 2: Link settings for each call to action
Create the link as in the onboarding guide, with these choices:
- What is this link for? Custom. Media source: your stable name as the custom media source (for example
email). Campaign: the mailing. - Retargeting: on, with a Re-engagement window (7 days is a good start for email). Ignore active users only if the mailing should be credited solely for users who had been inactive.
- Deep link: the screen this button opens. Keep the template's redirects.
- Parameters:
as_channel,as_ad,as_sub1from the list, andutm_*as custom parameters if you tag your website.
One link per call to action in the email, from the same template, changing only the deep link value and as_ad.
Step 3: Which URL to put in the email
From Share, use either the Short link or the Full URL with parameters. The difference between them is described in the push guide; for email the short link has one more upside: it survives email tools that truncate or rewrite long URLs. Do not remove or rewrite the query parameters.
Email click tracking
Most email tools wrap every link in their own tracking redirect. On iPhone a Universal Link does not open the app after such a redirect: the recipient lands on the RightLink page in Safari and taps Open in app once more (with the Interstitial page set to Always; in Automatic mode they would go to the App Store). On Android, Chrome normally opens the app after the redirect. Your options:
- Turn off click tracking for RightLink URLs in your email tool (AdShift counts the clicks anyway).
- Keep tracking and accept the extra tap on iPhone.
Test both ways with your tool before the first mailing.
Test in mail apps before you send
Follow the test steps in the onboarding guide, but tap the links from a real email, not from a browser, on:
- an iPhone with the app, in Apple Mail (expect the app) and in the Gmail app (expect the page with Open in app, then the app),
- an Android phone with the app, in Gmail (expect the app),
- a phone without the app (expect the store),
- a desktop mail client (expect your website).
Use a test link of its own, for example pid=qa&c=test, and a device from the project's test devices. In Analyze → Overview, Retargeting view, the taps should appear as re-engagements under your media source and campaign, and a test purchase inside the window as a conversion credited to it.
Reading the results
as_channel,as_adandas_sub1–as_sub5are available as dimensions and in Data Export. Custom parameters such asutm_*stored on a short link are in the Clicks export inEXTRA_PARAMS_JSON.- Several mailings or pushes in parallel: attribution is last-touch; see "Running several retargeting campaigns at once" in the push guide.
Troubleshooting
- Opens the App Store from Gmail or Outlook on iPhone even though the app is installed: the Interstitial page is on Automatic; set it to Always.
- Opens the App Store from Apple Mail: the email tool's tracking redirect (see above), or Universal Links are not verified for this domain.
- Parameters missing in reports: the email tool rewrote or truncated the URL. Use the short link.
- Counted as a plain open, wrong screen, store on Android: see the troubleshooting sections of the overview and the onboarding guide.
7. Szkic odpowiedzi dla Macieja (PL)
Cześć Maciej,
dobry moment, bo to dokładnie przypadek na RightLinki, czyli nasze linki atrybucyjne. Krótko, jak to działa i co proponuję.
Link z maila otwiera aplikację od razu na wskazanym ekranie (produkt, sprzedawca, kategoria, koszyk), a komuś bez aplikacji pokazuje sklep (Google Play / App Store) albo stronę WWW na desktopie. Każde kliknięcie zapisujemy i przypisujemy do kampanii: powrót istniejącego użytkownika jako re-engagement, nową instalację jako instalację, a zakupy i inne zdarzenia w oknie po kliknięciu (np. 7 dni) do tej wysyłki. Ważne: odbiorcy newslettera to w większości Wasi obecni użytkownicy, więc linki muszą mieć włączony retargeting, inaczej kliknięcie policzy się jako zwykłe otwarcie aplikacji.
Struktura „UTM” przekłada się na ustawienia linku tak:
- utm_source → media source (
pid): stałe, np.email, - utm_medium →
as_channel: typ wysyłki, np.newsletter,automation,transactional, - utm_campaign i utm_content → campaign (
c): wysyłka i przycisk w jednej nazwie, np.2026_11_dynie_hero,2026_11_dynie_kafelek, - utm_term →
as_sub1: segment, np.segment_premium. To pole widać tylko w eksporcie danych, w raportach w panelu go nie ma, - do tego
deep_link_value: ekran w aplikacji, np.product_123.
Każdy przycisk w mailu dostaje własny link z własną nazwą kampanii, bo w jednym szablonie dwa linki nie mogą mieć tego samego źródła i tej samej kampanii. W raporcie widać wtedy każdy przycisk osobno, a wynik całej wysyłki to suma tych pozycji. W nazwach i wartościach nie używamy spacji ani znaków / < > * & ? \.
Jeśli macie też stronę z GA, te same utm_* można dodać do linku jako dodatkowe parametry; przekażemy je na stronę docelową dla ruchu bez aplikacji.
Linki tworzy się w panelu: Engage → RightLink Management. Raz szablon (aplikacje, subdomena foodfarmer.rightlink.me, przekierowania, strona pośrednia dla klientów poczty na iPhonie), potem jeden link na każde CTA w mailu. Instrukcja krok po kroku: https://support.adshift.com/docs/rightlinks-onboarding (dokładamy właśnie osobny artykuł o mailingach).
Żeby to ruszyło, potrzebuję kilku informacji:
- Jakiego narzędzia do mailingu używacie? (Większość opakowuje linki własnym przekierowaniem; na iPhonie to oznacza jeden dodatkowy tap przed otwarciem aplikacji, więc warto przetestować albo wyłączyć śledzenie kliknięć dla naszych linków.)
- Czy aplikacje mają już App Links (Android) i Universal Links (iOS) oraz jakie wersje naszego SDK? Jeśli nie, to jednorazowa konfiguracja po Waszej stronie; podeślemy instrukcję dla dewelopera.
- Jakie ekrany aplikacja ma otwierać z linku (lista wartości
deep_link_value, bez ukośników, np.product_123)? - Co jest dla Was konwersją z maila: zakup, kontakt ze sprzedawcą, coś innego?
Proponuję krótki call z Wami i deweloperem, ustawimy pierwszy link testowy i sprawdzimy go na iOS i Androidzie przed pierwszą wysyłką.
Pozdrawiam, Przemek
Measure push notification re-engagement
Use RightLinks in push notifications to bring users back and measure the return as re-engagement.
My dashboards — what each one is for
A quick map of AdShift's Analyze dashboards — what each one is for, who it's for, and when to use it. Start at Overview, then dive into the detail.