...

• нажимаем кнопку  
  

•  выбираем источник данных “Facebook Leads” 
  в качестве приемника данных нужно выбрать "Отправлять лиды на email и в telegram"либо "GoogleBigQuery". Далее нужно нажать "Далее".
  Image Modified

  2.Настройка источника данных

• выбрать уже подключенный или добавить новый аккаунт у которого есть доступ к странице, где располагаются формы лидогенерации. При новом подключении автоматически скачаются все страницы и формы доступные под данным аккаунтом. У ранее подключенных логинов данное содержимое обновляется автоматически несколько раз в день.
  
   Важно! Подключенный доступ должен иметь права администрирования страницы.
  
  
  
• выбрать страницу (Page Id) для которой настраиваем фид

...

•  далее есть возможность добавить email’ы для рассылки полученных данных. Каждый последующий email добавляется через кнопку 
• вносим идентификатор чата телеграмм (для того, чтобы его получить вам необходимо написать команду /start боту Garpun.feeds)боту https://t.me/Garpun_bot
• задаем название чата произвольно
• далее можно указать желаемый заголовок письма (Letter title). Либо по умолчанию будет “'New Facebook Leads on page {page_name}”, где: {page_name} – название страницы. Отправитель письма – “Garpun Facebook Leads”
• для того, что была более полная информация в письме о лиде , можно добавить те поля, которые вы хотите видеть в поле "Extra lead ads data"
• нажимаем “Далее” 

...

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

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

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

...

Так выглядит выгрузка лидов в BQ:

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

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

Данный пункт нужно сделать один раз для того чтобы созданный ранее фид поток подписался на конкретную страницу 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