Кратко: Conversion API — это интерфейс, на котором строится серверное отслеживание конверсий (server-side tracking). Он передаёт в рекламную платформу события конверсии, такие как продажа, отправка формы или регистрация, с вашего сервера, а не из браузера посетителя. В Meta этот инструмент называется Conversions API (CAPI). В Google ту же задачу решают улучшенные конверсии (enhanced conversions) и Data Manager API, а в рекламе ChatGPT используется Conversions API от OpenAI. Meta рекомендует применять CAPI вместе с пикселем, а не вместо него: одно и то же событие поступает и из браузера, и с сервера, а общий идентификатор события (event_id) позволяет устранить дубли. Главная ценность серверной настройки в том, что платформы получают данные из ваших записей о заказах и CRM, а не из браузера.
Это руководство написано для руководителей по маркетингу и разработке в компаниях из сферы электронной коммерции и B2B, которые регулярно размещают рекламу в Meta и Google и при этом либо работают с сайтом или CRM, разработанными на заказ (Laravel, Node.js, .NET), либо закрывают продажи офлайн. Если вы продаёте в Турции или работаете с турецкими партнёрами, вам пригодятся и разделы о данных турецких клиентов и о KVKK (турецкий закон № 6698 о защите персональных данных). Мы проверили факты по документации Meta, Google и OpenAI и по турецкому законодательству о защите данных, а вторичные источники указываем отдельно. Статья актуальна на 31 октября 2026 года.
Что такое Conversion API и чем серверное отслеживание конверсий отличается от пикселя?
Пиксель — это фрагмент кода на JavaScript, который отправляет событие из браузера посетителя. Блокировщик рекламы, ограничения браузера или незавершённая загрузка страницы могут привести к тому, что событие потеряется по пути. С Conversion API событие создаёт ваш сервер и передаёт его напрямую в API платформы. Поэтому можно отправлять и те события, которых браузер никогда не видит: подтверждение оплаты, продажу в магазине или лид, отмеченный в вашей CRM как «квалифицированный».
Что такое Meta CAPI? Это серверный интерфейс событий Meta. Его также ищут по запросу «Facebook Conversion API». В Справочном центре Meta на турецком языке он называется «Dönüşümler API'si» — это полезно знать, если ваша команда или агентство в Турции работают с Meta на турецком. Meta рекомендует применять CAPI вместе с пикселем; в документации для разработчиков такая схема называется «redundant setup» (резервированная настройка). Если eventID пикселя совпадает с event_id в CAPI, а названия событий одинаковы, две копии считаются одним событием. Такая дедупликация по event_id работает в течение 48 часов после получения первого события с этим идентификатором, и Meta обычно оставляет копию, которая поступила первой. Альтернативный метод на основе fbp или external_id, как правило, способен сопоставить события, только если копия из браузера приходит раньше серверной. Поэтому присваивайте каждому событию уникальный event_id.
В Google аналог состоит из двух частей: улучшенные конверсии, которые передают вместе с конверсией хешированные адрес электронной почты и номер телефона, и Data Manager API — теперь это основной способ импорта офлайн-конверсий. Для рекламы в ChatGPT по тому же принципу работает Conversions API от OpenAI.
Готовый плагин, настройка в один клик или индивидуальная интеграция Conversion API?
Индивидуальная настройка нужна не каждому бизнесу. 15 апреля 2026 года Meta объявила о настройке CAPI в один клик для веб-событий: она не требует технической экспертизы, затрат и обслуживания, а существующие партнёрские и индивидуальные настройки не меняются. По данным PPC Land, эта настройка охватывает только веб, и выбрать отправляемые события и параметры нельзя: всё, что отправляет пиксель, уходит и с сервера. Для событий из приложений и офлайн-событий нужна отдельная интеграция. Другие готовые варианты — расширение «Facebook Conversion API» турецкой платформы электронной коммерции ikas и уровни обмена данными в Shopify, использующие CAPI.
| Ваша ситуация | Чего обычно достаточно | Почему |
|---|---|---|
| Готовая платформа электронной коммерции, только покупки на сайте | Готовая интеграция или настройка в один клик | Обслуживание не требуется; набор событий ограничен тем, что отправляет платформа или пиксель. |
| Сайт, разработанный на заказ, реклама только в Meta | Для начала настройка в один клик, плюс индивидуальная интеграция для подтверждения оплаты | Событие, которого не видит браузер, может поступить только с сервера. |
| Реклама в Meta, Google и ChatGPT одновременно | Индивидуальная интеграция на основе единого потока событий | Отдельные плагины — это отдельные идентификаторы и правила хеширования. |
| Важны стадии лидов в CRM | Индивидуальная интеграция (Conversion Leads, Data Manager API), если у вашей CRM нет готового коннектора | Данные о стадиях есть только в CRM. |
| Продажи закрываются в магазине, по телефону или через дилера | Загрузка офлайн-событий | Браузер никогда не видит такие продажи. |
В системе электронной коммерции, разработанной на заказ, самый чистый подход — создавать событие на основе таблицы заказов. Похожий выбор между готовым и индивидуальным решением мы разбирали в статье о подключении интернет-магазина к ERP и системе электронных счетов-фактур.
Что изменилось у Meta, Google и OpenAI в 2026 году?
Большинство изменений исходит от Google. Строка о 12 ноября опирается на вторичные источники.
| Дата | Платформа | Что изменилось? |
|---|---|---|
| 2 февраля 2026 г. | Google Ads API | Новые пользователи, которые хотят передавать атрибуты сеанса и IP-адреса при импорте конверсий, получают ошибку, если их нет в списке разрешённых. Google направляет их в Data Manager API. |
| 1 апреля 2026 г. | Google Ads API | Для токенов разработчика, которые не отправляли запросы Customer Match с 1 октября 2025 года по 31 марта 2026 года, был ограничен доступ к этому сценарию. Для него Google тоже указывает на Data Manager API. |
| 15 апреля 2026 г. | Meta | Бесплатная настройка CAPI в один клик для веба. |
| Апрель–июнь 2026 г. | Google Ads | Данные из тега, Data Manager и API принимаются одновременно. Согласно графику Google, улучшенные конверсии объединяются в единую настройку включения и выключения. |
| 15 июня 2026 г. | Google Ads API | Новые пользователи больше не допускаются к импорту офлайн-конверсий, включая улучшенные конверсии для лидов. Для токенов разработчика, которые не выполняли загрузок с 17 декабря 2025 года по 15 июня 2026 года, доступ был ограничен. Существующие пользователи могут продолжать работу на время перехода на Data Manager API; дата окончания не объявлена. |
| 9 сентября 2026 г. | Google Ads API | Токены разработчика выведены из использования. Уровень доступа теперь привязан к проекту Google Cloud, который используется для OAuth. Ограничения для Customer Match и офлайн-конверсий остаются в силе. |
| Июнь–сентябрь 2026 г. | OpenAI | В Ads API появились эндпоинты для настройки конверсий и отчётности, назначение ставок с оптимизацией под конверсии, obref в CAPI и выбираемые окна атрибуции в отчётности. Список стран, где доступна реклама в режиме самообслуживания, OpenAI ведёт на отдельной странице своего Справочного центра. Он может меняться, поэтому перед запуском кампании проверьте там статус Турции. |
| 12 ноября 2026 г. | Meta | Запускается функция «Измерение конверсий на устройствах клиентов» (Measure conversions on customer devices), включённая по умолчанию. |
12 ноября 2026 года: что меняет настройка Meta «Измерение конверсий на устройствах клиентов»?
В Справочном центре Meta есть статья «About measuring conversions on customer devices» («Об измерении конверсий на устройствах клиентов»). Подробности известны из отраслевых изданий, которые цитируют текст панели Events Manager и письмо Meta рекламодателям. По данным PPC Land, в Events Manager под параметром «Measure conversions on customer devices» отображается надпись «Measurement starting November 12, 2026». Для наборов данных, отправляющих события, настройка включена по умолчанию. Её можно в любой момент отключить для отдельного набора данных, и изменений в коде она не требует. Согласно тому же материалу, с 12 ноября функция будет внедряться постепенно. По данным MetricMaven со ссылкой на Meta, сопоставление происходит на устройстве клиента. Meta узнаёт только, что покупка состоялась и какой кампании засчитана конверсия. Окно и модель атрибуции не меняются.
По данным MetricMaven и Stape, функция не действует для людей в ЕС и Великобритании. Есть и условия применения: например, сайт должен требовать вход по адресу электронной почты или номеру телефона. Если это так, магазины с гостевым оформлением заказа могут остаться за рамками функции. Вопросы, которые Meta пока не разъяснила, принципиально важны: как восстановленные покупки будут дедуплицироваться с событиями CAPI, как это повлияет на назначение ставок, передаются ли стоимость и валюта и как учитывается согласие. Сроки тоже чувствительные: 12 ноября наступает сразу после кампаний 11.11 (День холостяков) и за 15 дней до Чёрной пятницы, которая выпадает на 27 ноября. Мы советуем принимать решение на основе измерений, а не отключать настройку вслепую. Вот наш чек-лист, который согласуется с отраслевыми источниками:
- Зафиксируйте текущее состояние: для каждого набора данных отметьте, включена настройка или выключена. Добавьте отметку о 12 ноября на дашборды и в отчёты по 11.11 и Чёрной пятнице.
- Определите базовый уровень: для каждого дня до 12 ноября рассчитайте соотношение «покупки по данным Meta ÷ фактические заказы». Затем в течение четырёх–шести недель отслеживайте это соотношение и всплески двойного учёта.
- Организуйте holdout-тест: с помощью контрольной группы по регионам или кампаниям проверьте заявленный прирост по фактическим заказам.
- В регулируемых отраслях один из вариантов — отключить настройку до завершения юридической проверки и зафиксировать причину.
Настройка Conversion API: как пошагово внедрить серверное отслеживание конверсий
В нашей эталонной архитектуре источником истины служит запись о заказе или запись в CRM. Meta, Google и при необходимости OpenAI получают данные из единого потока событий, который формируется на основе этой записи и содержит статус согласия. Создайте токен доступа (токен Meta CAPI) в Events Manager: раздел Conversions API на вкладке «Настройки» (Settings) пикселя. Эту ссылку видят только пользователи с доступом разработчика к бизнес-аккаунту. Храните токен в секрете на сервере.
- Создавайте событие на основе записи. Покупка происходит в момент, когда уведомление об оплате проверено и заказ подтверждён, а не когда загрузилась страница «Спасибо». Этот шаг мы разобрали в руководстве по вебхукам интернет-эквайринга.
- Сохраняйте идентификаторы кликов. Для Meta:
fbc, который формируется изfbclid(fb.${subdomain_index}.${creation_time}.${fbclid}), иfbp. Для Google:gclid,gbraidиwbraid. Для OpenAI: cookie__obref, если это допускают ваши правила согласия. Эти идентификаторы, IP-адрес и user agent отправляются без хеширования. - Используйте один идентификатор события. Номер заказа используйте как
eventIDпикселя,event_idв CAPI,transactionIdв Google и полеidв OpenAI. - Записывайте согласие в событие. Сохраняйте выбор пользователя на этот момент вместе с событием. В Data Manager API для этого есть поля
adUserDataиadPersonalization. - Нормализуйте и хешируйте (см. следующий раздел).
- Ставьте событие в очередь и отправляйте идемпотентно. Событие записывается в очередь, фоновый обработчик (worker) отправляет его, а при сбое повторяет попытки с нарастающими интервалами. Повторные отправки не приводят к двойному учёту. Meta и OpenAI оставляют первую из копий, пришедших с одним и тем же ключом. Google считает известный идентификатор транзакции корректировкой, а не новой конверсией, и не увеличивает число конверсий.
- Тестируйте и сверяйте. Используйте
test_event_codeв Meta (в рабочей среде удалите его),validateOnlyиrequestStatus.retrieveв Google,validate_onlyв OpenAI. После запуска ежедневно сравнивайте отчёт платформы с фактическими заказами.
Правила отправки по платформам
| Правило | Meta CAPI | Google Data Manager API | OpenAI CAPI |
|---|---|---|---|
| События в одном запросе | До 1000 | До 2000 | До 1000 |
| Недействительные события | Запрос возвращает ошибку, но действительные события с event_id принимаются; одно событие старше 7 дней приводит к сбою всего запроса. | Принцип fast-fail: одна недействительная запись в обязательном поле приводит к сбою всего запроса; ошибки в необязательных полях дают только предупреждения. | Одно недействительное событие приводит к сбою всего пакета. |
| Сроки | До 7 дней в прошлом; продажи в магазине — в пределах 62 дней. | Для конверсий из нескольких источников — желательно в течение 24 часов. | Последние 7 дней; не более 10 минут в будущем. |
| Дедупликация | event_id + название события, 48 часов | Идентификатор транзакции в рамках одного действия-конверсии | ID пикселя + название события + id; сохраняется первое полученное |
Ловушки нормализации и хеширования при работе с турецкими данными
Все три платформы требуют хешировать адреса электронной почты и номера телефонов алгоритмом SHA-256. Один отличающийся символ даёт совершенно другой хеш. Поэтому ошибка нормализации — это тихая потеря совпадений, при которой никаких сообщений об ошибке не появляется.
- Номера телефонов форматируются не везде одинаково. Турецкий мобильный номер 0532 123 45 67, записанный здесь во внутреннем формате, для Conversions API от Meta и OpenAI нормализуется и хешируется как
905321234567(убрать ведущий ноль, добавить код страны, без «+»). Для Google Data Manager API и загрузки аудиторий в OpenAI он превращается в+905321234567(E.164). Сама OpenAI предупреждает, что нельзя считать правило для телефонов из одного API действующим в другом. - Приведение турецких İ и I к нижнему регистру меняет хеш. В турецком языке есть пара букв с точкой (İ/i) и пара без точки (I/ı). По стандартному правилу Unicode при переводе в нижний регистр «İ» превращается в двухсимвольное «i̇» (i + U+0307). Только турецкая локаль превращает «İ» в обычное «i», а «I» — в «ı». В нашем тесте
"İLKER".lower()в Python вернул «i̇lker», и хеш этой строки не совпал с хешем «ilker»."IŞIK".lower()вернул «işik» вместо турецкого «ışık». Начиная с PHP 8.2strtolower()переводит в нижний регистр только буквы ASCII, поэтому «İ» и «Ş» остаются без изменений.mb_strtolower(), на котором основан хелпер LaravelStr::lower(), превращает «İ» в «i̇». Обратная ситуация не менее рискованна: с турецкой локалью (toLocaleLowerCase('tr')в JavaScript,ToLower()при культуре tr-TR в .NET) «[email protected]» становится «ılker@fırma.com». - Разные правила для адресов электронной почты и имён. Для адресов электронной почты используйте приведение к нижнему регистру, не зависящее от локали, и предварительно заменяйте «İ» на «i». Если мобильная клавиатура делает первую букву заглавной по турецкому правилу, адрес может сохраниться как «İlker@…». Для имён правила разные: Meta рекомендует a–z, но принимает UTF-8, OpenAI просит сохранять диакритические знаки, а Google требует нижний регистр без обращений и титулов. Какая форма турецких символов даёт лучшее совпадение, в документации не указано, поэтому проверяйте на собственных данных.
- Правило Gmail действует только в Google: в адресах gmail.com и googlemail.com удаляйте точки перед @, а также знак «+» вместе со всем, что идёт после него до @. В правилах Meta и OpenAI такого шага нет. OpenAI прямо просит не удалять точки и плюс-теги при загрузке аудиторий.
- Не путайте лиры и куруши. Google требует, чтобы загружаемое значение было в том же формате и той же единице, что и в теге. Компания предупреждает, что другая единица, например целые центы (для турецкой лиры это куруши: 100 курушей равны 1 лире), приводит к «серьёзному завышению ценности конверсий», а сама система единицу не конвертирует. Если отправить 24 990 курушей как есть, заказ на 249,90 ₺ отобразится как 24 990 ₺.
Мы держим нормализацию в одной функции, покрытой модульными тестами. Примеры тестовых векторов: « İ[email protected]» → [email protected] и, для Google, «[email protected]» → [email protected].
Google Data Manager API, офлайн-конверсии и качество лидов из CRM
Google: улучшенные конверсии и Data Manager API
Согласно графику Google, с июня 2026 года улучшенные конверсии для веба и для лидов — это единая настройка включения и выключения, которую можно отключить для отдельных действий-конверсий. Google называет Data Manager API основным способом импорта офлайн-конверсий, поэтому новые проекты мы сразу начинаем на нём. На что обратить внимание при миграции:
- Токен разработчика не требуется (а с 9 сентября 2026 года Google Ads API тоже игнорирует токен). Квоты привязаны к проекту Google Cloud.
operating_accountдолжен быть аккаунтом, которому принадлежит действие-конверсия. Родительские и дочерние аккаунты не принимаются.- Загрузки и корректировки идут через один вызов
IngestEvents. Отправка существующего идентификатора транзакции с новой ценностью считается корректировкой. Что касается отзыва конверсий, документация противоречива: в руководстве по обновлению и на странице о корректировках сказано, что изменить можно только ценность, а число конверсий не меняется, тогда как на странице об офлайн-конверсиях говорится об отзыве. Проверьте свой сценарий возврата до запуска. - По возможности отправляйте GCLID с каждым событием. Он обязателен, если вы не собираете пользовательские данные с помощью тега.
Настоящая новинка — конверсии из нескольких источников (бета). К веб-конверсии, настроенной вручную через тег Google или GTM, можно добавить вашу CRM или базу заказов как второй источник. Записи дедуплицируются по идентификатору транзакции. Для совпавших событий добавленный источник перезаписывает ценность из тега и становится единственным источником истины по ценности. В течение первого 14-дневного пробного периода обновление ценности отключено, а новые конверсии не используются для назначения ставок.
Meta: обратная передача стадий лидов из CRM
Для наилучших результатов интеграции Conversion Leads Meta рекомендует хранить в CRM идентификатор лида Meta (Meta Lead ID) из 15–17 цифр. Если его нет, передавайте идентификатор клика, номер телефона или адрес электронной почты. Требования: не менее 200 лидов в месяц; стадия, под которую идёт оптимизация, должна наступать в течение 28 дней после появления лида, а её коэффициент конверсии должен составлять 1–40%; загрузка данных не реже одного раза в день. Период обучения Meta оценивает в 2–4 недели. В B2B с длинными циклами продаж закрытие сделки может занимать больше 28 дней. Поэтому может потребоваться оптимизация под более раннюю стадию, например «квалифицированный лид» вместо «сделка выиграна». То же изменение стадии уходит в Google через Data Manager API вместе с GCLID и хешированным адресом электронной почты как улучшенная конверсия для лидов. В наших проектах CRM и ERP мы закладываем поля стадий под эту задачу с самого начала.
KVKK и согласие: какие вопросы передать юристам?
Этот раздел не является юридической консультацией. KVKK — распространённое сокращение, которым обозначают турецкий закон о защите персональных данных (закон № 6698) и ведомство, следящее за его соблюдением. Совет этого ведомства принимает принципиальные решения.
- Разделены ли информационное уведомление и явное согласие? Согласно принципиальному решению Совета № 2026/347, информационное уведомление (aydınlatma) должно предоставляться до начала обработки независимо от правового основания. Если вы опираетесь на явное согласие (açık rıza), два текста оформляются отдельно, под разными заголовками. Если вы опираетесь на другое правовое основание, текст явного согласия не предлагается.
- Какое основание у трансграничной передачи данных? Статья 9 закона в редакции, действующей с 1 июня 2024 года, требует наличия основания для обработки и, кроме того, в первую очередь решения о достаточности защиты, а при его отсутствии — надлежащих гарантий, например типового договора. О типовом договоре необходимо уведомить ведомство в течение пяти рабочих дней после подписания. Явное согласие — лишь исключительный путь для «эпизодических» (arızi) передач. Подзаконный регламент определяет эпизодическую передачу как нерегулярную, совершаемую один или несколько раз, не являющуюся непрерывной и не входящую в обычный ход деятельности. Подходит ли под это определение поток данных, который запускается при каждом заказе?
- Является ли хеширование анонимизацией? Цель хеширования — сопоставить человека с аккаунтом на платформе; Google тоже сравнивает хешированные данные с аккаунтами, в которые выполнен вход. Мы рассматриваем хеширование как меру безопасности, а не как анонимизацию.
- Какая настройка согласия действует по умолчанию? Пиксель OpenAI по умолчанию инициализирует согласие как
true. Там, где согласие обязательно, вызывайтеoaiq('consent', false)доinit. - Вы показываете рекламу пользователям в Европе? Политика Google в отношении согласия пользователей из ЕС распространяется на пользователей в Европейской экономической зоне, Великобритании и Швейцарии. Она требует действительного согласия на сбор, передачу и использование персональных данных для персонализации рекламы. Экспортёр из Турции, который обращается к пользователям в Германии через продукты Google, в отношении этих пользователей подпадает под действие политики. Для трафика из Турции рамки задаёт KVKK.
Прежде чем проектировать интеграцию, уточните реестр данных и меры защиты с помощью проверки соответствия KVKK и GDPR (Общий регламент ЕС по защите данных).
Как Partnerfy может помочь
Для нас Conversion API — это не установка тега, а интеграционный проект, который начинается с ваших данных о заказах и CRM. Сначала мы проводим аудит вашего пикселя и серверных событий. Затем сопоставляем схему событий с Meta, Google и при необходимости OpenAI, а также фиксируем стратегию event_id и правила нормализации с помощью тестовых векторов. Слой отправки мы строим на вашем стеке (например, Laravel, Node.js или .NET) с очередью, идемпотентными повторами и мониторингом ошибок, а статус согласия делаем частью события. После запуска мы также настраиваем панель сверки и мониторинга, которая сравнивает отчёты платформ с вашими фактическими заказами. Подробности — на странице Интеграции Conversion API. Чтобы вместе разобрать вашу текущую настройку, свяжитесь с нами.
Источники
- Meta for Developers: дедупликация, параметры информации о клиенте, использование API, токен доступа, Conversion Leads
- Meta: объявление от 15 апреля 2026 года; Справочный центр для бизнеса: о Conversions API, об измерении конверсий на устройствах клиентов
- Google Ads API: прекращение поддержки, токен разработчика, блог для разработчиков, 15 мая 2026 года
- Справка Google Ads: улучшенные конверсии для лидов, обновления настроек улучшенных конверсий, конверсии из нескольких источников
- Google Data Manager API: руководство по обновлению, офлайн-конверсии, корректировки, events.ingest, модель ошибок, форматирование, Consent; Google: политика в отношении согласия пользователей из ЕС
- OpenAI Ads: Conversions API, Measurement Pixel, Custom Audiences, таргетинг, журнал изменений, доступность Ads Manager
- KVKK (на турецком языке): объявление о принципиальном решении № 2026/347, закон № 6698; Resmî Gazete (Официальный вестник Турции, на турецком языке): регламент о трансграничной передаче персональных данных
- Техническая документация: Unicode SpecialCasing, MDN, Microsoft Learn, PHP strtolower; готовые платформы: ikas, Shopify
- Вторичные источники: PPC Land, 27 октября 2026 года, PPC Land, 27 апреля 2026 года, Stape, 22 октября 2026 года, MetricMaven, 19 октября 2026 года