PixelLink: серверные пиксели Facebook и TikTok без лишней возни

Друзья, приветствую!

Когда-то давно я открывал глаза общественности на CAPI, он же Conversions API, в качестве замены стандартного веб-пикселя фб. Идея там была простая: если мы не можем нормально поставить браузерный пиксель на ленд, проклу, сайт брокера, страницу оплаты или вообще на что угодно за пределами нашей власти, то надо идти другим путём.

Сохраняем fbclid в трекере, получаем постбэк о целевом действии, а потом уже сервером шлём событие в Facebook.

С тех пор схема никуда не делась. Наоборот, стала ещё актуальней. Facebook (равно как и TikTok) продолжает требовать от нас как можно больше данных. Браузерный трекинг всё так же местами хромает. Баеры всё так же хотят: лить на разные пиксели или наоборот шарить один и тот же, видеть в фб как можно больше событий и получать одинаковую статистику по конверсиям в источнике и трекере.

В какой-то момент из этой истории вырос PixelLink — сервис, который я сделал как нормальную прослойку между трекером и рекламными источниками.

Что такое PixelLink

PixelLink — это связь между трекером и Facebook CAPI / TikTok Events API. Он ставится на ваш VPS, принимает S2S-постбэки из трекера, достаёт нужные данные клика или конверсии, подбирает пиксель и токен, собирает всё в удобоваримый для источника формат и отправляет событие.

Если совсем по-рабочему, то PixelLink нужен, чтобы не хранить токены в трекере, не собирать вручную отдельный постбэк под каждую кампанию и не объяснять каждому баеру, куда именно он должен вставить fbclid, ttclid, pixel ID, event name и ещё полведра параметров.

Сейчас сервис работает с двумя источниками:

• Facebook через Conversions API;
• TikTok через Events API.

По трекерам поддерживаются Keitaro v10/v11 и Binom v1/v2. Интеграция идёт через обычные S2S-постбэки без каких-либо танцев с бубнами.

Задача сервиса — сделать одну понятную точку, где лежат пиксели, токены, прокси, привязки к кампаниям, пользователи и логи отправки событий. А трекер пусть занимается своим делом: хранит клики, subid, статусы конверсий и отдаёт это по API.

Чем PixelLink отличается от старой схемы

В первоначальной статье про CAPI я описывал базовую архитектуру того, как можно интегрировать работу трекеров с CAPI: схема осталась рабочей, но руками её поддерживать больно. Особенно когда пикселей много, баеров несколько, источников уже не один Facebook, а ещё TikTok, токены периодически дохнут, прокси отваливаются, а события надо не потерять.

PixelLink закрывает именно эту рутину:

• токены хранятся в PixelLink, а не в трекере;
• S2S-постбэк можно настроить один раз в кампании или источнике трафика;
• пиксели можно привязывать к кампаниям трекера;
• события можно отправлять через HTTP/SOCKS5 прокси;
• баерам можно выдать отдельные пользовательские доступы;
• ошибки по токенам и прокси можно отправлять в Telegram;
• события попадают в очередь jobs, а значит их можно диагностировать и переотправлять.

Последний пункт особенно полезен. PixelLink не пытается прямо в момент входящего постбэка дёрнуть трекер, получить всё нужное и сразу плюнуть событием в Facebook/TikTok. Сначала создаётся задача. Потом фоновый обработчик забирает её из очереди, читает данные из API трекера, собирает событие и отправляет его в рекламный источник.

Это сделано не для красоты. Трекеры зачастую присылают постбэки раньше, чем все данные клика или конверсии становятся доступны через API. Поэтому между созданием задания и его выполнением есть специальная задержка на 1-2 минуты.

Тарифы, триал и личный кабинет

У PixelLink есть страница тарифов. На момент написания статьи там три основных плана:

• Starter — до 5 пользователей и один источник на выбор: Facebook или TikTok;
• Professional — до 10 пользователей, Facebook + TikTok, ноу-хау в виде Broadcasting и Optimization Boost, плюс работа с каталогами;
• Business — безлимитные пользователи, все доступные источники и выделенный саппорт.

Есть 7-дневный триал без карты. Оплата помесячно или на год, на год получается дешевле. Платёжки — карты или USDT TRC20.

После регистрации в личном кабинете появляется лицензия. Там видно тариф, статус, количество установок, срок действия, тип трекера и доступные источники. Оттуда же открывается раздел загрузок с VPS-автоустановщиком.

В разделе загрузок лежит команда установки вида:

curl -sL "https://licensing.pixell.ink/api/install.sh.php?key=ВАШ_ЛИЦЕНЗИОННЫЙ_КЛЮЧ" | bash

Её нужно будет скопировать и вставить на вашем сервере, давайте пройдёмся по требованиям.

Что понадобится для установки

Для PixelLink нужен отдельный VPS/VDS. Подойдёт самый дешёвый тариф, если у вас нет каких-то совсем диких объёмов. Я для таких задач обычно рекомендую FriendHosting: берём чистый сервер на Ubuntu или Debian, привязываем домен, запускаем установщик.

Минимальная база:

• чистый VPS на Ubuntu 22.04+ или Debian 11+;
• root-доступ по SSH;
• домен, уже направленный на IP сервера;
• лицензия PixelLink;
• API-ключ трекера;
• адрес API трекера;
• CAPI-токены Facebook и/или Access Token пикселя TikTok.

По Facebook есть отдельный нюанс: нужен именно CAPI-токен из Events Manager. Токен от Ads Manager сюда не пойдёт. Если хотите работать через лички без Business Manager, придётся получать токен разработчика.

По TikTok токен берётся в Events разделе TikTok Ads Manager в настройках нужного пикселя.

Установка на VPS

Порядок простой:

1. Покупаем VPS/VDS на FriendHosting.
2. Привязываем домен к IP сервера.
3. Заходим на сервер по SSH от root.
4. Копируем install-команду из личного кабинета PixelLink.
5. Запускаем команду и ждём, пока автоустановщик поднимет окружение.

Автоустановщик сам настраивает окружение, веб-сервер, PHP, базу, SSL и активацию лицензии.

После установки скрипт отдаёт ссылку на мастер установки, обычно это что-то вроде:

https://ваш-домен/install.php

В мастере установки нужно добить первоначальную настройку:

• задать пароль администратора;
• указать имя файла базы SQLite;
• вставить API-ключ трекера;
• указать API URL трекера;
• при желании сразу добавить API ключ телеграм-бота.

Для Keitaro и Binom V2 API URL указывается как домен без слеша в конце:

https://tracker-domain.com

Для Binom V1 используется адрес API с .php в конце, типа:

https://tracker-domain.com/j6zz.php

После отправки формы PixelLink запускает health check: проверяет запись в файловую систему, API-ключ и адрес трекера, доступ к API источников и токен Telegram-бота, если он указан. Если всё нормально — перекидывает в админку. Если нет — показывает, что именно надо чинить.

Админка: что настроить первым делом

В админку заходим под логином admin и паролем, который задали в мастере установки.

Основная логика админки такая:

• Sub Ids — где в трекере лежат pixel ID и дополнительные параметры;
• Users — управлением пользователями;
• Sys Settings — API трекера, Telegram Bot API Key, пароль админа;
• License Info — статус лицензии, тариф, срок, тип трекера и источники;
• SysHealth — проверка работоспособности системы.

Самое важное — правильно настроить суб-метки. Facebook и TikTok сами дописывают свои click ID к ссылке при клике по рекламе. У Facebook это fbclid, у TikTok — ttclid.

И вот тут отдельная слёзная просьба: не надо руками добавлять в конец рекламных ссылок fbclid= или ttclid=.

Не надо. Вообще.

Эти параметры добавляет сам источник. Ваша задача — настроить в трекере источник трафика так, чтобы трекер сохранил входящий fbclid или ttclid в какую-то суб-метку. Например, в sub_id_13, sub_id_14, external_id или как там у вас принято в команде.

Потом в PixelLink в Sub Ids выбираем, где именно лежит этот click ID.

Для Facebook указываем:

• где хранится fbclid;
• где хранится Pixel ID, если вы передаёте его в ссылке;
• при необходимости email, name, phone;
• при наличии нужного тарифа — catalog content ID для сопоставления с каталогом Meta.

Для TikTok указываем:

• где хранится ttclid;
• где хранится TikTok Pixel ID, если вы передаёте его в ссылке;
• при необходимости email и phone.

Передавать Pixel ID в ссылке не обязательно, поскольку пиксель можно привязать к кампании(ям) трекера. Но если у вас старая схема, где pixel ID летит в URL и сохраняется в трекере, то просто указываете соответствующую суб-метку.

Дополнительные параметры типа телефона, имени и почты имеет смысл включать только если они реально сохраняются у вас в трекере.

Пользователи и Telegram-уведомления

Дальше создаём пользователей. Обычно делают отдельного юзера под каждого баера.

Если хотите уведомления в Telegram, администратор указывает Telegram Bot API Key в системных настройках, а каждому пользователю прописывает его Telegram ID. После этого пользователь открывает бота, жмёт /start и получает уведомления об ошибках отправки событий.

Сценарии там следующие:

• умер токен;
• прокси не отвечает;
• источник вернул ошибку;
• событие не ушло и требует внимания.

Также в настройках можно указать Admin Telegram ID, чтобы админ получал напоминания по лицензии. По документации cron шлёт напоминания за 3 дня и за 1 день до окончания.

Там же можно поменять пароль админа, API-ключ трекера и URL трекера. Если поля нового пароля оставить пустыми, старый пароль сохраняется.

Пользовательская часть: пиксели, токены, кампании

После админской настройки баер заходит в пользовательский кабинет и добавляет свои пиксели.

В форме пикселя основные поля такие:

• Traffic Source — Facebook или TikTok;
• Name — понятное имя пикселя;
• Pixel ID — сам ID пикселя;
• Token — CAPI-токен Facebook или Access Token TikTok;
• Proxy — опционально, если событие надо отправлять через конкретный прокси.

Важная настройка — Tracker Campaign IDs. Туда можно указать одну или несколько кампаний трекера через запятую. Тогда PixelLink будет понимать, что этот пиксель привязан к этим кампаниям, и pixel ID в рекламную ссылку можно не прокидывать.

Пример:

12345,12346,12347

Это удобно, когда баер льёт пачку кампаний на один и тот же пиксель.

Simple Mode и Advanced Mode

В PixelLink есть два режима настройки событий пикселя.

Simple Mode — обычный режим. Вы выбираете одно событие и скорость от 1 до 5. Например, все входящие конверсии отправлять как Lead со скоростью 1 или как Purchase со скоростью 2.

Для Facebook доступны стандартные события вроде Lead, Purchase, CompleteRegistration, ViewContent, AddToCart, InitiateCheckout и другие. Для TikTok — свои стандартные события, например CompletePayment, CompleteRegistration, SubmitForm, ViewContent, AddToCart.

Если стандартного события не хватает, можно указать custom event.

Advanced Mode нужен, когда у вас несколько статусов конверсии и каждому статусу надо назначить своё событие. Например:

• lead отправлять как Lead;
• sale отправлять как Purchase;
• deposit отправлять как CompleteRegistration или кастомное событие;

В Advanced Mode можно задать разные события и разную скорость для разных статусов. Неуказанные статусы игнорируются.

Speed — это количество событий, которые PixelLink отправит в источник за одну конверсию. По умолчанию 1: одна конверсия = одно событие. Если поставить больше, система отправит несколько событий с уникальными event ID. На лендинге это называется множителем скорости 1-5x.

Данный инструмент помогает ускорить оптимизацию, но рекомендуем аккуратно тестировать его на своей вертикали и объёмах, а не бездумно выкручивать всё на максимум.

Как настроить S2S-постбэк

После добавления пикселей надо настроить S2S-постбэк в трекере.

Для Keitaro базовый вид такой:

https://домен-вашего-pixellink/capi.php?user=имяюзера&subid={subid}

Для Binom вместо {subid} обычно используется {clickid}:

https://домен-вашего-pixellink/capi.php?user=имяюзера&subid={clickid}

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

Прокси

Для каждого пикселя можно указать прокси. Поддерживаются HTTP/SOCKS5. Смысл простой: если хотите, чтобы события конкретного пикселя уходили через конкретный IP, прописываете прокси в настройках пикселя.

В интерфейсе прокси проверяются при заходе в раздел, так что сразу видно, что живое, а что сдохло.

И даже если прокси отвалился, событие не пропадает в никуда! Оно остаётся в jobs, и после починки прокси все неудачные события можно переотправить.

Broadcasting

В тарифах выше Starter есть Broadcasting или широковещание. По сути это рассылка одного события в несколько пикселей.

Есть два сценария:

• Empty Broadcasting — когда у конверсии нет явно заданного pixel ID, система пытается найти возможные пиксели по последним кликам кампании и отправить событие по ним;
• Normal Broadcasting — событие отправляется во все найденные в кампании пиксели, чтобы источник получил больше сигналов по пересекающейся аудитории.

Это штука не для всех и не для любого объёма. Но если у вас много кампаний, пересекающиеся аудитории и несколько пикселей в работе, она может дать больше сигналов для обучения. Рекомендую как минимум попробовать.

Web Pixel Mode

Ещё есть Web Pixel Mode — отправка событий через JavaScript с лендинга напрямую в capi.php. Работает примерно как обычный веб-пиксель FB/TT. Это полезно, если нужно отправить, например, PageView или ViewContent без ожидания конверсии.

Схема такая: на ленде вызываем endpoint PixelLink, передаём user, subid и событие. PixelLink берёт данные из лога кликов трекера, а не из лога конверсий, и отправляет событие дальше.

Пример логики:

<script>
const CAPI_BASE_URL = 'https://your-pixellink-domain.com/capi.php';
const PIXELLINK_USER = 'buyer_name';

const firePixelLinkEvent = async (eventName) => {
  const clickId = '{subid}'; // для Binom обычно {clickid}

  const endpoint = new URL(CAPI_BASE_URL);
  endpoint.searchParams.set('user', PIXELLINK_USER);
  endpoint.searchParams.set('subid', clickId);
  endpoint.searchParams.set('event', eventName);

  await fetch(endpoint, {
    method: 'GET',
    mode: 'no-cors',
    keepalive: true,
    credentials: 'omit'
  });
};

firePixelLinkEvent('ViewContent');
</script>

Это не замена S2S, а дополнительный режим. Можно, например, слать через него инсталлы.

Кому всё это надо

PixelLink нужен тем, кто:

• профессионально льёт трафик через Keitaro или Binom;
• работает с Facebook CAPI и/или TikTok Events API;
• хочет в случае ошибок понимать, что идёт не так;
• хочет гибко управлять отправкой событий;
• хочет максимальной надёжности в такой важной вещи как трекинг.

Если у вас один ленд, один пиксель, одна кампания и всё прекрасно работает с браузерным пикселем, возможно, для вас PixelLink будет как из пушки по воробьям. Но если вы профессионал, то готовая прослойка сильно сэкономит вам нервы.

Где начать

Заходите на pixell.ink, берите 7-дневный триал, покупайте VPS на FriendHosting, ставьте автоустановщик и настраивайте пиксель. Сначала проверьте на одной кампании, а когда увидите, что это работает, смело переходите на PixelLink целиком. С нами работает уже более 40 команд.

А у меня на этом всё, точного вам трекинга конверсий, друзья!

Что ещё почитать

Открыть полный хаб по арбитражу трафика →

Долгоживущий токен Facebook API: как получить и использовать Рассказываю о том, как уйти от стандартного токена от Ads Manager и жить долго и счастливо. Список AppId и AppSecret мобильных приложений Facebook Для разработчиков: список app id и app secret от фбшных мобильных прилок. Если знаете какие-то ещё - дополняйте… Полный разбор работы со спай-сервисами: нападение и защита. Подробно разбираем, как пользоваться спай-сервисами и как попробовать от них защититься.