Renta / Документация / Назначения / Meta Conversions API

Meta Conversions API

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

В строке лежит момент конверсии, идентификаторы человека, который её совершил, и её сумма. Renta хеширует идентификаторы до отправки, поэтому Meta сопоставляет конверсию с человеком, не получая исходных контактов.

Аутентификация

Renta авторизуется через Meta OAuth. Авторизуйте аккаунт Facebook, у которого есть права на рекламный аккаунт с нужным пикселем.

Renta проверяет, что авторизованному аккаунту виден хотя бы один рекламный аккаунт, и иначе отказывается создавать подключение. Если это произошло, выдайте пользователю Facebook доступ к рекламному аккаунту в Meta Business Settings и авторизуйтесь заново.

Подключение назначения Meta Conversions API

Откройте каталогStep 1
  1. Перейдите в раздел Connections > Catalog в левом меню и откройте вкладку Destinations.
  2. Раскройте категорию Reverse ETL и нажмите карточку Meta Conversions API.
Карточка Meta Conversions API в категории Reverse ETL каталога назначений Renta
Начните авторизациюStep 2

Нажмите Log in to your Meta Conversions API account. Meta откроется в этой же вкладке.

Страница авторизации с кнопкой Log in to your Meta Conversions API account
Выдайте доступStep 3

Подтвердите аккаунт Facebook и нажмите Continue. Кнопка Edit settings нужна, если хотите изменить набор бизнесов и рекламных аккаунтов, доступных Renta. После подтверждения Meta вернёт вас в Renta.

Диалог входа Meta с кнопками Edit settings и Continue
Назовите подключение и сохранитеStep 4

Renta покажет выданный доступ и авторизованный аккаунт. Завершите настройку:

  1. Destination name.
    Укажите имя этого назначения. Оно используется только в интерфейсе Renta.

Нажмите Save.

Страница настройк�и подключения Meta Conversions API с полем имени назначения
Назначение созданоStep 5

Новое назначение появится в списке Destinations со статусом Active. Теперь его можно использовать в пайплайнах Reverse ETL.

Список Destinations с новым назначением Meta Conversions API в статусе Active

Подготовьте модель данных

Пайплайн Reverse ETL читает данные из модели: это SQL-запрос, сохранённый в разделе Data models, который решает, какие строки хранилища синхронизировать и что лежит в каждой строке. Создайте её до пайплайна, потому что выпадающие списки маппинга заполняются её колонками.

В модели конверсий одна строка это одно завершённое событие. Дайте каждой строке момент конверсии в виде Unix-времени в секундах, хотя бы один идентификатор человека и сумму, если она есть.

-- Purchases prepared for the Meta Conversions API.
-- The query returns rows only, no table is created.
WITH demo_purchases AS (
  SELECT
    'ord-1001'                  AS order_id,
    UNIX_SECONDS(TIMESTAMP '2026-08-15 14:20:00 UTC') AS event_time,
    129.00                      AS value,
    'USD'                       AS currency,
    'james.miller@example.com'  AS email,
    '+12125550101'              AS phone
  UNION ALL SELECT 'ord-1002', UNIX_SECONDS(TIMESTAMP '2026-08-15 15:05:00 UTC'),  59.00,'USD','olivia.johnson@example.com','+13125550102'
  UNION ALL SELECT 'ord-1003', UNIX_SECONDS(TIMESTAMP '2026-08-15 16:40:00 UTC'), 249.00,'USD','william.davis@example.com','+12145550103'
)
SELECT * FROM demo_purchases

Создание модели данных

Напишите запросStep 1

В левом меню откройте Data models и нажмите New model. Дальше:

  1. Source.
    Выберите подключение к хранилищу, к которому пойдёт запрос.
  2. Write your model query.
    Вставьте свой SQL. Тип запроса оставьте SQL query.
  3. Run preview.
    Проверьте строки и названия колонок. Колонка со временем события должна вернуться целым числом, поэтому в BigQuery оберните таймстамп в UNIX_SECONDS или используйте аналог из своего хранилища.

В качестве области выберите Reverse ETL only и нажмите Next step.

Шаг Data source с SQL-редактором и предпросмотром на десять строк
Проверьте колонки и выберите ключStep 2

Проверьте колонки, которые Renta прочитала из запроса, и отметьте ту, что идентифицирует строку. Для конверсий это идентификатор самого события, например номер заказа, а не человека: два заказа одного клиента это две разные конверсии.

На последнем шаге дайте модели имя и нажмите Create model. Это имя вы выберете в списке Data model при создании пайплайна.

Шаг Schema с шестью колонками модели покупок и уникальным ключом на order_id

Создание пайплайна Meta Conversions API

Назначение и модель данных должны существовать до начала настройки.

Выберите хранилищеStep 1

В левом меню нажмите New pipeline. На шаге Source переключите тумблер в положение Reverse ETL и выберите своё хранилище, например Google BigQuery.

Шаг выбора источника с переключателем Reverse ETL и карточкой Google BigQuery
Выберите подключение к хранилищуStep 2

Выберите подключение к хранилищу, в котором лежат ваши модели данных, и нажмите Next step.

Шаг выбора подключения Google BigQuery со списком доступных подключений
Выберите Meta Conversions API как назначениеStep 3

На шаге Destination выберите Meta Conversions API в блоке Already connected, укажите созданное ранее подключение Meta и нажмите Next step.

Шаг выбора назначения с Meta Conversions API в блоке Already connected

Настройка пайплайна

На последнем шаге выберите, куда попадут конверсии, как они будут называться и какие колонки их описывают.

Что отправляет Renta

Выберите объект, модель данных и пиксель, который принимает события.

Настройки пайплайна Meta с объектом Conversion event, моделью данных, рекламным аккаунтом и пикселем
  1. What would you like Renta to send to Meta.
    Conversion event здесь единственный объект. Аудитории собирает отдельное назначение Meta Custom Audiences.
  2. Data model.
    Модель для синхронизации. Колонки, доступные для маппинга ниже, берутся из неё.
  3. Ad account.
    Рекламный аккаунт Meta, которому принадлежит пиксель. Он же фильтрует список пикселей ниже.
  4. Pixel / Dataset.
    Пиксель, в который передаются конверсии. Выбирайте тот же пиксель, куда уже отправляет события ваш сайт или приложение. Именно это позволяет Meta засчитать браузерное и серверное событие как одну конверсию.

Значения событий по умолчанию

Опишите, какие конверсии лежат в модели. Эти значения применяются к каждому событию, в котором нет собственных.

Поля Action source, Default event name, Default currency и Test event code

  1. Action source Где произошли конверсии. Meta по этому значению выбирает правила атрибуции, поэтому отвечайте про момент конверсии, а не про пайплайн.

    ЗначениеКогда выбирать
    WebsiteКонверсия произошла на вашем сайте.
    AppКонверсия произошла в мобильном приложении.
    Phone callКонверсия произошла в телефонном разговоре.
    ChatКонверсия произошла в чате или мессенджере.
    EmailКонверсия произошла в переписке по почте.
    Physical storeКонверсия произошла офлайн в розничной точке.
    System generatedКонверсию сформировала ваша CRM или бэкенд. Обычный случай для выгрузки из хранилища.
    Business messagingКонверсия произошла в бизнес-мессенджере.
    OtherНи один из вариантов выше не описывает канал.

  2. Default event name.
    Как конверсия называется в Meta. Выберите стандартное событие Meta, например Purchase, Lead, Subscribe или CompleteRegistration, либо вариант Custom event и укажите своё название длиной до 50 символов. Один пайплайн передаёт один вид конверсии, поэтому для модели, где смешаны покупки и лиды, нужен отдельный пайплайн под каждый вид.

  3. Default currency (optional).
    Валюта в формате ISO 4217, которая подставляется, если в модели нет колонки с валютой. Meta требует валюту всегда, когда в событии есть ценность, поэтому заполните это поле, если валюту не отдаёт каждая строка.

  4. Test event code (optional).
    Код с вкладки Test events в Meta Events Manager. События с этим кодом попадают на ту же вкладку, а не в отчётность, и так вы проверяете маппинг до боевого запуска. После проверки поле нужно очистить.

Если оставить Test event code заполненным, боевые конверсии продолжат уходить на тестовую вкладку вместо отчётности по кампаниям.

Маппинг полей

Свяжите колонки хранилища с параметрами серверного события Meta. Поле Event time (unix seconds) выбрано заранее и не удаляется, а для атрибуции конверсии человеку нужен хотя бы один идентификатор.

Сопоставление колонок модели данных с параметрами событий Meta Conversions API
ГруппаПараметры
СобытиеEvent time (unix seconds), Event ID (deduplication), Event source URL, Action source, Opt out
Хешируемые идентификаторыEmail, Phone, First name, Last name, Gender, Date of birth (YYYYMMDD), City, State/Province, Zip/Postal code, Country, External ID
Идентификаторы как естьClick ID (fbc), Browser ID (fbp), Client IP address, Client user agent, Subscription ID, Facebook login ID, Lead ID
Детали конверсииValue, Currency, Order ID, Content name, Content category, Content IDs, Content type, Contents, Number of items, Search string, Status, Predicted LTV, Delivery category

Renta нормализует и хеширует алгоритмом SHA-256 каждый идентификатор из второй группы до отправки. Колонка, в которой уже лежит хеш, распознаётся и передаётся как есть, поэтому хранилище, которое хеширует данные заранее, продолжает работать. Браузерные и кликовые идентификаторы уходят без изменений: по ним Meta сопоставляет напрямую.

Остальные параметры необязательные и определяют, что Meta знает о конверсии. Value вместе с Currency делает возможным отчёт по окупаемости рекламы.

Замаппьте Event ID (deduplication), даже если те же конверсии не отправляет браузерный пиксель. По нему Meta схлопывает дубли, а заодно это защищает вас, когда из-за сетевого сбоя Renta повторяет партию, которую Meta уже приняла. Без идентификатора события такой повтор засчитает конверсию дважды.

Строку без единого идентификатора невозможно сопоставить с человеком, поэтому Renta отбрасывает её вместо отправки события, которое Meta всё равно отбросит. Строка с ценностью, но без валюты уходит без суммы, а не отклоняется целиком.

Поведение синхронизации и приватность

Задайте, что происходит с конверсией, чья строка исчезла, и объявите применимые правила приватности.

Список When a source row is deleted и настройки Limited Data Use по стране и штату
  1. When a source row is deleted.
    Ignore здесь единственный вариант. Уже переданную конверсию отозвать нельзя, поэтому исчезновение строки из модели ни на что в Meta не влияет.
  2. Limited Data Use (LDU).
    Ограничивает использование конверсий для персонализации рекламы. Включайте, если этого требует законодательство, например CCPA в Калифорнии.
  3. LDU country и LDU state.
    География, к которой применяется ограничение. Обычный вариант это оставить оба поля в состоянии Auto-detect и позволить Meta определить её по данным. Задавайте значения явно, только если этого просит юрист.

Дальше назовите пайплайн и выберите, как часто он запускается.

Поле Integration name и выбор типа расписания с отмеченным вариантом Manual

Integration name это имя вашего пайплайна. Измените его под свои задачи.

Тип расписанияОписание
ManualПайплайн запускается только вручную через интерфейс или по API.
DailyПайплайн запускается раз в сутки в указанное время.
IntervalПайплайн запускается через заданные интервалы времени.
Cron ExpressionПайплайн запускается по расписанию, заданному cron-выражением.

Для расписания Daily укажите Update time (точное время старта каждого запуска) и нажмите Create pipeline.

Renta также поддерживает запуск по API и интеграцию с внешними оркестраторами, такими как Apache Airflow, Dagster и Prefect. Подробности в документации по расписаниям.

Новый пайплайн появится в разделе Pipelines на вкладке Reverse ETL, где видно его запуски и прогресс.

Список пайплайнов Reverse ETL с новой интеграцией Meta Conversions API

Стратегия синхронизации

Renta синхронизирует данные инкрементально. Запуск сравнивает модель с состоянием, которое записал предыдущий запуск, и передаёт только те конверсии, которых раньше не было. Первому запуску не с чем сравнивать, поэтому он доставляет модель целиком.

Состояние строкиЧто делает Renta
НоваяПередаёт конверсию в пиксель.
ИзменённаяПередаёт строку заново с новыми значениями. Замаппьте идентификатор события, чтобы Meta распознала исправление, а не засчитала вторую конверсию.
Без измененийНичего не отправляет.
УдалённаяНичего не происходит. Переданную конверсию отозвать нельзя.

Первый запуск модели с длинной историей покупок отправит её целиком. Meta отклоняет конверсии старше семи дней, поэтому перед первым запуском ограничьте модель недавним периодом.

Ограничения

  1. Конверсии только добавляются.
    Переданное в пиксель нельзя ни исправить, ни удалить. Проверяйте маппинг тестовым кодом события до первого боевого запуска.
  2. События живут семь дней.
    Meta отклоняет конверсию, время которой старше семи дней, поэтому расписание должно успевать за моделью.
  3. Одно название события на пайплайн.
    Название события берётся из настроек пайплайна, а не из колонки. Чтобы передавать покупки и лиды, нужны два пайплайна на двух моделях.
  4. Сопоставление происходит внутри Meta.
    Renta считает событие доставленным, как только Meta его приняла. Сопоставилось ли оно с человеком и какой кампании атрибутировано, решает Meta, и это видно в Events Manager, а не в Renta.
  5. Запуск останавливается при потоке отказов.
    Renta останавливает запуск, когда отклонено больше 5% партии или больше 30% событий, доставленных с начала запуска. Уже принятые конверсии остаются в Meta, а следующий запуск продолжит с места остановки.
Часто задаваемые вопросы

Ready to get started?

Build your data pipeline today or get a personalized demo. Start free!

Need help?

Get expert support to ensure your project succeeds. We're here to help!

Feature requests?

Help shape our product! Share your ideas for new features and integrations.