Conversions API

Начало работы

На этой странице описывается процесс внедрения API Conversions и приводится подробная информация о предварительных требованиях для этого внедрения. Если вы являетесь сторонним партнером, предлагающим функциональные возможности API Conversions клиентам-рекламодателям, существуют другие требования, с которыми следует ознакомиться перед началом работы.

Если в вашей компании исходящие запросы проходят через брандмауэр, получите IP-адреса Facebook, как описано в разделе IP-адреса краулера и программные агенты. Учтите, что список адресов часто меняется.

Для событий с сайта, из приложения или физического магазина, отправленных через API Conversions, требуются определенные параметры. Их список можно посмотреть в этой статье.

Обзор процесса

Основные этапы процесса настройки интеграции API Conversions:

  1. Выбор подходящего для вас способа интеграции.
  2. Выполнение необходимых предварительных требований для этого способа внедрения.
  3. Внедрение с использованием этого способа интеграции.
  4. Проверка настройки и соблюдение рекомендаций, помогающих повысить эффективность рекламы.

Способы интеграции

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

В этой документации для разработчиков основное внимание уделено обеспечению прямой интеграции.

Требования

ID пикселя

Для использования API Conversions вам необходимо получить ID пикселя. Если вы уже настроили пиксель для своего веб-сайта, для событий на сайте и серверных событий рекомендуем использовать один и тот же ID пикселя.

Business Manager

Для использования API также требуется Business Manager. С помощью Business Manager рекламодатели могут интегрировать рекламу на Facebook со своими внутренними системами и внешними партнерами. Если у вас ещё нет аккаунта Business Manager, создайте его, как описано в этой статье Справочного центра.

Маркер доступа

Для использования API Conversions нужен маркер доступа. Получить маркер доступа можно двумя способами:

  • Через Events Manager (рекомендуемый вариант)
  • Через собственное приложение

Через Events Manager (рекомендуемый вариант)

Для использования API Conversions необходимо сгенерировать маркер доступа, который передается в качестве параметра в каждом вызове API. Выполните в Events Manager следующие действия:

Шаг 1. Выберите пиксель, который необходимо внедрить.

Шаг 2. Откройте вкладку "Настройки".


Шаг 3. Найдите раздел Conversions API и щелкните ссылку Сгенерировать маркер доступа в разделе настройки вручную, после чего следуйте инструкциям во всплывающем окне.

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


Получив маркер доступа, нажмите кнопку Управление интеграциями на вкладке "Обзор" в Events Manager. Во всплывающем окне нажмите кнопку Управление рядом с API Conversions. В результате мы автоматически создадим для вас приложение API Conversions и системного пользователя API Conversions. Проходить проверку приложения и запрашивать какие-либо разрешения при этом не требуется.



Использование собственного приложения

Если у вас уже есть собственное приложение и собственный системный пользователь, вы можете сгенерировать маркер в Business Manager. Для этого выполните следующие действия:

Шаг 1. Откройте настройки своей компании.

Шаг 2. Назначьте пиксель системному пользователю (на этом этапе вы также можете создать нового системного пользователя).

Шаг 3. Выберите назначенного системного пользователя и нажмите Сгенерировать маркер.

Для вашего приложения проверка не требуется. Вам также не нужно запрашивать какие-либо разрешения.

Теперь для маркеров доступа, созданных на вкладке настроек API Conversions в Events Manager, можно использовать различные версии API Graph. Ранее было возможно использовать только самую новую на момент создания маркера версию. Начиная с версии 12.0 для новых маркеров доступа можно использовать все доступные версии API Graph.

Ресурсы