facebook api conversions php
Как настроить Facebook API Conversions и для чего нужен этот инструмент?
Соцсеть Facebook представила новый инструмент API Conversions, данные с которого можно применить в таргетинге, а также для оптимизации и замеров эффективности рекламы на Фейсбук. Однако из-за изменения политики некоторых барузеров и мобильных платформ, например, iOS 14, ряд функций пикселя могут быть недоступны. Как это повлияет на маркетинг в Фейсбук и как настраивать API Conversions, разберемся детальнее в рамках статьи.
Facebook API Conversions – что это и для чего нужно?
Обновления Фейсбук в первую очередь коснутся владельцев устройств под управлением iOS14. Пользователи уже заметили уведомления об обновлениях в Facebook, которые так или иначе повлияют на рекламу. Суть проблемы состоит в том, что с iOS14 будет сложнее отслеживать поведение пользователей посредством приложений и сайтов. Независимо от выбранных настроек, Apple ограничивает возможность отслеживать события. Решить проблему можно при помощи API конверсии.
API конверсии – инструмент Фейсбук для бизнеса, который позволяет отправлять данные со своего сервера на сервер соцсети.
В чем преимущества API конверсий
Преимущества API конверсий очевидны: они позволяют отслеживать эффективность рекламы, даже в случае установки пользователем блокировщика рекламы либо использовании устройства на iOS.
Как настроить Facebook API Conversions
Разберем пошагово, как выполнить настройку API конверсий для сайта.
Проверка домена
При запуске рекламы, которая оптимизирована для событий сайта, необходимо подтвердить верификацию домена. Для этого:
Следуем инструкциям для завершения проверки. Когда домен проверится, он будет отмечен зеленой точкой.
Процесс настройки зависит от платформы, на которой располагается сайт. Чаще всего платформы уже внедрили интеграцию для API конверсий Facebook. Если вашей платформы нет в списке, поищите в поиске, есть ли вообще интеграция. Если нет, то Zapier может быть самым подходящим вариантом.
Настройка API конверсий для сайта на WordPress может производиться двумя способами:
Настройка с помощью PixelYourSite
Для настройки API конверсии при помощи плагина сперва устанавливаем и активируем сам плагин, воспользовавшись панелью управления CMS.
Добавление событий для отслеживания
Чтобы настроить события заходим в «Настройки» Events Manager и в «Настройка событий» жмем «Открыть инструмент настройки событий». После этого можно добавлять события, которые требуется отслеживать на веб ресурсе.
Настройка агрегированного измерения событий
В Фейсбук можно просто настроить события, которые уже были запущены на сайте. Для этого:
Итоги
API Conversions помогут отслеживать события сайта, независимо от обновлений iOS и блокировщиков рекламы. При этом важно провести настройки API уже сегодня, чтобы не утратить данные о конверсиях, после вступления обновлений в силу.
Как настроить Facebook Conversion API с помощью GTM Server Side
Отслеживание событий на стороне сервера и Conversion API были доступны на Facebook в течение нескольких лет. Но, начиная с 2021 года, FB стал активнее это продвигать. Если у вас есть свой менеджер в Facebook, помогающий с вашей учетной записью, он, скорее всего, позвонит вам и порекомендует настроить Conversion API.
По этому если с вами уже связались или вы сами решили что вам нужно настроить CAPI (Conversion API) прошу под кат. Там я описываю один из рекомендуемых методов настройки, а именно через Google Tag Manager Server Side.
FB CAPITag
Для настройки Facebook Conversion API с помощью Google Tag Manager сервер контейнера нужно сначала настроить работу Universal Analytics или GA4 через GTM SS. Все события которые вы хотите отслеживать в Facebook должны быть настроены в UA/GA4 так как вся информация для отправки запроса в FB CAPI будет формироваться на основе событий отправленных в Google Analytics.
В этой статье я не буду рассказывать, как создать и настроить веб контейнер GTM или отслеживание событий с помощью FB web pixel так как предполагается что вы уже хорошо знакомы с настройкой GTM контейнеров.
Что касается изначальной настройки GTM SS это зависит от того какой сервис вы будете использовать для предоставления серверов для вашего серверного контейнера. У каждого есть свои плюсы и минусы. Вы можете выбрать любой подходящий вам это никак не повлияет на работу FB CAPI.
У каждого провайдера серверов для GTM SS есть своя инструкция по настройке контейнера, по этому будем предполагать что вы воспользовались ею и у вас уже есть работающий GTM SS контейнер и ссылка на него.
В текущих реалиях что использовать UA или GA4 для FB CAPI не имеет значения. FB рекомендует GA4 так как он позволяет более легко передавать дополнительные параметры, но с моего опыта нет никаких проблем в передаче дополнительных данных с помощью UA custom dimensions. Так что если у вас не настроен GA4 ничего страшного.
И так после того как разобрались со всеми зависимостями наконец приступим к настройке.
1) Прежде всего, вам необходимо настроить UA или GA4 в GTM Web для отправки событий в GTM SS. Для этого вам нужно установить transport_url параметр указав в качестве значения ссылку на ваш GTM SS сервер.
GA4 tag
UA tag
2) Теперь нужно настроить GA на сервер контейнере GTM. Для GA4 создайте тег GA4 a для UA тег Universal Analytics. Также нужно создать триггер в соответствии с вашим типом тега. Тип триггера “Custom”, выберите «Some events». Имя клиента равно Universal Analytics или GA4 в зависимости от выбранного вами типа тега.
UA Server Side Tag
UA Trigger
Server Side Tag Import
Server Side Template
5) По такому же принципу вы можете настроить все остальные события которые вас интересуют.
Таким образом у вас будет готова базовая настройка FB CAPI.
Если вы хотите оставить FB Web Pixel вам нужно будет настроить дедупликацию событий. Так как получится что у вас FB web pixel и FB CAPI шлют те же события.
Чтобы настроить дедупликацию FB Conversion API, вам необходимо отправлять уникальный идентификатор события из браузера и с сервера. Одни и те же события из браузера и сервера должны иметь один и тот же идентификатор события. Больше информации про дедупликацию можно найти в документации.
В галерее шаблонов GTM есть Unique Event ID переменная которая создает уникальный ID для каждого события. Используйте эту переменную в FB Web Pixel для отправки event_id а также передавайте ее на сервер с помощью UA custom dimension или GA4 параметра и используйте в FB CAPI теге для отправки того же event_id.
Настройка FB CAPI требует терпения) Так что желаю всем удачи в этом нелегком деле и надеюсь этот пост поможет вам в этом.
Using the API
Before implementing the conversions API, make sure you have all the prerequisites listed on the main conversions API document. On this page, you learn to:
The conversions API is based on Facebook’s Marketing API, which was built on top of our Graph API. Marketing and Graph APIs have different version deprecation schedules. Our release cycle is aligned with the Graph API, so every version is supported for at least two years. This exception is only valid for conversions API.
Send requests
To send new events, make a POST request to this API’s /events edge from this path: https://graph.facebook.com/
Attach your generated secure access token using the access_token query parameter to the request. You can also use Graph API Explorer to POST to the /
An example request body looks like this:
Video Walkthrough
See this video for help completing your first API call. For prework information see Create a Business Manager and Create a Facebook Pixel in Business Manager.
Swagger
You can use open source code-generator Swagger to generate client side API code for our conversions API. The generated code handles the API calls, exception handling, and retries.
To use Swagger, you need Java (version 7 or higher). Learn more about our Swagger API integration.
Dropped Events
Network errors or malformed requests may cause events to be dropped. We recommend retrying the request in cases where the response indicates a non-client error, such as a timeout. To account for various network delays, we recommend setting a timeout of 1500 milliseconds on the request. For the majority of requests, the response time will be under 600 milliseconds.
Upload Time versus Event Transaction Time
event_time is the event transaction time. It should be sent as a Unix timestamp in seconds indicating when the actual event occurred. The specified time may be earlier than the time you send the event to Facebook. This is to enable batch processing and server performance optimization.
event_time can be up to 7 days before you send an event to Facebook. If any event_time in data is greater than 7 days in the past, we return an error for the entire request and process no events.
Batch Requests
Hashing
Please check our customer information parameters page to see which parameters should be hashed before they are sent to Facebook. If you are using one of our Business SDKs, the hashing is done for you by the SDK.
Business SDK Features for Conversions API
Learn more about three specific Business SDK features designed especially for Conversions API users: Asynchronous Requests, Concurrent Batching, and HTTP Service Interface. Minimum language version required to use these features:
Business SDK support for PHP 5 has been deprecated since January 2019. Please upgrade to PHP 7 to use the Business SDK.
If you must use PHP 5, consider using our Swagger implementation.
Verify Events
After you send your events, confirm that we have received them in Events Manager:
Test Events Tool
The Test Events tool generates a test ID. Send the test ID as a test_event_code parameter to start seeing event activity appear in the Test Events window.
Events sent with test_event_code are not dropped. They flow into Events Manager and are used for targeting and ads measurement purposes.
Here’s an example of how the request should be structured:
Here’s an example of how the request appears in Graph API Explorer:
Your server events appear in the Test Events window once the request is sent.
Data Processing Options For Conversions API and Offline Conversions API
Чтобы явным образом не включать режим ограниченного использования данных (LDU), укажите пустой массив для каждого события: Вот как можно включить LDU и указать местоположение пользователей: Вот как можно включить LDU с геолокацией (для серверного API необходимо указать IP-адрес клиента):
Пользовательский интерфейс для загрузки вручную
Инструмент автоматической загрузки офлайн-конверсий
API Limits
The Marketing API has its own rate-limiting logic and is excluded from all the Graph API rate limitations. So if you make a Marketing API call, it won’t be calculated into the Graph API throttling.
There is no specific rate limit for conversions API. Conversions API calls are counted as Marketing API calls. The only limitation is that you can send us up to 1,000 events at a time. See Send Requests for more information.
Как настроить Facebook API конверсии и что о них нужно знать маркетологам
Интересно, как iOS 14 и другие блокировщики рекламы могут повлиять на ваш маркетинг в Facebook? Знаете, чем могут помочь Facebook API конверсии?
В этой статье мы разберем, как настроить Facebook API конверсии для оценки маркетинговой деятельности в Facebook и Instagram.
Регистрируйтесь на марафон, если вам интересна тема рекламы в соцсетях. Обучитесь маркетингу и начните зарабатывать от 50 000 рублей в месяц.
Что такое Facebook API конверсии
Владельцы устройств под управлением iOS 14 уже могли заметить уведомления об обновлениях Facebook, которые повлияют на рекламу. Вот в чем их суть.
iOS 14 значительно усложнит отслеживание поведения пользователей приложениями и сайтами. Apple ограничивает отслеживание событий, независимо от настроек пользователя.
Пока неизвестно, когда изменения вступят в силу, но это будет в ближайшие месяцы. Маркетологам очень важно уже сейчас решить эту ситуацию.
Когда изменения начнут действовать, отправка данных о событиях конверсии в приложениях и на сайтах на устройствах Apple может быть заблокирована. Мы не сможем отслеживать лиды, покупки и другие важные события, которые обычно отслеживаются в Ads Manager.
Учитывая, сколько трафика поступает с мобильных устройств, в том числе именно с устройств Apple, эти изменения могут серьезно ограничить возможности и результаты рекламы.
И если вы думаете, что это коснется только устройств под управлением iOS 14, то это не так. Новые законы о конфиденциальности, такие как GDPR и Калифорнийский Закон о правах на частную жизнь, уже достаточно ограничивают способность Facebook отслеживать события.
Таким образом, грядут перемены, и обновление iOS 14 их ускорило.
Но решение есть! Оно называется API конверсии.
API конверсии – это новое название, но не новый способ отслеживания, даже для Facebook. Ранее он назывался «Серверные события». С помощью API конверсий сервер веб-сайта (в отличие от браузера) отслеживает действия пользователя во время посещения сайта. Сервер отмечает все действия (добавление в корзину, покупка и т.д.), после чего отправляет информацию Facebook.
Кристофер Пенн из Trust Insights объясняет:
«Причина для использования API конверсий в том, что отслеживание со стороны браузера более надежно. Если я пользуюсь iPhone и нахожусь в Safari, из-за конфиденциальности Apple передается намного меньше данных. Если я нахожусь в Chrome и у меня есть AdBlock, включенный на максимум, ваш пиксель Facebook вообще не будет срабатывать. У вас будут конверсии, но Facebook не сможет их отследить. Поэтому API конверсии становятся все более актуальными».
Как API конверсии меняют ситуацию
В настоящее время у большинства людей пиксель Facebook установлен непосредственно на сайте или через Google Tag Manager. Когда пользователь загружает ваш сайт, пиксель срабатывает на уровне браузера. Каждое действие, которое выполняет пользователь на любой странице сайта, отслеживается и отправляется обратно в Facebook. Далее Facebook предоставляет эти данные в Ads Manager в удобном вам форме.
В случае с API конверсиями, Facebook отправляет уникальный идентификатор пользователя на сервер при каждом клике на объявление и переходе на ваш сайт. С помощью этого идентификатора сервер будет отслеживать действия пользователя на каждой странице. Затем сервер отправит данные обратно в Facebook.
По крайней мере, в настоящее время будут работать оба способа отслеживания событий – через браузер и сервер. Когда Facebook получает данные сервера, он проверит, есть ли аналогичные данные от браузера. Если событие браузера заблокировано, например, из-за блокировки Apple, Facebook использует вместо него событие сервера. Если у Facebook есть оба события, он сравнит их и использует только событие браузера. Возле дубликата события от сервера в этом случае появится отметка «Deduplicate».
Произошли обновления также в работе событий преобразования. Facebook перестал использовать 28-дневное окно атрибуции и теперь использует только 7-дневные окна для событий клика и 1-дневное для просмотра. Это значит, что вы можете увидеть снижение количества конверсий по сравнению с тем, что было раньше.
Facebook также переключается на агрегированные события. Это протокол, который позволит вам измерять события конверсии даже с ограничениями iOS 14. Однако вы будете ограничены восьмью событиями, все события будут отличаться приоритетом, и Facebook будет записывать только самое приоритетное событие для каждой транзакции. Поэтому, если вы инициировали оформление заказа, добавление в корзину и событие покупки, будет записано только то действие, которое вы определили приоритетным.
Преимущества использования API конверсий
Да, использование API конверсий имеет свои преимущества. Как было объяснено выше, они позволяют отслеживать эффективность вашей рекламы, даже если пользователь использует устройство Apple или установил ПО для блокировки рекламы в браузере.
Кевин Гринберг из Active Frequency указывает еще на одно преимущество:
«Могут произойти такие события, о которых будет знать только ваш сервер. Страница не учитывает события, которые происходят в фоновом режиме. Когда пользователь заказывает продукт, события считывается, как продажа только после отправки заказа. Если клиент возвращает товар – это событие происходит на сервере, а не на странице. Сервер может более точно отслеживать события, чем браузер».
Как настроить API конверсии для событий сайта
Способ настройки API конверсий для сайта и приложений отличаются. Я приведу план настройки именно для сайта.
В Ads Manager добавлена новая вкладка «Resource Centre». В ней приводятся статьи о предстоящих изменениях и API конверсий. Она также содержит информацию, специфичную для вашего рекламного аккаунта. Вы можете узнать, пропустили ли какие-либо шаги в процессе настройки API.
1. Проверка домена
Если вы запускаете рекламу, оптимизированную для событий сайта, нужно подтвердить, что ваш домен верифицирован.
Для этого перейдите в раздел «Домены». В Business Manager выберите пункт меню «Настройки компании». Далее в левой колонке разверните вкладку «Безопасность бренда» и зайдите в меню «Домены».
Перейти к доменам можно также сразу в уведомлении от Resource Centre. Нажмите «Проверить домен».
Если у вас есть проверенный домен, он отобразится в окне. Можете перейти к шагу 2.
Если домен настроен не до конца, он отобразится с красной точкой. При этом, если его нет совсем, окно будет пустым.
Нажмите кнопку «Добавить», а затем введите свое доменное имя.
Если домен не появляется в главном окне после нажатия кнопки «Добавить домен», обновите страницу.
Теперь выберите предпочтительный способ проверки вашего домена. Есть три варианта: проверка DNS, загрузка HTML-файлов и проверка мета-тегов.
Следуйте инструкциям, чтобы завершить проверку домена. Когда ваш домен будет успешно проверен, вы увидите его в списке с зеленой точкой.
2. Настройка API конверсий для WordPress
Способ настройки API конверсий зависит от того, на какой платформе находится ваш сайт. Большинство платформ электронной коммерции внедрили интеграцию для API конверсий Facebook. Некоторые, например, WooCommerce, установили партнерские интеграции с Facebook. Другие, такие как Shopify, имеют свою собственную процедуру настройки.
Если платформы вашего сайта нет в списке, поищите в Google, есть ли у него встроенная интеграция. Если это не партнер и не имеет собственной интеграции, то Zapier может быть вашим лучшим выбором.
Итак, мы рассмотрим процесс настройки API конверсий для сайта на WordPress.
Здесь есть два способа:
Плагин PixelYourSite – это более удобный способ, поэтому мы начнем с него. Есть и другие плагины для отслеживания на WordPress и они тоже имеют интеграцию с API конверсий. Если вы используете другой плагин, проверьте, поддерживает ли он конфигурацию API.
Настройка API конверсий для WordPress с помощью PixelYourSite
Чтобы настроить API конверсии с помощью PixelYourSite, нужно установить и активировать сам плагин. В панели управления WordPress выберите «Плагины» и нажмите «Добавить новый».
Найдите PixelYourSite в строке поиска. Нажмите кнопку «Установить сейчас», а после завершения загрузки «Активировать».
Когда плагин будет активирован, он появится в левом меню WordPress. Выберите плагин и перейдите в панель мониторинга.
Далее зайдите в Facebook Events Manager, откройте настройки, прокрутите вниз до раздела API конверсий и нажмите «Создать маркер доступа».
Следуйте инструкции и через пару шагов вы увидите маркер доступа. Скопируйте его.
Вставьте маркер доступа в поле «Маркер API» в панели мониторинга PixelYourSite и установите галочку «Отправлять события непосредственно с веб-сервера на Facebook через API Конверсий».
Теперь вам нужно проверить настройки. Вернитесь в Facebook Events Manager и перейдите на вкладку «Тестирование событий». Скопируйте код в разделе «Тестирование событий сервера».
Затем вернитесь на панель мониторинга PixelYourSite и вставьте код в поле «test_event_code». Сохраните настройки.
Чтобы запустить тест, откройте страницу вашего сайта в другой вкладке.
Если настройки выполнены верно, то на вкладке «Тестирование событий» в Events Manager вы увидите считанные на сайте события и «Receiving activity» с зеленой точкой.
Если сработало только событие сервера, вы увидите только обработанное событие сервера.
Если тест сработал правильно, вернитесь на панель мониторинга PixelYourSite и удалите тестовый код. Когда вы закончите, нажмите кнопку «Сохранить настройки».
Теперь, когда вы успешно настроили Facebook API конверсий, можно перейти к шагу 3.
Настройка API конверсий для WordPress с помощью партнерской интеграции
Чтобы настроить API конверсии с помощью партнерской интеграции WordPress, зайдите в «Настройки» Events Manager. Прокрутите вниз до кнопки «Выбрать партнера».
Следуйте подробной инструкции Facebook.
Когда настройка завершена и если все шаги выполнены верно, после тестового отслеживания событий на вкладке «Обзор» в Events Manager вы увидите события с зеленой точкой «Активные».
3. Добавление событий для отслеживания
Если ваши события уже настроены, вы можете перейти к следующему шагу. Но если требуется настроить события, зайдите в «Настройки» Events Manager, найдите пункт «Настройка событий» и нажмите кнопку «Открыть инструмент настройки событий».
Затем вы можете добавить разные события, которые хотите отслеживать на сайте.
4. Настройка агрегированного измерения событий
Агрегированное измерение событий довольно просто настроить. Facebook позволяет настроить события, которые уже были запущены на вашем сайте.
Зайдите в Events Manager на вкладку «Обзор» и выберите «Агрегированное измерение событий». Затем нажмите кнопку «Настроить веб-события».
В открывшемся окне вы увидите все проверенные домены. Нажмите на домен, для которого хотите настроить событие и выберите «Изменить события».
События, которые Facebook отследил в прошлом, будут перечислены от самого приоритетного к менее приоритетному.
Вы можете перетаскивать события, чтобы изменить их порядок с учетом вашей воронки. Для события покупки есть возможность включить оптимизацию стоимости.
Присоединяйтесь к бесплатному марафону, если хотите окунуться в тему настройки рекламы в Facebook и Instagram.
Выводы
Facebook API конверсии немного отличаются от обычной настройки пикселя. Воспользуйтесь этой инструкцией для настройки API конверсий для сайта.
API конверсии позволят вам отслеживать события сайта, несмотря на обновления iOS 14 и используемые пользователями сервисы блокировки рекламы. Важно настроить Facebook API конверсии уже сейчас, чтобы не потерять данные о конверсиях, когда обновления iOS 14 вступят в силу.
Если статья была для вас полезна делитесь ей в соцсетях.
Реклама в Facebook, и снова о ней! На сей раз вы узнаете как работать с аудиторией, которая интересуется или посещает мероприятия (online или offline). Кажется, это никогда не закончится. Facebook постоянно радует потоком обновлений рекламодателей, которые ищут своего идеального покупателя. Последнее обновление — это возможность настроить рекламу исходя из данных…
Реклама Facebook – отличный инструмент, помогающий донести ваше сообщение или предложение до 2,5 млрд пользователей платформы в месяц. С такой огромной аудиторией сразу понятно, почему платформа так популярна для маркетологов. Для 7 млн маркетологов, если быть точным. Но первое, с чем вы столкнетесь при настройке кампаний в Facebook – это…
Мероприятие на Фейсбук — отличный способ пропиарить свой проект, себя или бренд. А что это значит? Это значит, что нужно это самое мероприятие проводить. Онлайн или офлайн — решать вам. В любом случае, это инвестирование времени, денег и усилий. Но результат того стоит! Благодаря мероприятиям на Фейсбук вы можете дать…
Ключевой элемент успешного маркетинга в Facebook – отслеживание эффективности, в том числе рекламы. Каждый маркетолог следит за показателями ежедневно или еженедельно. Говоря об этом, нельзя не затронуть такую тему, как аудит рекламы в Faceboоk. Аудит рекламы необходим для оценки общей эффективности кампаний. Ниже мы разберем, что включает в себя аудит…