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

## Шаг 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).

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pwa.bot/bystryi-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.