Meta Custom Audiences
Renta собирает аудиторию Meta Custom Audiences из вашего хранилища данных: каждая строка модели становится человеком в аудитории, на которую вы таргетируетесь или которую исключаете из показов.
В строке только идентификаторы: поч та, телефон, имя, части адреса, рекламный идентификатор устройства или ваш собственный номер клиента. Renta хеширует их до отправки, поэтому Meta сопоставляет людей, не получая исходных контактов.
Аутентификация
Renta авторизуется через Meta OAuth. Авторизуйте аккаунт Facebook, у которого есть доступ к рекламному аккаунту с нужной аудиторией.
Подключение назначения Meta Custom Audiences
- Перейдите в раздел Connections > Catalog в левом меню и откройте вкладку Destinations.
- Откройте категорию Reverse ETL и нажмите карточку Meta Custom Audiences.
Нажмите Log in to your Meta Custom Audiences account. Meta откроется в этой же вкладке.
Подтвердите аккаунт Facebook и нажмите Continue. Кнопка Edit settings нужна, если хотите изменить, к каким бизнесам и рекламным аккаунтам получит доступ Renta. Meta вернёт вас в Renta.
Renta подтвердит выданный доступ и покажет авторизованный аккаунт. Завершите настройку:
- Destination name.
Укажите имя назначения. Оно используется только в интерфейсе Renta.
Нажмите Save.
Новое назначение появится в списке Destinations со статусом Active. Теперь его можно использовать в пайплайнах Reverse ETL.
Подготовка модели данных
Пайплайн Reverse ETL читает данные из модели данных: это SQL-запрос, сохранённый в разделе Data models, который решает, какие строки хранилища синхронизировать и что лежит в каждой строке. Создайте её до пайплайна, потому что списки в маппинге заполняются колонками модели.
В модели для аудитории нужны только идентификаторы. Суммы заказов и названия тарифов Meta здесь ни к чему, поэтому оставьте в запросе колонки, которые опознают человека.
-- Участники аудитории, подготовленные для Meta. Запрос возвращает строки, таблица не создаётся.
WITH demo_audience AS (
SELECT
'james.miller@example.com' AS email,
'+12125550101' AS phone,
'James' AS first_name,
'Miller' AS last_name,
'New York' AS city,
'NY' AS state,
'10001' AS zip,
'US' AS country,
'u-1001' AS external_id
UNION ALL SELECT 'olivia.johnson@example.com','+13125550102','Olivia','Johnson','Chicago','IL','60601','US','u-1002'
UNION ALL SELECT 'william.davis@example.com','+12145550103','William','Davis','Dallas','TX','75201','US','u-1003'
)
SELECT * FROM demo_audienceСоздание модели данных
В левом меню откройте Data models и нажмите New model. Затем:
- Source.
Выберите подключение хранилища, к которому пойдёт запрос. - Write your model query.
Вставьте свой SQL. Тип запроса оставьте SQL query. - Run preview.
Проверьте строки и названия колонок. Когда результат устраивает, нажмите Next step.
Для модели, которая питает пайплайны, выберите Reverse ETL only. Если та же модель должна отвечать и на вопросы агентов, выберите один из вариантов с AI agents.
Просмотрите колонки, которые Renta прочитала из запроса, и отметьте ту, что опознаёт строку. По этому ключу Reverse ETL отличает изменённую строку от новой, поэтому выбирайте колонку, по которой будете сопоставлять и в Meta, например адрес электронной почты.
Задайте имя и короткое описание, затем нажмите Create model. Именно это имя вы выберете в списке Data model при создании пайплайна.
Модель появится в списке с областью Reverse ETL и готова к использованию в пайплайне.
Создание пайплайна Meta Custom Audiences
Назначение и модель данных должны быть готовы до начала.
В левом меню нажмите New pipeline. На шаге Source переключитесь на Reverse ETL и выберите своё хранилище данных, например Google BigQuery.
Выберите подключение хранилища, в котором лежат ваши модели данных, и нажмите Next step.
На шаге Destination выберите Meta Custom Audiences в блоке Already connected и нажмите Next step.
Выберите подключение Meta, созданное ранее, и нажмите Next step.
Настройка пайплайна
На последнем шаге выберите, где живёт аудитория и какие колонки опознают людей в ней.
Что отправляет Renta
Выберите объект, модель данных и рекламный аккаунт.
- What would you like Renta to send to Meta.
Сейчас доступен единственный объект Custom Audience. Похожие аудитории и аудитории сайта Meta собирает сама, писать в них нельзя. - Data model.
Выберите модель для синхронизации. Из неё берутся колонки для сопоставления и маппинга ниже. - Ad account.
Рекламный аккаунт Meta, которому принадлежит аудитория. В списке все аккаунты, доступные авторизованному пользователю.
Аудитория
Решите, создаст ли Renta аудиторию сама или будет писать в уже существующую.
| Режим | Описание |
|---|---|
| Create a new audience | Renta создаёт аудиторию в выбранном рекламном аккаунте при создании пайплайна и дальше пишет в неё при каждом запуске. |
| Sync to an existing audience | Renta пишет в аудиторию, которую вы уже собрали в Meta. Нужно указать её идентификатор. |
Для новой аудитории заполните New audience name. Именно это имя вы увидите в Meta Ads Manager, поэтому сделайте его узнаваемым.
Сопоставление записей
Укажите, какая колонка опознаёт человека, чтобы одна и та же строка обновляла того же участника аудитории, а не добавляла ещё одного.
Левый список предлагает уникальный ключ модели данных, правый: идентификатор Meta с тем же значением. Renta отправляет сопоставленное значение с каждой строкой, поэтому повторять его в блоке маппинга ниже не нужно.
Маппинг полей
Маппите все идентификаторы, которые у вас есть. Meta засчитывает совпадение по любому из них, поэтому чем шире маппинг, тем больше аудитория.
| Группа | Поля |
|---|---|
| Прямые идентификаторы | Email address, Phone number, Mobile advertiser ID (IDFA / GAID), External identifier (ваш номер клиента) |
| Имя | First name, Last name, First initial |
| Демография | Gender, дата рождения отдельными полями: год, месяц и день |
| Локация | City, State / region, ZIP / postal code, Country |
Почту, телефон, части имени и поля локации Renta хеширует алгоритмом SHA-256 до отправки запроса. Рекламный идентификатор устройства и ваш номер клиента уходят как есть, потому что Meta сопоставляет их напрямую.
Поведение синхронизации
Задайте, что произойдёт с человеком, чья строка пропала из модели данных.
| Вариант | Описание |
|---|---|
| Ignore | Человек остаётся в аудитории. Вариант по умолчанию. |
| Remove from audience | Renta убирает человека из аудитории. Подходит, когда модель задаёт окончательный список тех, на кого показывать рекламу, например сегмент активных подписчиков. |
Декларации об аудитории
Meta требует объявить, что это за список и какие правила приватности к нему применяются.
-
Audience subtype.
Renta пишет только в Customer file audience, потому что аудитории других типов Meta собирает из своих пикселей и страниц. -
Customer file source Объявите, откуда взяты данные.
Значение Описание User-provided only Ваш бизнес с обрал данные напрямую у этих людей. Partner-provided only Данные получены от партнёра или стороннего поставщика. Both user-provided and partner-provided В списке смешаны оба источника. -
LDU country и LDU state Объявляют режим Limited Data Use, который Meta применяет для законов вроде CCPA. Обычный вариант это Auto-detect в обоих полях: Meta сама определит географию по данным. Указывайте значения явно, только если этого просит юридическая команда.
Дальше задайте имя пайплайна.
Поле Integration name задаёт имя пайплайна в интерфейсе Renta. Измените его так, как вам удобно.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную из интерфейса или через API. |
| Daily | Пайплайн запускается раз в сутки в указанное время обновления. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время старта каждого запуска) и нажмите Create pipeline.
Новый пайплайн появится в разделе Pipelines на вкладке Reverse ETL, где видно его запуски и прогресс.
Стратегия синхронизации
Renta синхронизирует данные инкрементально. Запуск сравнивает модель данных с состоянием, записанным на прошлом запуске, и отправляет только то, что изменилось. Так аудитория остаётся актуальной без ежедневной перезаливки целиком. Первому запуску сравнивать не с чем, и он отдаёт модель полностью.
| Состояние строки | Что делает Renta |
|---|---|
| Новая | Добавляет человека в аудиторию. |
| Изменённая | Отправляет идентификаторы заново, чтобы Meta пересопоставила человека по новым значениям. |
| Без изменений | Ничего не отправляет. |
| Удалённая | Действует по выбранной политике: оставляет человека в аудитории или убирает его. |
Ограничения
- Рекламный аккаунт должен принадлежать бизнесу.
В личном рекламном аккаунте Meta не даст ни создать, ни изменить аудиторию из клиентского списка. - Сопоставление на стороне Meta, а не Renta.
Renta считает строку доставленной, когда её принял Meta. Сколько людей за ней стоит, решается внутри Meta, а размер аудитории скрыт, пока она не станет достаточно большой. - Аудитории нужно время.
Meta обрабатывает загруженный список, прежде чем аудитория станет доступна в кампаниях, поэтому между успешным запуском и готовой аудиторией проходит время. - Запуск останавливается при массовых отказах.
Renta прекращает запуск, если отклонено больше 30% пакета или больше 10% строк, отправленных с начала запуска. Уже доставленные люди остаются в аудитории, а следующий запуск продолжит с места остановки.
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.