Компонент FacebookLeads: отслеживание лидов

Компонент создан для работы с Facebook Lead Ads.

Lead Ads - инструмент для работы с рекламой на Facebook; представляет собой объявления с формой обратной связи. Компонент автоматически собирает заявки с таких форм за определенный период в csv-файл и рассылает этот файл на заданные email'ы.

Установка

1. Устанавливаем стандартным способом через меню разработчика ("Компоненты => Библиотека компонентов => FacebookLeads: отслеживание лидов").

2. Через composer устанавливаем библиотеку fаcebook/php-ads-sdk:

composer require facebook/php-ads-sdk

Библиотека на гитхабе: https://github.com/facebook/facebook-php-ads-sdk

3. В index.php подключаем компонент:

// .../index.php
include('../vendor/autoload.php');
...
Core::load('Component.FacebookLeads');

Настройки

Обязательные настройки, без которых компонент не заработает, необходимо устанавливать в файле FacebookLeads/app/config/component.php. По умолчанию настройки значений не имеют.

• app_id - идентификатор приложения;
• app_secret - секрет приложения;
• token - маркер доступа;
• page - ID страницы;
• email_from - email отправителя. Задается в виде строки;
• emails_to - список email'ов, на которые отсылаются заявки. Можно задать как в виде строки (заполняем адреса через запятую), так и в виде массива.

Также можно задать список получателей через vars в админке. Указывается в формате var:. Тип поля в vars также можно задать строкой или массивом.

Подробнее о vars в статье CMS.Vars: настройка пользовательских переменных.

Пример:

// FacebookLeads/app/config/component.php
...
    'emails_to' => 'var:fb_emails',
...

// /admin/vars/edit/id-fb_emails/ (тип - массив)
1 = info@your_site.ru
2 = admin@your_site.ru

Остальные необязательные настройки связаны с Facebook API доступны в FacebookLeads/config/component.php. Часть этих настроек имеет значение по умолчанию.

• 'subject => 'Лиды с фейсбука' - тема письма
• 'text_message' => 'leads' - текст письма
• 'period_in_minutes' => 60 - за какой период присылать заявки, время в минутах от текущего момента (по умолчанию за последние 60 минут)
• 'test_period' => 60000 - то же самое, но для debug-mode (теста работы компонента)
• 'test_emails_to' - email для debug-mode (тест работы компонента; формат тот же, что и для 'emails_to')

Как работает компонент

Чтобы компонент заработал, необходимо повесить на cron исполнение CLI-команды facebookleads_handle.

Важно! Периодичность запуска скрипта должна совпадать с заданным в настройках периодом, за который присылаются заявки.

По умолчанию заявки присылаются за последние 60 минут, поэтому и facebookleads_handle должен запускаться каждый час.

Если нужно забирать заявки реже - например, раз в сутки, то, соответственно, устанавливаем этот период для cron и в настройках компонента указываем:

// FacebookLeads/app/config/component.php
...
    'period_in_minutes' => 1440 // минут в сутках
...

Тестирование работы компонента

Компонент установлен и все необходимые настройки заданы. Если реклама на Facebook включена, то можно запустить тест.

Для этого нужно в консоли запустить специально созданный для этого скрипт facebookleads_test.

Его отличия от основного рабочего скрипта facebookleads_handle:

• убирается проверка на активность форм;
• тестовый период - 60 000 минут (= 1000 часов, ~ 41 день); можно изменить в настройках;
• письмо с лидами приходит на email для тестов, если он задан в настройке test_emails_to; если нет - на адрес(-а), указанные в emails_to.

Если всё работает, вешаем запуск facebookleads_handle на cron.