Общая логика

Garpun через свой сервис фиды (потоки) имеет возможность получать уведомления о заполнении и содержание форм лидогенерации от Facebook в режиме близком к он-лайн (10-60 сек). Далее есть возможность сделать настройки на отправку полученных данных по email, а также при необходимости настроить их выгрузку в BigQuery.

Настройка

1.Источник данных > Приемник данных

    а) "Новые лиды" - для получения уведомлений на email'ы и (если настроено) запись в BigQuery данных о новых лидах.

    б) "Исторические данные" (настройка BigQuery обязательна!) - выгрузка всех данных о лидах по настройкам странице и формам указанным выше и их сохранение в BigQuery.

3.Настройка приемника данных

Если в качестве приемника данных у нас выбрано "Ничего не делать", то :

нам нужно нажать только кнопку "Далее", чтобы перейти к "Общим настройках".

Если приемником данных является BigQuery, то:

- выбрать проект (Project ID) куда будут загружены данные в BigQuery.

- задать датасет (DataSet ID) в BigQuery

- в графе “Префикс для уникализации таблиц” для статистики рекомендуется задать – facebook_lead_{page_name}, где: {page_name} – название страницы латиницей через нижнее подчеркивания вместо пробелов, если таковые есть.

- в графе “Партицировать по полю”  - ввести "created_time" (без кавычек)

-в поле "Способ записи данных в таблицу" нужно выбрать из 3х вариантов: 1) обновить данные в таблице за выбранный период 2) добавить данные в таблицу 3) перезаписать всю таблицу

- нажать “Далее”

4. Общие настройки

- в графе “Название потока” ввести название для сохранения данного фида.

- в графе “Период сбора при автоматическом запуске” можно выбрать как часто будет запускаться фид

- в графе “Расписание” - выбрать например 8:00 утра, в это время фид  будет ежедневно проверять доступность подключение для возможности получения лидов от Facebook

- нажать “Готово” 

Подписываем фид на страницу (важно)

Данный пункт нужно сделать один раз для того чтобы созданный ранее фид поток подписался на конкретную страницу Facebook.

Важно: если редактируются настройки фида все кроме выбранной для мониторинга страницы то процедуру подписи фида на страницу повторять не надо. Если по каким-то причинам, нужно изменить страницу, то процедуру подписи фида на страницу надо повторить.

Процедура:

- после создания фида (потока) в предыдущем пункте вы будете переброшены на страницу созданного фида (потока) – нажмите большую кнопку “Запустить обработку” (START PROCESSING). В графе “Статус” (State) спустя небольшой период времени должно появиться “SUCCESS” (Successfully). Если итоговый статус другой, смотрим есть ли сообщение об ошибке в графе “Last error”. Если ее нет, то смотрим раздел “Возможные проблемы”.

Тестирование

После создания и подписи на страницу фида (потока) его можно простестить специальной утилитой от Facebook: https://developers.facebook.com/tools/lead-ads-testing

- переходим по указанной выше ссылке

- выбираем настроенную ранее страницу и форму.

- Нажимаем “Создать лид” (“Create lead”) - если ранее уже создавался тестовый лид, то появится ошибка и его вначале надо удалить через кнопку “Удалить лид” (“Delete lead”), а потом заново создать.

- После создания тестового лида внизу страницы под плашкой “Отслеживание” “Track Status” - можно посмотреть его статут или наличие каких-то сообщений об ошибке.

- спустя 10-60 сек вы должны будете получить письмо с тестовым лидом от ранее настроенного фида (потока), если все прошло успешно.

Экспорт данных в Google Sheets (Таблицы) из BigQuery

Необходимое условие: логин под которым настраивается выгрузка из BigQuery в Google Sheets (Таблицы) должен иметь доступ к данным в BigQuery (как его получить - см. пункт б) в "Настройка)

Процедура:

- создаем документ Google Sheets (Таблицы)

- в шапке выбираем "Данные" → "Подключения к базам данных" → "Подключиться к BigQuery"

- выберите проект куда были загружены данные

- Нажмите "Написать запрос" - отобразится поле для запроса, а с лева от него список всех датасетов и таблиц в проекте. Необходимо найти свой датасет (dataset) и таблицу (table_id), которые были настроены ранее, и заполнить соответсвующие плейсхолдеры (вместе с фигурными скобками) в запросе ниже ниже, и ввести его в соответсвующее поле без кавычек сверху и снизу:

"""

WITH leads_data AS (
SELECT created_time, lead_id, CONCAT(fd.name, ': ', fd.values [ORDINAL(1)]) AS value
FROM {dataset}.{table_id}, UNNEST (field_data) AS fd
GROUP BY created_time, lead_id, value
ORDER BY value)
SELECT created_time, lead_id, STRING_AGG(value, '\n') as lead_info
FROM leads_data
GROUP BY created_time, lead_id

"""

 

Дополнение: META добавляет к названиям таблиц в конце "_meta"

- В результате должна загореться зеленая галка внизу - что говорит о корректности запроса

- Нажать "Вставить результаты" (или "Предпросмотр" если надо проверить данные перед вставкой)

- Данные должны появиться в таблице, также появится кнопка "ОБНОВИТЬ" - для повторного принудительного обновления

Лайфхак: если необходимо к этим данным дополнительные колонки в таблице, то можно на новом листе в данном документе сделать, колонки которые будут ссылать на данные запроса к базе данных, т.е. по сути колонка = колонка, но дополнительно появится возможность использовать дополнительные колонки. Порядок лидов отсортирован по дате и не изменяется, новые лиды добавляются вниз документа. 

 

Возможные проблемы

- если при тесте в статусе “Отслеживание” “Track Status” появилась ошибка “CRM access has been revoked from Lead Access Manager. Read More.” - как ее решить описано здесь: https://www.facebook.com/business/help/1440176552713521 – ее причина некорректно настроенный доступ лидам (для подобных сервисов доступ должен быть дефолтный, а при такой ошибке были назначены конкретные люди. Нужно скинуть настройки до дефолтных. Эта рекомендация дается всеми подобными сервисами).

По другим проблемам см. пункт ниже.

 

Дополнительные данные:

Т.к. проблемы у всех подобных сервисов общие, то если появилась ошибка при тесте либо не были получены уведомления, до до обращения в техподдержу посмотрите свою проблему здесь: https://zapier.com/apps/facebook-lead-ads/help#common-problems-facebook-lead-ads