Отслеживание ссылок в Klaviyo: клики по коротким ссылкам как пользовательская метрика

Отслеживание ссылок в Klaviyo через Elido работает на стороне сервера и только в одном направлении: каждый клик по одной из ваших коротких ссылок отправляется в Events API Klaviyo как событие пользовательской метрики Elido Link Click. Событие содержит слаг и ID ссылки, страну и устройство, адрес назначения, на который был отправлен посетитель, и время клика. Метрика создаётся при первом использовании, после чего по ней можно строить графики, применять фильтры и создавать отчёты, как по любой другой метрике.

Но клик не появляется в профиле подписчика. Каждое событие связано со ссылкой через анонимный ID, поэтому ссылка, по которой нажали 4 000 человек, отображается в Klaviyo как один анонимный профиль с 4 000 событиями в его ленте. Именно этот факт определяет, для чего подходит интеграция. Я разберу структуру данных, настройку, возможности потоков и сегментов, а также сравню её со встроенным отслеживанием кликов 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, выберите тариф и подключите рабочее пространство, а затем направьте следующую кампанию в социальных сетях через брендированные ссылки.

Ограничения форвардера на сегодняшний день

Перед тем как строить на нём отчёт, нужно знать пять вещей.

Доставка выполняется по мере возможности. Неудачный POST повторяется через секунду, затем отбрасывается, и в очередь для последующей отправки ничего не попадает.

Для Events API действует ограничение на уровне аккаунта: 350 запросов в секунду при всплесках и 3 500 в минуту в обычном режиме. Этот лимит общий для всех приложений, отправляющих события в ваш аккаунт. При всплеске кампании свыше примерно 58 кликов в секунду, который длится минуту, появятся ошибки 429, а после единственного повтора эти клики исчезнут из Klaviyo.

Заголовок revision устарел. Klaviyo даёт каждой версии API два года до вывода из эксплуатации, а запросы к выведенной версии обслуживаются следующей из доступных старых версий. Версия 2023-02-22 уже перешла эту границу, поэтому сейчас форвардер работает благодаря автоматическому переходу на новую версию. Он работает. Но я всё же хотела бы обновить заголовок.

IP посетителя отправляется как свойство события. Учитывайте, что он хранится как любое другое свойство, и рассматривайте его как персональные данные в реестре обработки. В руководстве по резидентности данных в ЕС для маркетинговых команд описано, как оценить этот аспект.

Только клики. Конверсии не входят в структуру данных, поэтому отслеживайте выручку там, где хранится идентификатор клиента, а для большинства магазинов это собственная интеграция Klaviyo с электронной коммерцией.

Другие материалы в блоге

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