> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pnlight.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Кампании

> Просматривайте кампании привлечения пользователей в PNLight: рекламные расходы, стоимость установок, postback-запросы, доход, конверсии и когортную аналитику.

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

## Работа со страницей кампаний

<Steps>
  <Step title="Откройте Campaigns">Выберите проект и откройте **Campaigns**.</Step>
  <Step title="Проверьте синхронизированные кампании">Проверьте названия, сеть или учетную запись и статус включения.</Step>
  <Step title="Обновите расходы">Введите или проверьте расходы, если данные требуют исправления.</Step>
  <Step title="Настройте postback-запросы">Задайте их поведение для кампаний, которым нужна доставка событий.</Step>
  <Step title="Используйте фильтры кампаний">Фильтруйте аналитику и клиентов для анализа отдельных каналов.</Step>
</Steps>

## Кампании, созданные вручную

Они позволяют отслеживать трафик рекламных сетей, партнеров, рассылок, инфлюенсеров и других источников, поддерживающих URL кампании. PNLight регистрирует клик, перенаправляет пользователя, атрибутирует его после передачи клика приложением и отправляет postback-запросы для подходящих событий.

| Область          | Кампания, созданная вручную                                     | Синхронизированная кампания Facebook                                                                                |
| ---------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Создание         | Вы создаете кампанию в PNLight.                                 | PNLight синхронизирует ее из Facebook.                                                                              |
| Расходы          | Вы вводите их вручную или импортируете CSV.                     | PNLight может синхронизировать их из Facebook.                                                                      |
| Postback         | Вы настраиваете URL для системных событий и событий приложения. | Кампания может наследовать настройки и сопоставление событий Facebook из учетной записи сети или переопределять их. |
| URL отслеживания | PNLight создает URL кампании с `pnlAdsCampaignId`.              | PNLight создает URL учетной записи с макросами Facebook.                                                            |

Настройка Facebook описана в разделе [«Рекламные сети»](/ru/dashboard/ad-networks).

## Создание кампании вручную

<Steps>
  <Step title="Откройте Campaigns">Выберите проект и откройте **Campaigns**.</Step>
  <Step title="Создайте кампанию">Нажмите **New Campaign**.</Step>
  <Step title="Укажите данные">Добавьте **Campaign Name**, а при наличии планового периода — **Start date** и **End date**.</Step>
  <Step title="Сохраните кампанию">Нажмите **Create**.</Step>
  <Step title="Откройте настройки">Откройте кампанию из таблицы.</Step>
  <Step title="Задайте URL перенаправления">Введите **Redirect URL override**. PNLight направит на него зарегистрированный клик.</Step>
  <Step title="Скопируйте URL кампании">Используйте **URL for your Ad** как URL назначения в рекламной сети или партнерской системе.</Step>
</Steps>

<Warning>До запуска трафика у кампании должен быть **Redirect URL override**. Без него PNLight не сможет перенаправить клик.</Warning>

<Tip>Для бессрочной кампании можно не заполнять **Start date** или **End date**. Укажите только дату начала для уже запущенной кампании или только дату окончания, если известна лишь она.</Tip>

## Настройка рекламного URL

URL содержит `pnlAdsCampaignId`, по которому PNLight связывает клики, установки, события, расходы, postback-запросы и аналитику с кампанией.

Добавьте параметры, которые предоставляет источник трафика. PNLight сохранит их с кликом и передаст в URL перенаправления.

```text theme={null}
https://pnlight.example/api/v1/ads/click?pnlAdsCampaignId=CAMPAIGN_ID&sub_id={click_id}&partner=network_a&placement={placement}
```

Используйте стабильные названия параметров, например `sub_id`, `click_id`, `partner`, `creative`, `placement` или `utm_campaign`.

При перенаправлении PNLight сохраняет параметры URL и добавляет `deep_link_value` с ID клика PNLight. Приложение или обработчик deep link может использовать его, чтобы связать установку с кликом.

<Tip>Если источник уже добавляет параметры отслеживания, сохраните их в **URL for your Ad**. Они станут доступны для подстановки в URL postback-запроса.</Tip>

## Настройка postback-запросов

Они отправляют уведомления о событиях из PNLight в рекламную сеть, партнерскую платформу или внутренний endpoint. PNLight отправляет их только для пользователей, атрибутированных кампании.

| Раздел                      | Назначение                                                   |
| --------------------------- | ------------------------------------------------------------ |
| **System Events Postbacks** | Встроенные события PNLight: установка, покупка или возврат.  |
| **App Events Postbacks**    | Пользовательские события SDK, отправленные через `logEvent`. |

Для каждого запроса укажите:

| Поле             | Описание                                                                                               |
| ---------------- | ------------------------------------------------------------------------------------------------------ |
| **Event name**   | Событие PNLight, запускающее запрос. Для событий приложения используйте точное название из SDK.        |
| **Postback Url** | Полный URL endpoint, который PNLight вызывает при регистрации события атрибутированного пользователя.  |
| **Single Use**   | Отправляет событие приложения только один раз для сочетания пользователя, кампании и названия события. |

### Подстановка параметров

Используйте переменные в значениях query-параметров, если принимающей системе нужны данные исходного клика.

```text theme={null}
https://network.example/postback?click_id={{sub_id}}&event=purchase&pnl_click_id={{pnlClickId}}
```

| Переменная                                       | Значение                                                      |
| ------------------------------------------------ | ------------------------------------------------------------- |
| `{{pnlClickId}}`                                 | ID клика PNLight для найденного пользователя.                 |
| `{{sub_id}}`, `{{click_id}}` или другой параметр | Одноименное значение исходного URL кампании.                  |
| Параметры AppsFlyer                              | Данные атрибуции AppsFlyer, если выбрана атрибуция AppsFlyer. |

Переменные заменяются только в значениях query-параметров. Если значение отсутствует, переменная остается в итоговом URL. При тестировании проверяйте принимающую систему.

## Наследование и переопределение настроек синхронизированной кампании

Кампании Facebook могут наследовать настройки доставки из подключенной учетной записи сети. Используйте **Override**, если отдельной кампании нужны другие системные postback-запросы, postback-запросы событий приложения или сопоставление событий Facebook.

## Ввод расходов вручную

Расходы участвуют в расчете spend, CPI, CPT, CAC, ROI, ROAS и окупаемости когорт.

<Steps>
  <Step title="Откройте кампанию">Откройте **Campaigns** и выберите кампанию.</Step>
  <Step title="Задайте период">Обновите **Start date** и **End date**. Для открытой границы оставьте поле пустым.</Step>
  <Step title="Выберите даты расходов">Выберите даты в **Costs data**.</Step>
  <Step title="Введите дневные расходы">Укажите сумму по дням. Действие копирования переносит сумму на последующие даты.</Step>
  <Step title="Распределите месячную или общую сумму">Введите итог месяца или кампании, чтобы PNLight распределил расходы по датам.</Step>
  <Step title="Сохраните кампанию">Сохраните форму, чтобы обновить аналитику и метрики.</Step>
</Steps>

Можно также нажать **Import from CSV**. Используйте CSV из двух столбцов `date,cost` без заголовка. Формат даты — `YYYY-MM-DD`, сумма — десятичное число.

```csv theme={null}
2026-06-01,125.50
2026-06-02,130.00
2026-06-03,118.75
```

## Проверка настройки

* Откройте **URL for your Ad** с тестовыми параметрами и проверьте переход на **Redirect URL override** с ожидаемыми параметрами.
* Установите или откройте приложение из тестового потока и проверьте атрибуцию пользователя в **Customers**.
* Запустите системное событие или событие приложения с postback-запросом и проверьте его в профиле клиента.
* Проверьте расходы, установки, доход и ROAS кампании в **Campaigns**, **Analytics** и **Cohorts**.

## Основные проверки

* В ручной кампании используется **URL for your Ad** с правильным `pnlAdsCampaignId`.
* Синхронизированные кампании относятся к нужной сети и учетной записи.
* До запуска трафика задан **Redirect URL override**.
* Отключенные кампании исключены из фильтров и аналитики.
* Расходы соответствуют отчетному периоду.
* Названия событий postback совпадают с системными событиями или событиями SDK.
* Для Facebook Conversions API сопоставления настроены на уровне сети или кампании.