Skip to main content
Рекламные сети упорядочивают данные вашего платного привлечения в PNLight. Используйте их, чтобы группировать кампании по сети и учётной записи, нормализовать названия атрибуции и настроить доставку для платного трафика.

​
Структура рекламных сетей

PNLight использует три уровня настройки платного привлечения:
  • Сеть: провайдер, например Facebook или пользовательский источник трафика.
  • Учетная запись: настройка Facebook для синхронизации кампаний, доставки событий через Conversions API или обоих вариантов; либо пользовательская учетная запись внутри сети.
  • Кампания: синхронизированная или созданная вручную кампания выбранной сети или учетной записи.
Эта структура согласует атрибуцию, postback-запросы и отчетность в панели управления.

​
Перед началом

Для подключения Facebook подготовьте доступ в Meta перед добавлением учетной записи в PNLight.
  • Нужны права администратора бизнес-портфолио Meta, которому принадлежат подключаемые ресурсы.
  • Доступ к рекламной учетной записи и Facebook Ad Account ID нужны только если PNLight должен импортировать кампании и расходы через Marketing API.
  • Нужен Target URL. Обычно это URL магазина приложения, но может быть лендинг, другой трекер или любой другой допустимый HTTPS-адрес. Если в проекте указан App Store ID, PNLight заранее подставляет URL страницы приложения в App Store для новых учетных записей.
  • Нужны dataset или pixel Meta и токен Conversions API, если PNLight должен отправлять события через Meta Conversions API.
Для доставки событий AppsFlyer S2S подготовьте:
  • Production AppsFlyer iOS App ID в формате id1234567890.
  • AppsFlyer S2S Security Token из раздела Security Center > Tokens.
  • Список событий жизненного цикла подписки PNLight, которые нужно отправлять, и названия событий AppsFlyer для них.
Можно создать учетную запись Facebook только с Conversions API без Facebook Ad Account ID. Добавьте Facebook Ad Account ID и токен Marketing API позже, если понадобится синхронизация кампаний через Marketing API. Data Source ID и токен Conversions API используются только при включенной доставке событий через Conversions API.

​
Подключение учетной записи Facebook

1

Откройте Networks

Выберите проект и откройте Networks.
2

Подключите Facebook

Нажмите Connect Facebook.
3

Выберите режим подключения

Выберите Marketing API, чтобы импортировать кампании и расходы, Conversions API, чтобы отправлять сопоставленные события в Meta, или Both. Другую возможность можно добавить позже в настройках учетной записи. Выбор направляет настройку; активные возможности PNLight определяет по сохраненным учетным данным.
4

Назовите учетную запись

Добавьте Account name, чтобы команда могла узнать эту настройку позже.
5

Укажите настройки клика

Добавьте Target URL. Если в проекте указан App Store ID, PNLight заранее подставляет его. PNLight открывает Target URL после того, как зарегистрирует рекламный клик. Чаще всего это URL App Store, но можно указать и другой допустимый HTTPS-адрес.
6

Введите параметры Marketing API

Добавьте Facebook Ad Account ID и Facebook Access Token (Marketing API), если PNLight должен импортировать кампании и расходы из Meta.
7

Введите параметры Conversions API

Добавьте Data Source ID и Conversions API Token, если PNLight должен отправлять сопоставленные события в Meta.
8

Сопоставьте события и скопируйте URL клика

При включении Conversions API проверьте, какие события PNLight сопоставляются со стандартными событиями Meta, затем скопируйте сгенерированный шаблон URL клика в объявления. PNLight нужен отслеживаемый клик, чтобы атрибутировать событие учетной записи и кампании перед отправкой в Meta.
9

Создайте учетную запись

Сохраните учетную запись. PNLight проверит введенные учетные данные и создаст отслеживаемый URL клика. Если указаны учетные данные Marketing API, PNLight также импортирует кампании и расходы.
Кампании могут использовать Target URL учетной записи или задать собственный Target URL кампании, если одной кампании нужен другой адрес. В форме кампании это поле называется Redirect URL override.

​
Получение учетных данных Facebook

Нужные учетные данные зависят от того, что должна делать учетная запись. Для каждой учетной записи Facebook также нужен Target URL. Используйте Both, если одна настройка Facebook должна и импортировать данные кампаний, и отправлять события конверсий.

​
Получение ID рекламной учетной записи

Это значение нужно для синхронизации кампаний через Marketing API. Для учетной записи только с Conversions API оно необязательно.
1

Откройте Meta Ads Manager

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

Скопируйте ID

Скопируйте числовой ID из селектора или настроек учетной записи.
3

Сохраните формат

Можно вставить ID как act_123456789 или 123456789.

​
Получение токена Marketing API

Создайте для PNLight токен системного пользователя. Не используйте краткосрочный токен Graph API Explorer.
1

Откройте бизнес-портфолио

Откройте Meta Business Settings и выберите портфолио, которому принадлежит рекламная учетная запись.
2

Создайте системного пользователя для PNLight

Откройте Users > System users, нажмите Add и задайте имя PNLight или другое понятное служебное имя.
3

Предоставьте доступ к рекламной учетной записи

Выберите системного пользователя, нажмите Add assets, выберите Ad accounts и учетную запись, которую добавите в PNLight. Разрешите чтение кампаний, групп объявлений, объявлений и статистики.
4

Выберите приложение Meta

Нажмите Generate new token и выберите приложение Meta из того же портфолио. Если приложения еще нет, создайте его в Meta for Developers и подключите к этому портфолио.
5

Выберите разрешения Marketing API

Выберите ads_management, а также ads_read, если Meta показывает его для приложения.
6

Скопируйте токен

Создайте токен, сразу скопируйте его и вставьте в Facebook Access Token (Marketing API) в PNLight.
Справка Meta: авторизация Marketing API.

​
Получение Data Source ID и токена Conversions API

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

Откройте Events Manager

Откройте dataset или pixel, который должен получать события PNLight.
2

Скопируйте Data Source ID

Скопируйте ID pixel или dataset из данных источника. В PNLight это поле называется Data Source ID.
3

Создайте токен доступа

В настройках Conversions API источника создайте токен доступа.
4

Скопируйте значения

Вставьте ID в Data Source ID, а токен — в Conversions API Token в PNLight.
Справка Meta: начало работы с Conversions API.

​
Сопоставление событий

PNLight отправляет события Conversions API только когда событие PNLight сопоставлено со стандартным событием Meta. Для новых учетных записей Facebook с Conversions API PNLight задает такие сопоставления: Проверьте эти сопоставления перед продолжением. Можно добавлять и удалять сопоставления или менять событие Meta для каждого события PNLight. Позже их можно изменить в настройках учетной записи или переопределить для кампании, если одной кампании нужна другая доставка событий.

​
URL клика

Когда вы включаете Conversions API, PNLight выдает отслеживаемый URL клика для учетной записи Facebook.
Используйте этот URL как URL назначения в объявлениях Meta. PNLight регистрирует клик, сохраняет значения кампании Meta и перенаправляет пользователя на Target URL учетной записи или кампании. Без отслеживаемого клика PNLight не сможет атрибутировать последующее событие учетной записи и кампании и пропустит доставку через Conversions API.
В сценарии только с Conversions API отслеживаемый URL клика позволяет PNLight связать последующие события с кликнутой кампанией Meta даже без импорта кампаний через Marketing API.

​
Подключение событий AppsFlyer S2S

Используйте AppsFlyer S2S, если PNLight должен отправлять выбранные события жизненного цикла подписки в AppsFlyer для пользователей с атрибуцией AppsFlyer.
1

Откройте Integration

Выберите проект, откройте Integration и нажмите Configure в блоке AppsFlyer S2S events.
2

Введите учетные данные AppsFlyer

Добавьте AppsFlyer App ID и S2S Security Token. PNLight хранит токен безопасно и не показывает его повторно после сохранения.
3

Сопоставьте события жизненного цикла

Добавьте строку для каждого события жизненного цикла подписки PNLight, которое нужно отправлять. Выберите Platform event и укажите название AppsFlyer event, которое должно появиться в AppsFlyer.
4

Включите подключение

Оставьте Enabled включенным, когда учетные данные и сопоставления готовы. Выключите его, чтобы приостановить доставку без удаления настроек.
PNLight начинает с типовых сопоставлений, например trial_started, trial_converted, subscription_started, subscription_renewed и subscription_refunded. Перед сохранением их можно добавить, переименовать или удалить.
Для доставки AppsFlyer S2S приложение должно отправлять атрибуцию AppsFlyer вместе с AppsFlyer user ID (AppsFlyer UID) через SDK. События могут отображаться как Waiting for attribution, пока PNLight не получит этот идентификатор.

​
Добавление пользовательской сети или учетной записи

Используйте этот вариант, если источник трафика не подключен через синхронизацию Facebook.
1

Создайте сеть

В Networks нажмите Add network и укажите название и ключ.
2

Добавьте псевдонимы

Укажите названия провайдера или нормализованные метки, которые PNLight должен считать одной сетью.
3

Добавьте учетную запись

Откройте строку сети и нажмите Add account.
4

Введите данные

Добавьте Account name, необязательный External account ID и Target URL. Если в проекте указан App Store ID, PNLight заранее подставляет Target URL.

​
Настройка сети

Откройте сеть в таблице, когда нужно управлять общими настройками доставки. На странице сети можно:
  • Переименовать сеть.
  • Изменить псевдонимы сети атрибуции.
  • Задать postback-запросы системных событий по умолчанию.
  • Задать postback-запросы событий приложения по умолчанию.
  • Сопоставить встроенные события PNLight со стандартными событиями Facebook при использовании Facebook Conversions API.
Сопоставление событий Facebook применяется к встроенным событиям PNLight, например install, trial_started и subscription_started. Для пользовательских событий SDK, отправленных через logEvent, используйте postback-запросы событий приложения.

​
Настройка учетной записи

Откройте учетную запись, когда нужны настройки клика и доставки для этой учетной записи. На странице учетной записи можно:
  • Переименовать учетную запись.
  • Задать или изменить Target URL учетной записи (Default redirect URL для пользовательских учетных записей). Кампании используют его, если у них нет собственного Target URL.
  • Скопировать URL for your Ad для назначения кампаний Facebook.
  • Добавить или изменить Facebook Ad Account ID перед включением Marketing API.
  • Обновить токен доступа Marketing API.
  • Обновить Data Source ID и токен Conversions API.
  • Включить или выключить Send events to Facebook Conversions API.
  • Просмотреть Conversions API delivery по доставленным, неудачным и пропущенным событиям за последние 48 часов.

​
Проверка состояния синхронизации

В таблице Networks рядом с учетной записью появляется значок предупреждения, если последняя синхронизация кампаний или расходов завершилась с ошибкой. Наведите курсор на значок, чтобы прочитать текст последней ошибки синхронизации. Используйте предупреждение, чтобы решить, нужно ли обновить токен Marketing API, проверить права Meta или убедиться, что рекламная учетная запись по-прежнему доступна. Для учетных записей Facebook скопируйте сгенерированный URL for your Ad без изменений. Используйте его как URL назначения в Meta. URL содержит макросы Meta для кампании, группы объявлений, объявления, placement и site source. PNLight сохраняет этот контекст клика для отчетности и postback-запросов.

​
После настройки

  • Откройте «Кампании» и синхронизируйте или проверьте кампании учетной записи. Кампания может задать собственный Target URL; в форме кампании это поле называется Redirect URL override. Если оно пустое, PNLight использует Target URL учетной записи.
  • Используйте фильтры рекламной сети и кампании в Analytics, Customers и Events.
  • Обновляйте псевдонимы атрибуции, когда провайдер присылает новую метку сети.
  • Включайте Conversions API только после подготовки учетных данных Data Source и сопоставления событий. В настройках учетной записи отображаются результаты доставки Conversions API за последние 48 часов; отдельные попытки смотрите в Events.
  • Откройте Events или профиль клиента, чтобы проверить статус доставки AppsFlyer S2S для сопоставленных событий.
После подключения учетной записи проверяйте включенные кампании, расходы, postback-запросы и метрики в Campaigns.