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

## Шаг 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="https://3673095133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnxAtAynJr1QMr8UL89zo%2Fuploads%2FMXJoLPI76Gz0ZHKggLBh%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-08-08%20%D0%B2%2019.31.35.png?alt=media&#x26;token=6d2fd237-2961-47ac-8df3-b31ab14bdef2" 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>

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

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

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