linkДокументация по модулю "Динамическая реклама в Facebook и Instagram"

Данный модуль предназначен для запуска ретаргетинга в рекламных системах Facebook и Instagram.

Технически данный модуль расширяет модуль Универсальный товарный экспорт (документация к модулю) добавляя шаблон выгрузки товарного фида согласно требований этих рекламных площадок, плюс добавляет аналитическую часть отслеживаний действий пользователя в вашем магазине.

Какие события (действия пользователя) отслеживает добавляемый пиксель:

• ViewContent - просмотр товара (как быстрый просмотр, так и переход на страницу товара);
• AddToCart - добавление товара в корзину;
• InitiateCheckout - переход на страницу оформления заказа;
• Purchase - оформление заказа (как полное оформление, так и заказ в 1 клик);
• AddToWishlist - добавление товара в отложенные;
• Search - использование поиска товаров на сайте;
• PageView - просмотр любой страницы.

Модуль совместим со следующими Темами:

• YoupiTheme (совместимых с соответствующей версией CS-Cart);
• UniTheme2 (совместимых с соответствующей версией CS-Cart);
• Responsive.

Общие условия технической поддержки доступны по этой ссылке (обязательно изучите эти условия, все решения от команды разработчиков AlexBranding поставляются с ограниченной технической поддержкой).

Для того, чтобы воспользоваться нашей технической поддержкой, выполняйте следующую последовательность действий:

1. На сайте https://cs-cart.alexbranding.com авторизуйтесь под своей учетной записью владельца заказа;
2. Перейдите на страницу Мой профиль → Заказы;
3. Найдите соответствующий заказ с решением (по которому у Вас есть проблема) в списке заказов и перейдите к его деталям;
4. Найдите ссылку Техническая поддержка рядом с названием модуля (по которому вам необходима помощь) и нажмите ее;
5. Заполните данные с проблемой, предоставьте доступы к Вашей установке (обязательно путь к административной панели, почту и пароль администратора + FTP доступы) и создайте тикет (после того, как будет создан тикет, Вы получите письмо на e-mail и специальный код для отслеживания тикета в дальнейшем);
6. Ожидайте ответ специалиста (на электронную почту владельца заказа с темой) в соответствии с регламентами работы службы техподдержки и выбранным Вами приоритетом решения.

Если Вы не получили ответ в течении сроков, обозначенных в регламентах, напишите на почту info@alexbranding.com с номером тикета, по которому вовремя не получили ответ, и менеджер команды разработчиков решит проблему с соблюдением регламентов.

Протестировать работу модуля, с доступом к административной панели магазина, Вы сможете на нашем сервере Демо решений для CS-Cart от Alexbranding выбрав его в списке Модулей или просто перейдите по ссылке.

Рекомендуем ознакомиться с общими ограничениями:

1. Все модули и решения команды AlexBranding требуют предварительной установки сервисного модуля AB: Менеджер Модулей. Он поставляется бесплатно и отвечает за вопросы: установки, обновления, лицензионной проверки модулей. Исключить использование этого сервисного модуля не представляется возможным;
2. Файлы модуля могут иметь закрытую (закодированную) часть, в которой находится исключительно проверка лицензии;
3. Модуль будет работать только на тех доменах, которые указаны в лицензии пользователя. При попытке использования решения на установках CS-Cart, домены которых не включены в лицензию, модуль будет автоматически выключен;
4. Установка локально не допускается системой лицензирования, чтобы модуль работал на дополнительном домене (поддомене) укажите этот домен (поддомен) в поле Домен при заказе (или напишите на info@alexbranding.com) — добавление технических доменов для разработчика или для тестирования — бесплатно.

После того, как Ваш заказ будет обработан нашим менеджером, он будет переведен в состояние Выполнен, Вы получите письмо на Ваш почтовый ящик с номерами лицензий заказанных модулей (обычно это требует от 15 минут до 8 часов в зависимости от времени суток и дня недели).

Далее выполняйте следующую последовательность действий, которая отличается в зависимости от вашей версии платформы CS-Cart:

Также, Вы можете установить модуль стандартной установкой для CS-Cart. Для этого, скачайте соответствующий архив с совместимой с Вашей версией платформы CS-Cart версией модуля.
Перейдите на сайт cs-cart.alexbranding.com, авторизуйтесь под учетной записью владельца заказа и перейдите в Мой профиль → Заказы → Соответствующий заказ, перейдите в его детали и Вы увидите список доступных архивов для заказанного модуля. Скачайте необходимую Вам версию (архив) и произведите установку (стандартная для CS-Cart установка: Модули → Скачанные модули и в меню шестерёнки выберите Ручная установка).

Для доступа к настройкам модуля необходимо перейти на страницу Панель администратора → Модули → Управление модулями и у названия модуля в меню шестерёнки выбрать соответствующий пункт меню.

Модуль устанавливает Пиксель Facebook на Ваш сайт, отслеживая следующие события:

• ViewContent - просмотр товара (как быстрый просмотр, так и переход на страницу товара);
• AddToCart - добавление товара в корзину;
• InitiateCheckout - переход на страницу оформления заказа;
• Purchase - оформление заказа (как полное оформление, так и заказ в 1 клик);
• AddToWishlist - добавление товара в отложенные;
• Search - использование поиска товаров на сайте;
• PageView - просмотр любой страницы.

В настройках модуля обязательно укажите FB_PIXEL_ID.

Для настройки динамической рекламы сформируйте каталог товаров для Facebook:

• Создайте первый шаблон формата csv, используя документацию к модулю АВ: Универсальный товарный экспорт (выбрав шаблон по умолчанию Facebook remarketing feed);
• Далее, следуя документации, создайте выгрузку, используя созданный шаблон в п.1 и произведите первую генерацию файла фида;
• Настройте периодичность перегенерации файла, используя предлагаемую ссылку для CRON генерации (вкладка Общие настройки в редактировании выгрузки — нижняя часть).

Для редактирования дополнительных настроек фида перейдите на вкладку Дополнительные параметры на странице редактировании выгрузки.

Чтобы перейти к настройкам выгрузки товаров для прайс-агрегаторов перейдите на страницу Панель администратора → Товары → Товары → [название товара] → вкладка "Модули". В секции AB: Выгрузка товаров для прайс-агрегаторов (шаблон Facebook remarketing) в поле Состояние товара доступны три варианта значений:

• Новый;
• Отремонтированный (после реконструкции);
• Бывший в употреблении.

С шаблоном Facebook remarketing можно работать через CSV файл. В экспорте содержится поле состояния товара, которое указывается на странице редактирования товара.
Чтобы выполнить экспорт/импорт перейдите на страницу Панель администратора → Администрирование → Экспорт/Импорт данных → Товары.

Файл app/addons/ab__product_fe05_facebook_ads/func.php
Используйте этот хук чтобы исключать отправку Пикселем определенных событий, либо изменять отправляемые данные. Доступные параметры:
$event - string - название события,
$data - array - данные события,
$result - bool - разрешена ли отправка.