Відстеження посилань у Klaviyo: кліки коротких посилань як кастомна метрика

Відстеження посилань у Klaviyo через Elido працює на серверній стороні й лише в одному напрямку: кожен клік одного з ваших коротких посилань передається до Events API Klaviyo як подія кастомної метрики Elido Link Click. Подія містить слаг і ID посилання, країну та пристрій, адресу призначення, куди було надіслано відвідувача, і час кліку. Метрика створюється під час першого використання, після чого її можна будувати на графіках, фільтрувати та використовувати у звітах, як і будь-яку іншу.

Чого вона не робить, то це не додає клік до профілю підписника. Кожна подія прив'язана до посилання через анонімний ID, тож посилання, за яким натиснули 4000 людей, відображається в Klaviyo як один анонімний профіль із 4000 подіями в його часовій шкалі. Саме цей факт визначає, для чого придатна інтеграція. Я розберу структуру даних, налаштування, можливості флоу й сегментів, а також порівняю це з нативним відстеженням кліків Klaviyo.

Якщо ваші посилання ще не мають узгоджених тегів, спочатку виправте це. У наріжному матеріалі відстеження UTM від початку до кінця описано це правило, а Klaviyo бачить лише те, що містить посилання.

Що Elido надсилає до Klaviyo під час кожного кліку

Один клік, один POST. Перенаправник викликає https://a.klaviyo.com/api/events/ з вашим приватним ключем у заголовку Authorization: Klaviyo-API-Key і заголовком revision: 2023-02-22. Це кінцева точка, описана в довіднику Klaviyo Create Event.

Ось повне тіло запиту з прикладами значень:

{
  "data": {
    "type": "event",
    "attributes": {
      "time": "2026-09-21T09:14:22Z",
      "properties": {
        "workspace_id": 12,
        "link_id": 4711,
        "slug": "autumn-drop",
        "country": "DE",
        "device": "mobile",
        "destination": "https://shop.example/autumn?utm_source=instagram",
        "ip": "203.0.113.24"
      },
      "metric": {
        "data": {
          "type": "metric",
          "attributes": { "name": "Elido Link Click" }
        }
      },
      "profile": {
        "data": {
          "type": "profile",
          "attributes": { "anonymous_id": "elido-link-4711" }
        }
      }
    }
  }
}

Оце й усе. Немає адреси електронної пошти, номера телефону, окремих полів UTM, реферера чи браузера.

Коли ви починаєте фільтрувати, важливі кілька деталей. destination - це URL, який фактично отримав цей відвідувач після застосування правил маршрутизації розумного посилання, тож посилання, яке надсилає користувачів iPhone до App Store, а всіх інших - до вашого магазину, дає два значення destination. device має одне з трьох значень: mobile, tablet або desktop. Теги UTM існують лише всередині рядка destination, тому безпосередньо фільтрувати за utm_campaign неможливо; натомість фільтруйте за slug, який зазвичай є чистішим ключем.

Сканери, які повідомляють про себе у своєму user agent, відкидаються на етапі перенаправлення й ніколи не передаються далі. Кліки, які власні евристики Elido позначають як підозрілі, усе одно надсилаються, і в події немає властивості, яка б це вказувала.

Один анонімний профіль для кожного посилання і чому

Кожна подія Klaviyo має назвати профіль, ідентифікований адресою електронної пошти, номером телефону, зовнішнім ID, ID Klaviyo або anonymous_id. Elido завжди надсилає останній варіант, сформований як elido-link- плюс ID посилання.

Тож кожен клік autumn-drop потрапляє в один і той самий профіль. Перший клік створює його, а кожен наступний додається до його часової шкали.

Це має три наслідки, і третій мене здивував.

По-перше, підрахунки працюють, а люди залишаються невідомими. Загальна кількість кліків, кліки для кожного посилання, країни та пристрою працюють. Будь-який показник "унікальних" кліків рахує посилання, а не людей.

По-друге, в анонімного профілю немає адреси електронної пошти чи номера телефону. Він може входити до сегмента, але не може отримувати повідомлення.

По-третє, кліки в межах тієї самої секунди об'єднуються. Перенаправник не надсилає unique_id, а в довіднику Klaviyo зазначено, що без нього дедуплікація відбувається за часом події до секунди для того самого профілю та метрики. Оскільки профіль створюється для кожного посилання, два кліки одного посилання в межах тієї самої секунди стають однією подією. Для посилання в розсилці, де кліки надходять поступово, ви цього ніколи не помітите. А для посилання у великій історії Instagram, де на піку надходить по кілька кліків за секунду, кількість у Klaviyo буде меншою за кількість у вашій аналітиці кліків Elido. Перевага в тому, що одне повторне надсилання перенаправника не подвоїть кількість, бо повторно надіслана подія має той самий час.

Чому не використовувати ID відвідувача? Перенаправник не знає, хто саме відвідувач, і я воліла б, щоб він не встановлював cookie на домені, який відвідувач не обирав. Це та сама компромісна модель, яку ми застосували для відстеження посилань Mixpanel, де distinct_id є ідентифікатором посилання з тієї самої причини.

Налаштування відстеження посилань Klaviyo в Elido

Налаштування зводиться до одного поля.

1. У Klaviyo відкрийте Settings, потім API keys, і створіть приватний API-ключ. У довіднику Create Event зазначено, що йому потрібна область дії events:write. У вбудованих примітках Elido до налаштування також згадується profiles:write; я почала б лише з events і додала другий дозвіл, якщо Klaviyo повертає помилки 403.
2. У своєму робочому просторі Elido відкрийте Integrations, виберіть картку Klaviyo та натисніть Connect Klaviyo.
3. Вставте ключ у Private API Key і збережіть його. Elido шифрує ключ під час зберігання та надалі показує його лише замаскованим.
4. Зачекайте приблизно п'ять хвилин. Налаштування інтеграції кешуються на стороні перенаправлення, тому перші кліки після збереження можуть не передатися.
5. Натисніть одне зі своїх посилань із телефона, потім відкрийте Analytics > Metrics у Klaviyo та знайдіть Elido Link Click.

Кнопка Test connection надсилає до Klaviyo одну тестову подію з позначкою elido_test: true і показує відповідь Klaviyo, тож відкликаний ключ або ключ лише для читання одразу дає збій. Це доводить, що ключ працює, але не те, що метрика потрапляє в очікуваний профіль. Доказом є поява метрики в Klaviyo після реального кліку.

Перемикача для окремого посилання немає. Перенаправляються всі кліки в робочому просторі, зокрема посилання, які ви не планували використовувати для маркетингу. Агентствам, що працюють із багатьма клієнтами, варто створити для кожного клієнта окремий робочий простір перед підключенням будь-чого.

Нативне відстеження кліків Klaviyo проти метрики Elido

Klaviyo вже відстежує кліки у власних електронних листах і текстових повідомленнях, і для роботи на рівні підписників це нативне відстеження краще. Воно переписує кожне посилання через власний домен відстеження, записує Clicked Email або Clicked SMS у профілі одержувача та позначає ймовірних сканерів властивістю Bot Click, яку можна виключити зі звітів.

Метрика Elido корисна в усіх інших місцях: посилання в біографії Instagram, QR-код на пакуванні, посилання, яким партнер ділиться у власній розсилці, або посилання в описі епізоду подкасту. Жоден із цих кліків не проходить через трекер Klaviyo. Коли перенаправник увімкнено, вони з'являються в тому самому обліковому записі, що й метрики електронної пошти, тож один дашборд Klaviyo може показати поруч "натиснув осіннє посилання з будь-якого джерела" та "натиснув осінній лист".

Є один нюанс, на який варто зважати. У надісланих електронних листах Klaviyo додає параметр _kx до кожного посилання, щоб його скрипт на сайті міг ідентифікувати того, хто натиснув. Якщо посилання у вашому листі є коротким посиланням Elido, _kx потрапляє в короткий URL, а перенаправлення Elido не переносить вхідні параметри запиту до адреси призначення. Ідентифікація на сайті втрачається. Моє правило таке: в електронних листах Klaviyo ведіть посилання безпосередньо на власний сайт і дозвольте Klaviyo відстежувати його; використовуйте короткі посилання для каналів, яких Klaviyo не охоплює.

Як додати кліки до реальних профілів підписників

Іноді потрібно прив'язати клік до людини. Сьогодні працюють два способи, і жоден із них не використовує перенаправник.

Найпростіший спосіб - дозволити відстеженню Klaviyo на сайті визначати особу. Надішліть спільне коротке посилання на адресу призначення з тегами UTM і переконайтеся, що на цій сторінці працює JavaScript Klaviyo. Відвідувачі, у яких уже є cookie після попереднього кліку в електронному листі або які зареєструвалися через форму, отримують активність на сайті у своєму профілі. Клік короткого посилання залишається анонімним, а наступний візит - ні. Потім порівнюйте їх на рівні кампанії, що менш детально, ніж на рівні людини, але чесно відображає, що відомо кожній стороні.

Складніший спосіб - посилання для кожного одержувача. Для невеликого, але цінного списку, наприклад B2B-послідовності або запрошень для VIP-гостей, створіть через API за адресою /v1/workspaces/{workspace_id}/links окреме коротке посилання для кожної людини й ведіть власну таблицю відповідності ID посилання та електронної пошти. Підпишіться на події посилань через вебхуки, знайдіть адресу електронної пошти, коли надійде клік, і надішліть власну подію до Klaviyo, вказавши цю адресу як ідентифікатор профілю. Це, можливо, близько сорока рядків коду, і це єдиний шлях додати клік Elido до іменованого підписника. Я б не робила цього для розсилки на 200 000 людей.

Якщо вам бракувало змішаних каналів підрахунку кліків у Klaviyo, виберіть план і підключіть робочий простір, а потім спрямуйте наступну кампанію в соціальних мережах через брендовані посилання.

Обмеження перенаправника сьогодні

Перед тим як покластися на нього у звіті, варто знати п'ять речей.

Доставка виконується за принципом best effort. Невдалий POST повторюється через секунду один раз, після чого відкидається, і в чергу на потім нічого не ставиться.

Events API має обмеження частоти для кожного облікового запису: 350 запитів на секунду під час сплесків і стабільні 3500 на хвилину. Цей ліміт спільний для всіх інших застосунків, які записують події у ваш обліковий запис. Під час сплеску кампанії понад приблизно 58 кліків на секунду, що триває хвилину, з'являться відповіді 429, а після одного повторного надсилання ці кліки зникнуть із Klaviyo.

Заголовок revision застарів. Klaviyo дає кожній версії API два роки до виведення з експлуатації, а запити до застарілої версії обслуговуються наступною найстарішою доступною версією. Версія 2023-02-22 вже перетнула цю межу, тож сьогодні перенаправник працює завдяки автоматичному переходу на наступну версію. Він працює. Але я все ж хотіла б оновити заголовок.

IP-адреса відвідувача надсилається як властивість події. Очікуйте, що вона зберігатиметься як будь-яка інша властивість, тож розглядайте її як персональні дані у своїх записах про обробку. У довіднику з резидентності даних у ЄС для маркетингових команд описано, як це оцінювати.

Лише кліки. Конверсії не входять до структури даних, тож відстежуйте дохід там, де зберігається ідентифікація клієнта, а для більшості магазинів це власна ecommerce-інтеграція Klaviyo.

Пов'язані матеріали в блозі

• Відстеження UTM від початку до кінця - правило тегування, від якого залежить об'єднання на рівні кампанії.
• Відстеження посилань Mixpanel - та сама модель перенаправника з тією самою ідентифікацією для кожного посилання.
• Вебхуки для подій посилань - будівельний блок для подій кліків окремих одержувачів.
• Атрибуція кліків електронної пошти для Mailchimp, Brevo та Klaviyo - ширший огляд платформ електронної пошти.
• Кліки коротких посилань проти сеансів GA4 - чому кількість кліків і сеанси аналітики ніколи не збігаються.
• Моніторинг URL у Datadog - той самий перенаправник кліків, що наповнює дашборд Datadog.