# Быстрый старт

## Шаг 1. Регистрация <a href="#shag-1.-registraciya" id="shag-1.-registraciya"></a>

Чтобы зарегистрироваться, переходим на [pwa.bot](https://pwa.bot/), нажимаем **Зарегистрироваться**, далее в форме вводим Имя, почту, пароль и промокод (если он у вас есть).

<div data-full-width="false"><figure><img src="https://telegra.ph/file/f37305d4ae442a3a15f00.png" alt="" width="563"><figcaption></figcaption></figure></div>

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

<br>

## Шаг 2. Создание PWA. Домен. <a href="#shag-2.-sozdanie-pwa.-domen" id="shag-2.-sozdanie-pwa.-domen"></a>

После первого входа в Личный кабинет, вы окажетесь на странице, где впоследствии будут отображаться ваши PWA. Но, сейчас их нет, поэтому нажимаем кнопку **+Создать PWA**.

<figure><img src="https://telegra.ph/file/b09f0f154ac0c3641a001.png" alt="" width="563"><figcaption></figcaption></figure>

После чего, откроется страница создания/редактирования PWA. Нажимаем на **Купить готовый домен**.

<figure><img src="https://telegra.ph/file/70828a7fee77e56f16816.png" alt="" width="563"><figcaption></figcaption></figure>

Далее выбираем понравившийся домен, обязательно (!!!) нажимаем кнопку **Купить домен** и подтверждаем в открывшемся окне.

<figure><img src="https://telegra.ph/file/b924d0695344f912fd5f2.png" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://telegra.ph/file/23b41268e77caabb3d50e.png" alt="" width="563"><figcaption></figcaption></figure>

Нажимаем **Сохранить и продолжить** и переходим к следующему разделу - **Трекер**.

## Шаг 3. Создание PWA. Трекер <a href="#shag-3.-sozdanie-pwa.-treker" id="shag-3.-sozdanie-pwa.-treker"></a>

В разделе **Трекер** вставляем ссылку на оффер (которую получили из ПП) или ссылку на созданную кампанию в своем Keitaro (да, мы рекомендуем использовать Keitaro 🫶).

<figure><img src="https://telegra.ph/file/398a33d710b9075cd34cb.png" alt=""><figcaption></figcaption></figure>

**Передача параметра external\_id в Keitaro**

Здесь остановимся подробнее. Итак, для того, чтобы Keitaro мог правильно сматчить пользователя pwa.bot и впоследствии постбеками передать события регистраций и депозитов в pwa.bot, а pwa.bot мог их далее передать в Facebook\*, очень удобно использовать встроенный параметр `external_id`.

<figure><img src="https://telegra.ph/file/89ae11fa70f049af6d95f.png" alt="" width="563"><figcaption></figcaption></figure>

Для того, чтобы передать в Keitaro external\_id нужно дописать в поле ссылки на оффер (в ЛК pwa.bot) дополнительный параметр `external_id={user_id}`. Именно так. С фигурными скобками.

<figure><img src="https://telegra.ph/file/2d250fe51a866454990b2.png" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
Не забывайте, что первый параметр в ссылке отделяется знаком вопроса **`?`** от пути, а все последующие параметры отделяются друг от друга знаком **`&`**. И их можно менять местами. Например, ссылка может выглядеть так:

```
https://mykeitarodomain.com/Hhdsf83hfx/?external_id={user_id}&sub1={sub_1}&sub2={sub_2}
```

или вот так:

```
https://mykeitarodomain.com/Hhdsf83hfx/?sub1={sub_1}&sub2={sub_2}&external_id={user_id}
```

И оба варианта будут правильными.
{% endhint %}

{% hint style="info" %}
Уникальный id пользователя, который назначается каждому посетителю PWA, находится в `user_id`.
{% endhint %}

### **Передача в Keitaro других динамических параметров**

pwa.bot позволяет передавать динамические GET-параметры, преобразуя их ключи. Для этого нужно в фигурных скобках указать название нужного ключа, например, если в объявлении Facebook\* указана ссылка:

```
https://mypwadomain.com/?fbp=2598347598324&campaign_id={{campaign.id}}
```

То для того, чтобы передать в Keitaro id рекламной кампании, достаточно в лк pwa.bot дописать параметр `&ad_campaign_id={campaign_id}`

### **Настройка ГЕО и клоакинга**

Чтобы PWA открывалась только для какого-то конкретного ГЕО, а для других показывался whitepage, нужно выбрать нужное ГЕО и включить Клоаку.

<figure><img src="https://telegra.ph/file/d25f3d7f1cc8c7e07b8b8.png" alt="" width="563"><figcaption></figcaption></figure>

<br>

## Шаг 4. Создание PWA. Настройка оформления. <a href="#shag-4.-sozdanie-pwa.-nastroika-oformleniya" id="shag-4.-sozdanie-pwa.-nastroika-oformleniya"></a>

Самый простой и быстрый способ настроить оформление - это полностью скопировать уже существующее приложение из Google Play или App Store. Для этого достаточно вставить ссылку на прилу, выбрать язык и нажать кнопку **Скопировать**.

<figure><img src="https://telegra.ph/file/acb57dd60dd14bdd0459f.png" alt="" width="563"><figcaption></figcaption></figure>

После чего, откроется окно предварительного просмотра, в котором нужно выбрать что копируем - Все оформление или, например, только картинки и иконку.

<figure><img src="https://telegra.ph/file/64c002c4c107234c3f996.png" alt="" width="563"><figcaption></figcaption></figure>

**Комментарии**

Теперь в оформлении осталось только добавить нужные восторженные комментарии. Это в самом низу этого же раздела. Нужно нажать на кнопку **Добавить комментарий**, выбрать имя (можно сгенерить случайное, нажав на "кубики" в поле ввода) и написать комментарий.

💡 мы рекомендуем всегда оставлять включенным пункт **Поддерживать актуальные даты комментариев**, чтобы для посетителей они всегда были свежими.

<figure><img src="https://telegra.ph/file/6a888a2da1ec43779c529.png" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://telegra.ph/file/f10e12e73192f699b5ff9.png" alt="" width="563"><figcaption></figcaption></figure>

## Шаг 5. Создание PWA. Аналитика. <a href="#shag-5.-sozdanie-pwa.-analitika" id="shag-5.-sozdanie-pwa.-analitika"></a>

В последнем важном разделе находятся ссылки для постбеков, которые нужно вставить в Keitaro в (в настройках кампании S2S Postbacks), а также настройки пикселя Fb\* (Meta\*).

Берем ссылки постбеков отсюда:

<figure><img src="https://telegra.ph/file/0d4c66b13ba17607a5e3b.png" alt="" width="563"><figcaption></figcaption></figure>

И копируем сюда:

<figure><img src="https://telegra.ph/file/58d94db4ae48129344235.png" alt="" width="563"><figcaption></figcaption></figure>

### **Настройка отправки событий в Facebook\***

Чтобы в FB\* корректно передавались (отстукивались) события регистраций и депозитов, нужно добавить пиксель, а потом вставить id пикселя (датасета) и API токен в соответствующие поля:

<figure><img src="https://telegra.ph/file/98436ac5f30975b917aad.png" alt="" width="563"><figcaption></figcaption></figure>

В целом, этого достаточно, но если хочется поменять стандартные события:

*Инсталл - Лид*

*Регистрация - Завершенная регистрация*

*Депозит - Покупка*

На какие то другие, то можно нажать на шестеренку и перенастроить их.

<figure><img src="https://telegra.ph/file/287ced3ba836118bcee10.png" alt="" width="563"><figcaption></figcaption></figure>

#### &#x20; <a href="#undefined" id="undefined"></a>

### ❗️Дополнительно. Важно❗️ <a href="#dopolnitelno.-vazhno" id="dopolnitelno.-vazhno"></a>

Пиксели, настроенные в ЛК, не добавляются в PWA. Они настраиваются для передачи событий через Conversions API. Чтобы разместить пиксель Facebook\* в PWA, либо включить параметр **Добавить все пиксели на страницу установки**..

<figure><img src="/files/lnaxTM94PMZE2oBy3WrL" alt="" width="563"><figcaption></figcaption></figure>

либо же добавить в ссылку параметр `fbp=8923749823498237`, где вместо *8923749823498237* нужно вставить id вашего пикселя (датасета). Это удобно делать прямо в Ads Manager через **Создать параметр url**:

<figure><img src="https://telegra.ph/file/7ce480e24a412afa6dd51.png" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://telegra.ph/file/8bb0d3db4d52fbdbce9f8.png" alt="" width="563"><figcaption></figcaption></figure>

## Тестирование

Чтобы проверить, что события корректно отправляются с сервера, следуйте [этой инструкции](/nastroiki-facebook/testirovanie-sobytii).

\* - внесена в перечень террористических организаций на территории РФ.


# Собственный домен

Чтобы настроить ваш собственный домен для работы с pwa.bot, нужно:

1. Передать управление DNS записями вашего домена в CloudFlare.
2. Прописать в настройках API ключ, сам домен и email аккаунта CloudFlare.
3. Обязательно нажать кнопку автонастройки в ЛК pwa.bot

## 1. Как передать домен в CloudFlare

Для передачи домена под управление CloudFlare, выполните следующие шаги:

1. Создайте аккаунт на сайте CloudFlare или войдите в существующий на <https://dash.cloudflare.com/>
2. Нажмите на кнопку "Add a site" и введите название вашего домена.
3. После анализа вашего сайта CloudFlare предложит список DNS-записей. Проверьте их и при необходимости внесите изменения.
4. CloudFlare предоставит вам новые DNS-сервера. Зайдите в панель управления вашего домена у вашего текущего регистратора и измените настройки DNS-серверов на предоставленные CloudFlare.
5. Подтвердите изменения и дождитесь обновления DNS записей. Это может занять некоторое время (от нескольких минут до 24 часов).

После переноса управления DNS в CloudFlare вы сможете настроить свой домен для работы с pwa.bot, следуя оставшимся указаниям.

<figure><img src="/files/PQD60gvUWaNU69Fe87Nh" alt=""><figcaption></figcaption></figure>

## Где взять API ключ CloudFlare?

Чтобы получить Global API Key от CloudFlare, выполните следующие шаги:

1. Войдите в свой аккаунт на сайте CloudFlare на <https://dash.cloudflare.com/>
2. Перейдите в раздел "Profile" (Профиль) <https://dash.cloudflare.com/profile>
3. Выберите вкладку "API Tokens" (API Токены) <https://dash.cloudflare.com/profile/api-tokens>
4. Найдите раздел "API Keys" (API Ключи) и нажмите на "View" (Посмотреть) рядом с "Global API Key" (Глобальный API Ключ).
5. Введите пароль от вашего аккаунта CloudFlare, чтобы подтвердить действие и отобразить ваш Global API Key.

<figure><img src="/files/MB2PHbvAmnLJlNVLVpyw" alt=""><figcaption></figcaption></figure>

## Автонастройка

Для завершения настройки, не забудьте нажать кнопку автонастройки.

<figure><img src="/files/qH5o4mtht9u2doP8Tc6E" alt=""><figcaption></figcaption></figure>


# Ссылка на оффер и user\_id

pwa.bot позволяет педавать в ваш трекер (Keitaro, Binom и т.д.) или ПП (партнерскую программу) любые статические или динамические параметры. Самым важным из них является user\_id, который pwa.bot присваивает каждому уникальному пользователю.&#x20;

## Для чего вообще передавать user\_id в ПП или Трекер?

Для того, чтобы потом использовать его в постбеках, которые будут отправляться из трекера или ПП в pwa.bot. Без этого параметра не получится сматчить визит с событиями, которые произошли вне pwa.bot, т.е. с **Регистрациями** и **Депозитами**. А значит, и в Facebook события не будут корректно отстукиваться.&#x20;

## Настройка передачи user\_id

Все трекеры и ПП могут иметь свой формат, в котором они умеют принимать Внешний user\_id. Обычно это можно посмотреть в документации или спросить у менеджера. Например в Keitaro он называется `external_id`, а в некоторых ПП можно передать через параметр `subacc`, `sub` или `clickid`.

Однако во всех случаях логика одинаковая - нужно добавить к ссылке на оффер параметр

```
key={user_id}
```

Где, вместо `key` нужно использовать название параметра ПП или трекера. Например, для Keitaro это будет выглядеть так:

```
external_id={user_id}
```

При этом в интерфейсе это выглядит примерно так:

<figure><img src="/files/V5oWIrdyYekCvo29N3j7" alt=""><figcaption></figcaption></figure>


# Настройка входящих постбеков

Чтобы pwa.bot узнал о внешних событиях, таких как **Регистрация** или **Депозит**, нужно их передать постбеками из вашей ПП (Партнерской Программы) или Трекера (Keitaro, Binom и т.д.).

Ключевым параметром, по которому происходит матчинг (связывание) событий с конкретным визитом, в постбеках нужно передавать user\_id, которые ранее использовался в [ссылке на оффер](/nastroiki-pwa.bot/ssylka-na-offer-i-user_id).

Например, для Keitaro (в Keitaro используется ключ `external_id`) постбеки должны быть настроены так:

<figure><img src="/files/JuZMzwqpfsyjo7hvwbKa" alt=""><figcaption></figcaption></figure>

## Какие параметры должен содержать постбек

1. `user_id` - ранее переданный из pwa.bot. Как передать смотрите [здесь](/nastroiki-pwa.bot/ssylka-na-offer-i-user_id).
2. `event` - название события (может принимать значение **reg** или **dep**)
3. `value` - **Только для событий депозитов.** Это сумма, возгаграждение, которое выплачивает ПП.&#x20;
4. `currency` - **Только для событий депозитов.** Обозначение валюты, в которой выплачивается вознаграждение. Пока принимаем только со значением **usd**.

## Постбеки, если используете Keitaro

Для регистрации:

```
https://api.pwa.bot/postback/?user_id={external_id}&event=reg
```

Для депозита:

```
https://api.pwa.bot/postback/?user_id={external_id}&event=dep&value={profit}&currency=usd
```


# Настройка исходящих постбеков

pwa.bot может передавать данные о событиях во внешние системы аналитики, трекеры и т.д.

Для этого нужно прописать адреса эндпоинтов для отправки данных по событиям **в разделе Аналитика** настроек pwa.

<figure><img src="/files/of6n28R4IkqeQuCns9xZ" alt="" width="563"><figcaption></figcaption></figure>

## Доступные макросы для исходящих постбеков

1. `{user_id}` - id юзера, присвоенный в pwa
2. `{pwa}` - id pwa
3. `{ip}` - IP адрес пользователя или сервера (для событий reg и dep)
4. `{country}` - двухбуквенный код страны
5. `{domain}` - домен pwa
6. `{event}` - событие (install, push, open, reg, dep)
7. `{visit.nazvanie_parametra}` - любой GET-параметр из визита. Например, если пользователи переходят на pwa по ссылке <https://pwadomain.com/?sub1=111\\&sub2=222>, то можно указать в постбеке макрос {visit.sub1}, и тогда вместо него подставится значение 111.
8. `{get_nazvanie_parametra}` - любой параметр **из входящего** постбека. Например, если пришел постбек о депозите с параметром value=50, то можно использовать макрос {get\_value} и тогда вместо него подставится значение 50.


# Интеграция с facebook

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

## Что нужно для отправки событий?

1. id пикселя
2. токен пикселя для Conversions API.

## Где взять id пикселя?

Идем в Events Manager, выбираем Источники данных, затем нужны пиксель и кликаем по id группы данных. Это и есть нужный id.

<figure><img src="/files/OXlTITREKot0QRIbLVxo" alt="" width="563"><figcaption></figcaption></figure>

## Где взять токен и что настроить в facebook?

Предполагаем, что у вас уже есть БМ и в нем созан датасет (пиксель). Идем в Events Manager, потом в настройках пикселя создаем токен.&#x20;

<figure><img src="/files/T9qmSwydbTE5a1iVNHW2" alt="" width="563"><figcaption></figcaption></figure>

Либо на главной странице пикселя в Events Manager, нужно добавить интеграцию через Conversions API.

<figure><img src="/files/nOtHnxrRbmN037tSUPeX" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/myWY1o8Woa3NG9LXO4g1" alt="" width="563"><figcaption></figcaption></figure>

На следующем шаге выберите события **Завершенная регистрация** и **Покупка**

<figure><img src="/files/jyDTAXEx6NCUIpFTcAea" alt="" width="563"><figcaption></figcaption></figure>

Для обоих событий выберите **ID события** в Сведениях о событиях

<figure><img src="/files/VQdXBTYw5vcLIixCZjv1" alt="" width="563"><figcaption></figcaption></figure>

А в информации о клиенте выберите указанные параметры

<figure><img src="/files/RV4BNi7R7YJ585my420R" alt="" width="563"><figcaption></figcaption></figure>

В конце проверьте, чтобы было вот так

<figure><img src="/files/dw3xEGuXwu6Xo7UeShR7" alt="" width="563"><figcaption></figcaption></figure>

## Куда это все?

В ЛК pwa.bot в разделе Аналитика нажмите Добавить пиксель.

<figure><img src="/files/rGsut0ZxdNYmKiva1Djq" alt="" width="563"><figcaption></figcaption></figure>

А затем вставьте id пикселя и токен в нужные поля.

<figure><img src="/files/fUh5u4735FFDUPOZ4bmT" alt="" width="563"><figcaption></figcaption></figure>

## Вставка пикселя в PWA

### ❗️Дополнительно. Важно❗️ <a href="#dopolnitelno.-vazhno" id="dopolnitelno.-vazhno"></a>

Пиксели, настроенные в ЛК, не добавляются в PWA. Они настраиваются для передачи событий через Conversions API. Чтобы разместить пиксель Facebook\* в PWA, либо включить параметр **Добавить все пиксели на страницу установки**..

<figure><img src="/files/lnaxTM94PMZE2oBy3WrL" alt="" width="563"><figcaption></figcaption></figure>

либо же добавить в ссылку параметр `fbp=8923749823498237`, где вместо *8923749823498237* нужно вставить id вашего пикселя (датасета). Это удобно делать прямо в Ads Manager через **Создать параметр url**:

<figure><img src="https://telegra.ph/file/7ce480e24a412afa6dd51.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://telegra.ph/file/8bb0d3db4d52fbdbce9f8.png" alt=""><figcaption></figcaption></figure>

## Тестирование

Чтобы проверить, что события корректно отправляются с сервера, следуйте [этой инструкции](/nastroiki-facebook/testirovanie-sobytii).

## Руководство от Facebook

По ссылке ниже руководство от Facebook по подключению Conversions API.

<https://www.facebook.com/business/help/232481544843294>

\* - внесена в перечень террористических организаций на территории РФ.


# Матчинг параметров

Здесь описано как матчить входящие параметры с теми, которые нужно передать дальше в трекер или Партнерку.

👉 Более подробно про макросы можно прочитать [здесь](/poleznoe/makrosy-i-sub-id).

Рассмотрим на примере. Итак, Мы указали в объявлении FB в URL объявления вот такую ссылку:

`https://example.com/?param1={{campaign.id}}&param2={{adset.id}}&param3={{site_source_name}}&param4={{placement}}&param5={{ad.id}}&buyerId=b1`

А как мы знаем, тогда в PWA попадают пользователи по ссылкам вида:

`https://pwadomain.fun/?param1=6604771447991&param2=6604771448191&param3=ig&param4=instagram_feed&param5=6604771448391&buyerId=b1`

То есть с уже подставленными значениями в параметры `param1`, `param2`, `param3`, `param4`, `param5`. А значение пареметра `buyerId` указано статично, а не макросом.

Допустим, что параметр `buyerId` содержит id баера, значение которого мы хотим передать в ПП. Мы его прописали статично в URL объявлений. И еще, пусть мы хотим передать в ПП id рекламной кампании.

Пусть ПП умеет принимать только параметры `sub1`, `sub2`, `sub3`, `sub4` и `sub5.` И умеет принимать id пользователя или click id в параметре `sub10`.

{% hint style="success" %}
pwa.bot позволяет на лету передать в ПП **значение** любого параметра, который был у визита. А уникальное значение id пользоветеля, которое pwa.bot назначает каждому пользователю доступно через макрос **`{user_id}`**
{% endhint %}

Давайте передадим id баера в `sub1`, id адсета в `sub2` и id юзера, назначенный в PWA в `sub10`. Тогда нам нужно прописать в ссылке на оффер вот так:

`https://offerdomain.com/?sub1={buyerId}&sub2={param2}&sub10={user_id}`

тогда в ПП придет пользователь у которого будет:

**sub1=id баера** (статическое значение, из URL в Facebook)

**sub2=id адсета** (динамическое значение, из URL в Facebook)

**sub10=id пользователя PWA.bot** (динамическое значение из pwa.bot)

<figure><img src="/files/Qk9Rrj5Xg13Co8ygYA3W" alt="" width="563"><figcaption></figcaption></figure>


# Создание пикселя

#### Как создать пиксель в Facebook Business Manager

Facebook пиксель является критически важным инструментом для отслеживания конверсий, оптимизации рекламных кампаний и создания аудиторий для целевой рекламы. Создание пикселя в Facebook Business Manager позволит вам извлечь максимум пользы из вашей рекламы на Facebook. Вот пошаговая инструкция:

1. **Зайдите в ваш аккаунт Facebook Business Manager.** Если у вас его еще нет, вам нужно будет создать его, перейдя на сайт business.facebook.com.
2. **Откройте вашу учетную запись рекламы** через меню Business Manager, найдя раздел "Настройки бизнеса".
3. В разделе **"Источники данных" выберите "Наборы данных".** Этот раздел позволяет управлять вашими данными для отслеживания активности на сайте.
4. Нажмите кнопку **"Добавить"**, чтобы начать создание нового пикселя. Это действие откроет мастер настройки.
5. **Введите название для вашего пикселя**. Выбирайте название, которое четко описывает для какого сайта или бизнеса он предназначен.
6. После этого нажмите на **"Создать"**, и пиксель будет создан.
7. **Выберите способ подключения к сайту.** Здесь нужно выбрать **Пиксель Meta и Conversions API.**
8. На следующем шаге выберите Внедрение API вручную.
9. В разделе **Выбора событий** отметьте **Покупку** и **Завершенную регистрацию**.
10. На следующем шаге **для каждого события** отметьте
    1. ID события
    2. IP адрес
    3. Внешний ID
    4. ID Клика
    5. ID Браузера
11. После чего в Events Manager перейдите в раздел Настройки и сгенерируйте маркер доступа - это и будет токен пикселя, который нужно вставить в ЛК pwa.bot

Смотрите подробнее в видео:

{% embed url="<https://youtu.be/iSS2p5rS3S4>" %}

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


# Макросы Facebook

Подробнее о макросах читайте [здесь](/poleznoe/makrosy-i-sub-id).

Официальная документация Meta [здесь](https://www.facebook.com/business/help/2360940870872492).

## Список макросов

<table><thead><tr><th width="388">Макрос</th><th>Значения</th></tr></thead><tbody><tr><td>{{campaign.id}}</td><td>id кампании</td></tr><tr><td>{{adset.id}}</td><td>id группы объявлений (id адсета)</td></tr><tr><td>{{ad.id}}</td><td>id объявления</td></tr><tr><td>{{campaign.name}}</td><td>Название кампании</td></tr><tr><td>{{adset.name}}</td><td>Название группы объявлений (адсета)</td></tr><tr><td>{{ad.name}}</td><td>Название объявления</td></tr><tr><td>{{site_source_name}}</td><td><p>Источник (площадка). Может принимать одно из следующих значений: </p><ul><li><code>ig</code> - Instagram</li><li><code>an</code> - Audience Network</li><li><code>msg</code> - Messenger</li><li><code>fb</code> - Facebook</li></ul></td></tr><tr><td>{{placement}}</td><td><p>Место размещения. Может принимать одно из следующих значений:<br></p><ul><li><code>instagram_feed</code></li><li><code>instagram_stories</code></li><li><code>messenger_inbox</code></li><li><code>messenger_sponsored_messages</code></li><li><code>facebook_right_column</code></li><li><code>facebook_mobile_feed</code></li><li><code>facebook_desktop_feed</code></li><li><code>facebook_instant_article</code></li><li><code>facebook_instream_video</code></li><li><code>audience_network</code></li><li><code>facebook_marketplace</code></li></ul></td></tr></tbody></table>

&#x20;   &#x20;


# Тестирование событий

Facebook позволяет отправлять в пиксель тестовые события через Conversions API. Для того, чтобы удостовериться, что все настроено верно, следуйте этой инструкции:

## Шаг 1. Facebook

Перейдите в Events Manager в Источники данных,  выберите свой пиксель и перейдите в раздел **Тестирование событий**.

<figure><img src="/files/94QSsabCkMfvpcfbr1v6" alt="" width="563"><figcaption></figcaption></figure>

Затем разверните секцию **Убедитесь, что события сервера настроены правильно** и скопируйте **test\_event\_code**

<figure><img src="/files/sGegiFXJ3Jn5cyEfZNdp" alt="" width="563"><figcaption></figcaption></figure>

## Шаг 2. pwa.bot

В настройках pwa во вкладке аналитика выберите кнопку Пульс у вашего пикселя.

<figure><img src="/files/K1duppGsL7EhNhjaauEB" alt="" width="563"><figcaption></figcaption></figure>

Окроется окно, в котором нужно вставить **test\_event\_code**, скопированный в Facbook на предыдущем шаге. Затем нажать кнопку **Начать тест**.

<figure><img src="/files/CiYYDX99ZplYXF0Eo1fB" alt="" width="563"><figcaption></figcaption></figure>

Во время теста будут отправлены все стандартные события Facbook.&#x20;

<figure><img src="/files/48Kjp8TQWfvojLpehkVV" alt="" width="563"><figcaption></figcaption></figure>

## Шаг 3. Проверка

На последнем шаге, вернитесь обратно в Facebook и удостоверьтесь, что все отправленные события корректно отображаются.

<figure><img src="/files/zZwPEuBZ35zIHGrxRUbi" alt="" width="563"><figcaption></figcaption></figure>


# Создание пикселя Bigo Ads

1. Чтобы создать пиксель перейдите в свой кабинет Bigo Ads - <https://ads.bigo.sg/login>
2. Перейдите в раздел **Library -> Website Pixel**

<figure><img src="/files/GoFgUhtKtf1xtNlZA7VM" alt="" width="563"><figcaption></figcaption></figure>

3. Нажмите кнопку **Create** чтобы создать пиксель

<figure><img src="/files/jn0XOts3BV7bck15MuKx" alt="" width="563"><figcaption></figcaption></figure>

4. Введите название пикселя и выберите **Event API Integration**.

<figure><img src="/files/yy3f9OXvweFbeA83TnXG" alt="" width="563"><figcaption></figcaption></figure>

5. На следующем шаге в **Complete Paymente** поставьте **Every**. Внизу страницы нажмити **Finish** для завершения.

<figure><img src="/files/avapnVHUE3trUUE9yOim" alt="" width="563"><figcaption></figcaption></figure>

6. Ваш пиксель готов. Скопируйте его ID, он понадобится в ЛК [pwa.bot](https://pwa.bot/dashboard).

<figure><img src="/files/GcbxBSvamJlmkftSiDNe" alt="" width="563"><figcaption></figcaption></figure>

7. Добавьте пиксель в настройках PWA на Вкладке Аналитика.&#x20;

<figure><img src="/files/PJGuBwtxTk6QPF1DTsYT" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/jL1Xh6yviL8x9Ljqdf7S" alt="" width="563"><figcaption></figcaption></figure>

8. При необходимости переопределите отправляемые события.

<figure><img src="/files/iV2yFMbjW3hWvmA7Y9Vk" alt="" width="563"><figcaption></figcaption></figure>


# Создание пикселя Kwai Ads

1. Чтобы создать пиксель перейдите в свой кабинет Kwai Ads manager <https://ads.kwai.com>
2. Перейдите в раздел **Assets -> Web Events**

<figure><img src="/files/XQcMCiXPzmaZNps2oN39" alt="" width="563"><figcaption></figcaption></figure>

3. Нажмите кнопку **Set up web events** чтобы создать пиксель

<figure><img src="/files/nWZ8IahOTEOzsDPqTtt9" alt="" width="563"><figcaption></figcaption></figure>

4. Введите любое название и выберите **Event API**. Затем нажмите **Next**.

<figure><img src="/files/bm5mREBzocwmMOymt0Y3" alt="" width="563"><figcaption></figcaption></figure>

5. На следующем экране просто нажмите ок.

<figure><img src="/files/DxPriccHHlkP1LYSpuT6" alt="" width="563"><figcaption></figcaption></figure>

6. На этом создание пикселя завершено. **Но он не активен**. Теперь в него **нужно прокинуть тестовых событий, чтобы пиксель активировался** и его можно было использовать в рекламных кампаниях Kwai Ads.
7. Копируем ID пикселя. Сохраняем его куда нибудь.

<figure><img src="/files/eIqU6meels610iHHyUmB" alt="" width="563"><figcaption></figcaption></figure>

8. Переходим в Settings. И генерируем токен.

<figure><img src="/files/uGrHOgJstbTfraRa4Nde" alt="" width="563"><figcaption></figcaption></figure>

9. Переходим в ЛК pwa.bot, заходим в нужную PWA в раздел **Аналитика**. Листаем до **Интеграция с Kwai Ads** и вставляем в нужные поля ID пикселя и токен.&#x20;
10. Затем нажимаем на кнопку с иконкой пульса. Будем оживлять созданный пиксель )

<figure><img src="/files/0PSFqPvlV4g4RLcp0s7G" alt="" width="563"><figcaption></figcaption></figure>

11. Возвращаемся в Kwai Ads manager в раздел **Test Events**. И копируем тестовый Click ID.

<figure><img src="/files/6Z7N7SIe5ppVIZLkVeBk" alt="" width="563"><figcaption></figcaption></figure>

12. Возвращаемся в ЛК pwa.bot и вставляем скопированный тестовый Click ID. Затем нажимаем **Начать тест**.

<figure><img src="/files/bii3cAgP5jtHruV0qNyz" alt="" width="563"><figcaption></figcaption></figure>

13. Ждем, когда отправятся все тестовые события (\~10 секунд).&#x20;

<figure><img src="/files/59M177Jk8uv98k8LFaCd" alt="" width="563"><figcaption></figcaption></figure>

14. После этого возвращаемся в Kwai Ads manager и проверяем, что все тестовые события видно.

<figure><img src="/files/YXoCkok911YqGEZqbXQ0" alt="" width="563"><figcaption></figcaption></figure>

15. После этого обновляем страницу в Kwai и пиксель становится зелененьким. Со статусом Active.&#x20;

<figure><img src="/files/R8rKqOVEqSDzf9nIy78t" alt="" width="563"><figcaption></figcaption></figure>

16. На этом настройка завершена. Пиксель активен и его можно использовать в рекламных кампаниях. **Не забываем сохранить настроки PWA** в ЛК pwa.bot, чтобы реальные события отправлялись в Kwai.


# Макросы и SUB ID

\*Оригинал статьи здесь: <https://fbm.red/pwa-subs/>

## Использование Макросов и Sub ID (сабов) в Арбитраже Трафика

Арбитраж трафика — это стратегический процесс, требующий тщательного отслеживания и анализа данных для эффективного управления кампаниями. В этом контексте макросы и Sub ID играют ключевую роль, позволяя более глубоко понимать и оптимизировать источники трафика. Рассмотрим, как эти инструменты помогают арбитражникам в их деятельности.

## **Макросы**

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

Например, макросы могут выглядеть так:

```url
http://example.com/?source={source}&campaign={campaign_id}&device={device_type}
```

Здесь используются макросы для определения источника трафика, идентификатора кампании и типа устройства пользователя. В этом примере макросы - это:&#x20;

`{source}` - источник трафика

`{campaign_id}` - id рекламной кампании

`{device_type}` - тип устройства.

{% hint style="info" %}
Чаще всего макросы указываются **в одинарных фигурных скобках** вот так - `{nazvanie_macrosa}`. Но бывают сервисы/трекеры/рекламные сети и др., где используется другой синтаксис. Например **в Facebook макросы пишутся в двойных фигурных скобках**, к примеру, макрос `{{campaign.id}}` подставит в URL объявления id кампании.
{% endhint %}

### Доступные макросы в Facebook

Список доступных макросов можно посмотреть [здесь](/nastroiki-facebook/makrosy-facebook).

### Для чего вообще нужны макросы?

Для того, чтобы вместо них подставлялись **РЕАЛЬНЫЕ** **ЗНАЧЕНИЯ** параметров. Ведь, каждый сервис имеет свой собственный набор данных. И эти данные обычно нужно куда-то передать.&#x20;

Например, у вас есть в фейсбуке есть 5 кампаний, в каждой кампании по 5 адсетов, в каждом адсете по 5 объявлений. Итого 125 объявлений 😱. И вы в своем трекере/ПП/системе аналитики хотите видеть какие из них приносят конверсии. Значит нужны какие то уникальные параметры для каждого объявления. Например, мы будем использовать id кампании, id адсета и id объявления. И здесь два пути: либо размечать каждое объявление руками (что, по-любому, приведет к ошибкам), либо использовать одну ссылку для всех объявлений, но с макросами.

Ссылка с макросами в этом случае будет выглядеть вот, к примеру, так:

`https://example.com/?param1={{campaign.id}}&param2={{adset.id}}&param3={{site_source_name}}&param4={{placement}}&param5={{ad.id}}`

А реальные переходы будут выглядеть примерно так:

`https://example.com/?param1=6604771447991&param2=6604771448191&param3=ig&param4=instagram_feed&param5=6604771448391`

То есть ссылке везде одинаковая, но для каждого объявления вы будете видеть уникальные значения параметров.

{% hint style="info" %}
Вместо **`param1..param5`**, соответственно, могут быть использованы любые другие названия параметров. Это зависит от того, куда вы отправляете трафик (каждый трекер и ПП умеют принимать по своему. К примеру это могут быть, так называемые САБЫ (\*арбитражный сленг), то есть **`sub1...sub5`** или **`sub_id_1...sub_id_5`** или **`subId1...subId5`** или **`subacc1...subacc5`**
{% endhint %}

{% hint style="success" %}
А pwa.bot умеет принимать АБСОЛЮТНО любые названия параметров. Далее расскажем как их можно трансформировать в то, что принимает трекер или ПП.
{% endhint %}

## **Sub ID**

Sub ID — это специфические метки, используемые в CPA-сетях и партнерских программах для идентификации различных параметров, таких как источник трафика, креатив или рекламная платформа. Sub ID помогают арбитражникам отслеживать и анализировать эффективность различных элементов их кампаний.

Пример использования Sub ID:

```ruby
http://example.com/?sub1=google&sub2=cpc&sub3=video_ad&sub4=male
```

Здесь `sub1` указывает на источник трафика, `sub2` — на тип кампании, `sub3` — на креатив, а `sub4` — на целевую аудиторию.

Синтаксис Сабов может отличаться у каждой Партнерки или трекера.&#x20;

### Параметры в Keitaro

По умолчанию сабы в Keitaro пишутся вот так: `sub_id_1` - `sub_id_30`

[Документация Keitaro](https://docs.keitaro.io/ru/campaigns-and-streams/campaign-parameters.html).

### Параметры в Binom

У Binom параметры (и сабы) называются токенами. И их можно называть самостоятельно.

[Документация Binom](https://docs.binom.org/create-source.php#tokens).

### Для чего вообще нужны Сабы?

Для того, чтобы трекер или Партнерка могли принять и сохранить нужные параметры. Чаще всего после конверсий, ПП отправляет постбеки с данными о конверсии. И чтобы источник трафика (трекер или конструктор PWA - pwa.bot) мог правильно сматчить их со своими данными визитов и далее передать конверсию в источник трафика, например, Facebook.

## Матчинг параметров в pwa.bot

Рассмотрим на примере. Итак, Мы указали в объявлении FB в URL объявления вот такую ссылку:

`https://example.com/?param1={{campaign.id}}&param2={{adset.id}}&param3={{site_source_name}}&param4={{placement}}&param5={{ad.id}}&buyerId=b1`

А как мы знаем, тогда в PWA попадают пользователи по ссылкам вида:

`https://example.com/?param1=6604771447991&param2=6604771448191&param3=ig&param4=instagram_feed&param5=6604771448391&buyerId=b1`

То есть с уже подставленными значениями в параметры `param1`, `param2`, `param3`, `param4`, `param5`. А значение пареметра `buyerId` **указано статично, а не макросом**.

Допустим, что параметр `buyerId` содержит id баера, значение которого мы хотим передать в ПП. Мы его прописали статично в URL объявлений. И еще, пусть мы хотим передать в ПП id рекламной кампании.

Пусть ПП умеет принимать только параметры `sub1`, `sub2`, `sub3`, `sub4` и `sub5.` И умеет принимать id пользователя или click id в параметре `sub10`.

{% hint style="success" %}
pwa.bot позволяет на лету передать в ПП **значение** любого параметра, который был у визита. А уникальное значение id пользоветеля, которое pwa.bot назначает каждому пользователю доступно через макрос **`{user_id}`**
{% endhint %}

Давайте передадим id баера в `sub1`, id адсета в `sub2` и id юзера, назначенный в PWA в `sub10`. Тогда нам нужно прописать в ссылке на оффер вот так:

`https://offerdomain.com/?sub1={buyerId}&sub2={param2}&sub10={user_id}`

тогда в ПП придет пользователь у которого будет:

**sub1=id баера** (статическое значение, из URL в Facebook)

**sub2=id адсета** (динамическое значение, из URL в Facebook)

**sub10=id пользователя PWA.bot** (динамическое значение из pwa.bot)

<figure><img src="/files/Qk9Rrj5Xg13Co8ygYA3W" alt="" width="563"><figcaption></figcaption></figure>

### Заключение

Макросы, UTM-метки и Sub ID — это мощные инструменты в арбитраже трафика, которые позволяют более глубоко понимать поведение пользователей и эффективность кампаний. Их правильное использование помогает арбитражникам оптимизировать свои усилия, повышать рентабельность и максимально использовать доступные данные для принятия обоснованных решений.