FAQ
Передача лидов из Facebook через Albato, Webjack, Apix-drive
Интеграция с Facebook (Lead Ads) с помощью сервиса Albato
Что нужно подготовить перед началом
Часть 1. Подключаем Facebook к Albato
Шаг 1. Выбираем сервис FacebookВ Albato: «Подключения» → «Добавить подключение» → в поиске вводим Facebook. В списке будет несколько вариантов — нужен именно первый, просто «Facebook*» (не Conversions API, не Pages, не «аудитории» — они отвечают за другие задачи, не за приём лидов).
- Аккаунт в Albato (albato.ru)
- Личный аккаунт Facebook с правами администратора на страницу, где созданы формы Lead Ads
- Опубликованная (не черновик) форма Lead Ads — см. отдельную памятку по её созданию через Ads Manager
- API-ключ из профиля onecrypt.link — https://onecrypt.link/u/profile
- ID оффера в onecrypt.link, под который заведена рекламная кампания
Часть 1. Подключаем Facebook к Albato
Шаг 1. Выбираем сервис FacebookВ Albato: «Подключения» → «Добавить подключение» → в поиске вводим Facebook. В списке будет несколько вариантов — нужен именно первый, просто «Facebook*» (не Conversions API, не Pages, не «аудитории» — они отвечают за другие задачи, не за приём лидов).
Шаг 2. Задаём название подключения
Вписываем понятное название, например, «Мой аккаунт Facebook», и нажимаем «Далее».
Вписываем понятное название, например, «Мой аккаунт Facebook», и нажимаем «Далее».
Шаг 3. Предоставляем доступ
Facebook предупреждает, что при смене пароля от аккаунта подключение слетит и потребуется переподключение — это нормально, просто держим в уме на будущее. Нажимаем «Предоставить доступ Albato» и проходим авторизацию тем аккаунтом Facebook, у которого есть права администратора на нужную страницу.
Facebook предупреждает, что при смене пароля от аккаунта подключение слетит и потребуется переподключение — это нормально, просто держим в уме на будущее. Нажимаем «Предоставить доступ Albato» и проходим авторизацию тем аккаунтом Facebook, у которого есть права администратора на нужную страницу.
Шаг 4. Подключение готово
После успешной авторизации нажимаем «Создать связку».
После успешной авторизации нажимаем «Создать связку».
Часть 2. Создаём связку (сценарий) с триггером Lead Ads
Шаг 5. Пустая связкаОткрывается конструктор связки. Нажимаем на блок «Добавить триггер» — событие, которое будет запускать всю цепочку.
Шаг 5. Пустая связкаОткрывается конструктор связки. Нажимаем на блок «Добавить триггер» — событие, которое будет запускать всю цепочку.
Шаг 6. Ищем Facebook среди источников
В поиске вводим Facebook — в списке будет 4 похожих варианта. Нужен именно первый, обычный «Facebook*».
В поиске вводим Facebook — в списке будет 4 похожих варианта. Нужен именно первый, обычный «Facebook*».
- Facebook* — приём данных из Facebook (лиды и т.д.) — этот
- Facebook Conversions API* — отправка событий в Facebook (обратное направление), не подходит
- Facebook Pages* — работа со страницей (посты, сообщения), не подходит
- Facebook аудитории* — загрузка контактов для таргетинга рекламы, не подходит
Шаг 8. Режим работы связки
Выбираем «В реальном времени» (сбор данных текущего периода) — именно так связка будет ловить новые заявки по мере поступления, а не разово выгружать архив. Нажимаем «Сохранить».
Выбираем «В реальном времени» (сбор данных текущего периода) — именно так связка будет ловить новые заявки по мере поступления, а не разово выгружать архив. Нажимаем «Сохранить».
Часть 3. Тестируем триггер
Шаг 9. Запускаем тест
Albato предложит протестировать триггер — нажимаем «Протестировать».
Шаг 9. Запускаем тест
Albato предложит протестировать триггер — нажимаем «Протестировать».
Шаг 10. Ожидаем вебхук
Нажимаем «Ожидание вебхука» — и, пока это окно открыто, отправляем тестовую заявку через саму форму на Facebook (превью объявления или Lead Ads Testing Tool).
Нажимаем «Ожидание вебхука» — и, пока это окно открыто, отправляем тестовую заявку через саму форму на Facebook (превью объявления или Lead Ads Testing Tool).
Шаг 11. Проверяем полученные данные
После отправки тестовой заявки Albato должен показать пойманные данные — ID страницы, ID формы, название формы, ID лида, дату создания и сами поля лида (в тесте пришли Full name и Phone number). Нажимаем «Продолжить работу с выбранными данными».
После отправки тестовой заявки Albato должен показать пойманные данные — ID страницы, ID формы, название формы, ID лида, дату создания и сами поля лида (в тесте пришли Full name и Phone number). Нажимаем «Продолжить работу с выбранными данными».
Часть 4. Настраиваем отправку лида в cpa.tl
Шаг 12. Добавляем действие «Отправить запрос»В связке добавляем следующий шаг — действие «HTTP Запрос / Исходящий webhook» → «Отправить запрос». В качестве подключения выбираем уже созданное ранее «Отправка в cpa.tl» (то же самое, что использовали для инструкции по лендингам — пересоздавать не нужно).
Шаг 12. Добавляем действие «Отправить запрос»В связке добавляем следующий шаг — действие «HTTP Запрос / Исходящий webhook» → «Отправить запрос». В качестве подключения выбираем уже созданное ранее «Отправка в cpa.tl» (то же самое, что использовали для инструкции по лендингам — пересоздавать не нужно).
Шаг 13. Заполняем параметры запроса
Метод — POST (уже проставлен по умолчанию из подключения). Урл можно оставить пустым — он подставится из настроек подключения. Дальше заполняем параметры:
Метод — POST (уже проставлен по умолчанию из подключения). Урл можно оставить пустым — он подставится из настроек подключения. Дальше заполняем параметры:
key | String | API-ключ из профиля onecrypt.link (статически, одинаково для всех лидов) |
name | String | поле Full name из данных вебхука Facebook (динамическое) |
phone | String | поле Phone number из данных вебхука Facebook (динамическое, обязательное) |
country | String | код страны — статически (на скрине для примера указано GT, вписать нужное значение под вашу кампанию) |
offer_id | Int | ID оффера, под который льётся эта кампания/форма (статически, свой для каждой кампании) |
ip_address | String | статическая заглушка 0.0.0.0 (обязательное — см. предупреждение в начале документа) |
Обязательные поля по спецификации API onecrypt.link: key, offer_id, phone, ip_address — без них лид не будет принят.
Сохраняем настройки параметров.
Финальная проверка
Интеграция готова. Отправляем ещё одну тестовую заявку через форму на Facebook и проверяем всю цепочку:
Сохраняем настройки параметров.
Финальная проверка
Интеграция готова. Отправляем ещё одну тестовую заявку через форму на Facebook и проверяем всю цепочку:
- В Albato: история запусков связки — оба шага (триггер Facebook и HTTP-запрос) отработали без ошибок, ответ HTTP-запроса вернул HTTP 200 и JSON с id лида.
- В onecrypt.link: тестовая заявка появилась в системе (искать удобно по номеру телефона из теста).
- Если всё дошло — связку можно оставить включённой для постоянной работы.
- Нет прав администратора на страницу с формами — самая частая причина сбоя интеграции с Facebook.
- Форма лидов в статусе черновика — Albato не увидит её в списке, пока объявление с формой не пройдёт публикацию (запускать показы при этом не обязательно, можно сразу поставить кампанию на паузу).
- Тестовые данные не приходят при нажатой «Ожидание вебхука» — проверьте, что тестовая заявка отправляется именно через ту форму, которая указана в Шаге 7, и что окно ожидания ещё открыто в момент отправки.
- Лид дошёл без имени/телефона — проверьте, что в форме на Facebook эти вопросы вообще есть и включены.
- Ошибка «некорректный IP-адрес» от onecrypt.link — убедитесь, что в параметре ip_address передаётся согласованная заглушка 0.0.0.0, а не пустое значение.
Интеграция с Facebook с помощью сервиса webjack.ru.
Создайте "Обработку" в Webjack. В ней настраивается что/откуда получать и куда/как передавать.
Нажмите кнопку “Создать”,
Нажмите кнопку “Создать”,
Укажите название для "Обработки" и нажмите "Cохранить"
Добавьте “Источник данных”, нажмите кнопку “Добавить”
Шаг 1. Из списка выберите "Facebook - Лид-формы"
Шаг 2. Выберите "пользователя Facebook"
Шаг 3. Нажмите “Подключить”
Шаг 3. Нажмите “Подключить”
Шаг 4. Авторизуйтесь в Facebook
Пользователь под которым вы будете авторизоваться должен имеет доступ
Пользователь под которым вы будете авторизоваться должен имеет доступ
- к скачиванию лид-форм страницы
- к рекламной кампании
Шаг 4. Авторизуйтесь в Facebook
Пользователь под которым вы будете авторизоваться должен имеет доступ
Пользователь под которым вы будете авторизоваться должен имеет доступ
- к скачиванию лид-форм страницы
- к рекламной кампании
Шаг 6. Нажмите кнопку “Выбрать”
Выберите страницу Facebook.
Шаг 1. Нажмите на кнопку выбора страницы Facebook.
Шаг 1. Нажмите на кнопку выбора страницы Facebook.
Шаг 2. Выберите страницу Facebook
После выбора страницы будут отображены все лид-формы.
После выбора страницы будут отображены все лид-формы.
Выберите лид-формы
Шаг 1. Отметьте лид-формы, заявки с которых необходимо получать.
Если нужно получать заявки только с некоторых форм, то надо отметить нужные.
Если нужно получать заявки со всех форм, то ничего не отмечайте.
Шаг 1. Отметьте лид-формы, заявки с которых необходимо получать.
Если нужно получать заявки только с некоторых форм, то надо отметить нужные.
Если нужно получать заявки со всех форм, то ничего не отмечайте.
Шаг 2. Нажмите кнопку "Сохранить"
Отправка заявки в ПП.
Шаг 1. Добавьте действие "Отправка лида в Traffic Light"
Шаг 1. Добавьте действие "Отправка лида в Traffic Light"
Выберите действие "Отправка лида в Traffic Light" (наш общий партнёрский проект)
Шаг 2. Заполните поля в этом действии, как на скриншоте:
Ниже расписан список полей и их возможные значения:
- Ключ доступа к API - key. Ключ доступа к API, получите в профиле https://onecrypt.link/u/profile
ID лида - id. ID лида в вашей системе. Это может быть id лида из Facebook
- ID оффера - offer_id. ID оффера в нашей партнёрке
ID потока - stream_hid. ID потока в Traffic Light можно скопировать на странице https://onecrypt.link/streams/
- IP-адрес - ip_address. IP адрес лида.В тех случаях, когда IP-адрес получить невозможно, например для лид-форм ТикТок, Facebook и т.п. укажите IP-адрес 0.0.0.0ФИО покупателя - name.
- Имя или ФИО покупателя*
- Телефон покупателя - phone. Телефон покупателя. Формат номера может быть любой Комментарии к заказу - comments. Комментарии к заказу*
- Код страны покупателя - country. Двухбуквенный код страны покупателя. Например, RU, UA, KZ.Ссылка на возможные значения кодов стран в столбце "Alpha-2" по ссылке https://ru.wikipedia.org/wiki/ISO_3166-1Адрес покупателя
- - address. Адрес покупателя
- Временная зона - tz.Число, соответствующее временной зоне. Например, 3 для Europe/Moscow или 6 для зоны UTC+6ID вебмастера
- - web_id. ID вебмастера в вашей системе. Указываем значение 0Email покупателя - email. Email покупателяСтрока User-Agent - user_agent. Можно оставить пустым.Идентификационная строка клиентского приложения.
Поля UTM-меток:
UTM Source - utm_source
UTM Medium - utm_medium
UTM Campaign - utm_campaign
UTM Content - utm_content
UTM Term - utm_term
Поля для дополнительной информации:
Доп. инфо 1 - sub1
Доп. инфо 2 - sub2
Доп. инфо 3 - sub3
Доп. инфо 4 - sub4
Доп. инфо 5 - sub5
Ссылка на инструкцию по передаваемым полям https://cpa.tl/help/api/#send_lead
UTM Source - utm_source
UTM Medium - utm_medium
UTM Campaign - utm_campaign
UTM Content - utm_content
UTM Term - utm_term
Поля для дополнительной информации:
Доп. инфо 1 - sub1
Доп. инфо 2 - sub2
Доп. инфо 3 - sub3
Доп. инфо 4 - sub4
Доп. инфо 5 - sub5
Ссылка на инструкцию по передаваемым полям https://cpa.tl/help/api/#send_lead
- Нажмите на кнопку "Сохранить"
Запустите обработку.
- Нажмите на кнопку "Запустить"
Запустите обработку.
- Нажмите на кнопку "Запустить"
С этого момента данные будут обрабатываться.
Как все будет работать?
Как все будет работать?
- В обработку будут поступать данные из настроенного вами "Источника данных"
- Поочередно будут выполняться все действия, которые вы настроили
- Все поступающие в обработку данные, а также статус и история их обработки будут отражаться в "Истории операций"
- В случае возникновения каких-либо ошибок в процессе обработки, вы получите письмо-уведомление на email.
Интеграция с Facebook с помощью сервиса Apix-drive.
Необходимо залогиниться в сервисе и нажать "Создать связь":
Выберите систему в качестве Источника данных. В данном случае необходимо указать Facebook.
Далее, необходимо указать действие "Загрузить лиды":
Следующий шаг - выбор аккаунта Facebook, из которого будет происходить выгрузка лидов.
Если нет подключенных логинов к системе кликните "Подключить аккаунт".
Если нет подключенных логинов к системе кликните "Подключить аккаунт".
Дайте свое разрешение ApiX-Drive на работу с этим аккаунтом.
Кликните "Изменить настройки" и отметьте галочками доступ к нужным страницам.
Рекомендуем вам выдать доступ сразу ко всем имеющимся страницам, не переживая за конфиденциальность, т.к. у наших сотрудников нет доступа к данным вашего рекламного аккаунта.
Кликните "Изменить настройки" и отметьте галочками доступ к нужным страницам.
Рекомендуем вам выдать доступ сразу ко всем имеющимся страницам, не переживая за конфиденциальность, т.к. у наших сотрудников нет доступа к данным вашего рекламного аккаунта.
Оставьте отмеченными все галочки настроек доступа.
Когда подключенный аккаунт отобразился в списке "Активные аккаунты", выберете его для дальнейшей работы.
Обратите внимание!
Если в выпадающем списке нет необходимой рекламной страницы или после подключения рекламного кабинета у вас появился доступ к новым рекламным страницам, вам нужно будет подключить аккаунт Facebook заново.
Для этого выполните следующие действия:
1. Проверьте наличие админ доступа к нужным рекламным страницам.
2. Перейдите в раздел Интеграции - Рекламные системы - Facebook и удалите подключенный аккаунт.
3. Перейдите на главную страницу и отключите автообновление связи.
4. Перейдите в связь на этап Доступ в Источнике данных Facebook и подключите аккаунт, нажмите на "Изменить настройки" в появившемся окне и отметьте галочками все имеющиеся у вас рекламные страницы. Если окно не появляется, а ваш аккаунт подхватывается из браузера автоматически, то повторите п.1-2, залогинившись в браузере через режим инкогнито.
5. Заново настройте Источник данных и загрузите тестовые данные на этапе Проверить.
6. Если у вас были созданы другие связи с Facebook, то нужно перейти в эти связи на этап Доступ в Источнике данных, выбрать подключенный аккаунт и заново настроить Источник данных.
7. Если потребуется, доназначьте новые поля по формам в настройках Приема данных.
Выберите формы, по которым будет происходить выгрузка лидов или выберите параметр выгрузки по всем существующим и новым формам автоматически.
Если в выпадающем списке нет необходимой рекламной страницы или после подключения рекламного кабинета у вас появился доступ к новым рекламным страницам, вам нужно будет подключить аккаунт Facebook заново.
Для этого выполните следующие действия:
1. Проверьте наличие админ доступа к нужным рекламным страницам.
2. Перейдите в раздел Интеграции - Рекламные системы - Facebook и удалите подключенный аккаунт.
3. Перейдите на главную страницу и отключите автообновление связи.
4. Перейдите в связь на этап Доступ в Источнике данных Facebook и подключите аккаунт, нажмите на "Изменить настройки" в появившемся окне и отметьте галочками все имеющиеся у вас рекламные страницы. Если окно не появляется, а ваш аккаунт подхватывается из браузера автоматически, то повторите п.1-2, залогинившись в браузере через режим инкогнито.
5. Заново настройте Источник данных и загрузите тестовые данные на этапе Проверить.
6. Если у вас были созданы другие связи с Facebook, то нужно перейти в эти связи на этап Доступ в Источнике данных, выбрать подключенный аккаунт и заново настроить Источник данных.
7. Если потребуется, доназначьте новые поля по формам в настройках Приема данных.
Выберите формы, по которым будет происходить выгрузка лидов или выберите параметр выгрузки по всем существующим и новым формам автоматически.
Обратите внимание!
Если вы изменили поля в текущей форме или добавили новую форму в личном кабинете Facebook, необходимо в ApiX-Drive перезатянуть актуальные данные.
Для этого, выполните следующие действия:
1. Перейдите на этап Доступ в Источнике данных, ничего не меняя нажмите "Изменить и продолжить".
2. Выберите заново рекламную страницу и формы.
3. Дойдите до этапа Проверить и нажмите "Загрузить тестовые данные из Facebook".
4. После появления актуальных полей сбора контактов по всем формам перейдите на этап Изменить настройки в Приеме данных и назначьте эти переменные в нужные поля системы приема.
Если необходимо, вы можете настроить Фильтр данных, либо кликнуть "Продолжить", чтобы пропустить этот шаг.
Если вы изменили поля в текущей форме или добавили новую форму в личном кабинете Facebook, необходимо в ApiX-Drive перезатянуть актуальные данные.
Для этого, выполните следующие действия:
1. Перейдите на этап Доступ в Источнике данных, ничего не меняя нажмите "Изменить и продолжить".
2. Выберите заново рекламную страницу и формы.
3. Дойдите до этапа Проверить и нажмите "Загрузить тестовые данные из Facebook".
4. После появления актуальных полей сбора контактов по всем формам перейдите на этап Изменить настройки в Приеме данных и назначьте эти переменные в нужные поля системы приема.
Если необходимо, вы можете настроить Фильтр данных, либо кликнуть "Продолжить", чтобы пропустить этот шаг.
Теперь вы можете увидеть тестовые данные по одному из лидов.
Если у вас форма настроена, но реклама не запущена, поля с контактными данными будут пустыми, а заполнятся для примера тестовыми данными Apix-drive.
Желательно дождаться данных по реальному лиду или сгенерировать тестовые данные в вашем кабинете Facebook вручную.
Если у вас форма настроена, но реклама не запущена, поля с контактными данными будут пустыми, а заполнятся для примера тестовыми данными Apix-drive.
Желательно дождаться данных по реальному лиду или сгенерировать тестовые данные в вашем кабинете Facebook вручную.
Обратите внимание!
Если вы выбрали сразу несколько форм, то на этом этапе загрузится лид по одной из форм, а поля подгрузятся, которые настроены по всем формам. То есть, если у вас по одной форме настроены поля "first-name" и "phone_number", они будут заполнены, а по другой поля "полное_имя" и "номер_телефона" будут пустыми, но назначить в системе Приема данных вам нужно все эти четыре поля, потому что когда прийдет лид с заполненными другими полями, в поля системы Приема данных ничего выгружено не будет.
На этом вся настройка источника данных завершена. Теперь вы можете приступить к настройке системы Приема данных.
Если вы выбрали сразу несколько форм, то на этом этапе загрузится лид по одной из форм, а поля подгрузятся, которые настроены по всем формам. То есть, если у вас по одной форме настроены поля "first-name" и "phone_number", они будут заполнены, а по другой поля "полное_имя" и "номер_телефона" будут пустыми, но назначить в системе Приема данных вам нужно все эти четыре поля, потому что когда прийдет лид с заполненными другими полями, в поля системы Приема данных ничего выгружено не будет.
На этом вся настройка источника данных завершена. Теперь вы можете приступить к настройке системы Приема данных.