Adset.ProAdset.ProKnowledge base
To app
Home/PWA (Лендинги)/Зовнішні PWA

Зовнішні PWA

Зовнішні PWA

Зовнішні PWA дозволяють використовувати сторонні конструктори PWA-додатків (наприклад, PWA.Group, TSL.app та ін.) замість вбудованого конструктора платформи. Ви створюєте PWA на зовнішньому сервісі, а Adset.Pro бере на себе атрибуцію трафіку, генерацію посилання трекера та відправку постбеків про конверсії назад на зовнішній сервіс.

Розділ знаходиться в меню PWA, Apps & Лендінги → Зовнішні PWA (/app/pwa/external) і доступний на старших тарифах (Buying і Business ліній Social і Tracker).


Навіщо це потрібно

  • Будь-які зовнішні PWA-сервіси — працюйте з PWA з будь-якого сервісу, без прив'язки до одного вендора.

  • Чесні A/B-тести — порівнюйте різні PWA-сервіси в однакових умовах (одна кампанія, одні сети та фільтри).

  • Наскрізна статистика — вся воронка від кліка до конверсії в одному місці.

  • Adset.Pro як трекер — використовуйте платформу як повноцінний трекер для зовнішніх PWA.


Як це працює

  1. Користувач клацає по рекламі → потрапляє на трекер.

  2. Трекер редиректить трафік на зовнішній PWA-сервіс (по вашому URL PWA + параметрам сервісу).

  3. Користувач встановлює PWA на зовнішньому сервісі.

  4. Зовнішній сервіс редиректить користувача назад на посилання трекера.

  5. Трекер фіксує встановлення (подія EXTERNAL_INSTALL) і направляє користувача на офер за вашим Flow.

  6. При конверсії (реєстрація, депозит) платформа відправляє постбек на зовнішній сервіс (якщо задано Postback URL).


Створення зовнішньої PWA

На сторінці Зовнішні PWA натисніть «Додати зовнішню PWA» — відкриється майстер із трьох кроків. Переходити між кроками можна кнопками «Далі» і «Назад», зберегти PWA — кнопкою «Зберегти». Обов'язкові лише назва та URL PWA.

Крок 1. Сервіс і постбек

Поле

Обов'язкове

Опис

Назва

Так (мін. 2 символи)

Системна назва для ідентифікації PWA у вашому акаунті (наприклад, «Casino Slots — PWA Storm»). Користувачам не показується.

Активна

—

Перемикач поруч із назвою. Неактивна PWA не використовується в трекінгу.

Зовнішній сервіс

Ні

PWA-сервіс із каталогу. Від нього залежать шаблон Postback URL, параметри, які додаються до URL PWA, і макроси в посиланні трекера.

Postback URL

Ні

Куди платформа надсилає постбеки про конверсії. Якщо поле порожнє, під час вибору сервісу воно заповнюється з шаблону. Якщо поле вже заповнене і відрізняється від шаблону, поруч із назвою поля з'являється кнопка «Заповнити з шаблону».

Передавати Facebook CAPI у зовнішній сервіс

—

За замовчуванням увімкнено. Поки заповнений Postback URL, наші Facebook-пікселі за кліками цієї PWA не надсилаються — конверсії у Facebook передає сам сервіс. Вимкніть, щоб Facebook CAPI працював на нашому боці. Постбек у зовнішній сервіс надсилається в обох випадках.

Крок 2. Домен повернення

Оберіть Домен трекера — домен із ваших доменів, через який генерується посилання повернення. Під полем з'явиться «Згенероване посилання трекера» (докладніше — у наступному розділі).

Крок 3. Посилання сервісу

У поле URL PWA вставте посилання на вашу PWA, отримане у зовнішньому сервісі (наприклад, https://domain.com/). Параметри сервісу додаються на нашому боці: під полем показується «Підсумковий URL з параметрами сервісу» — на цю адресу трекер надішле користувача для встановлення PWA.

Посилання трекера (post-install redirect)

На кроці «Домен повернення» після вибору домена трекера з'являється готове посилання — блок «Згенероване посилання трекера». Його потрібно вказати на зовнішньому PWA-сервісі як посилання повернення після встановлення (post-install redirect) — тобто посилання на офер, на яке сервіс відправляє користувача. Пізніше посилання можна скопіювати зі списку: меню «⋮» у рядку → «Копіювати URL».

Формат посилання:

https://{домен}/track/{campaignId}/eflow?clickId={clickId}&eid={eid}
  • {campaignId}, {clickId}, {eid} — макроси, які зовнішній сервіс замінить реальними значеннями. При вибраному сервісі з каталогу макроси автоматично підставляються у форматі саме цього сервісу.

  • eid (External Event ID) — ідентифікатор події на стороні зовнішнього сервісу (наприклад, час події); зберігається і може використовуватися в Postback URL через макрос {postback.eid}.

Натисніть іконку копіювання, щоб скопіювати посилання в буфер обміну.


Налаштування Postback URL

Postback URL визначає, куди Adset.Pro відправить повідомлення про конверсію. Поле необов'язкове: без нього трекінг і атрибуція працюють, але постбеки на зовнішній сервіс не відправляються.

Доступні макроси

Макрос

Опис

{subid}

Наш унікальний ID кліка (clickId)

{postback.eid}

Зовнішній ID події з PWA-сервісу (eid)

{event.event_type}

Тип події: CPA_HOLD — реєстрація, CPA_ACCEPT — депозит, CPA_REDEP — редепозит

{event.user_country}

Країна користувача

{postback.event}

Коротка назва події: hold, accept, redep

{event.event_revenue}

Виплата за конверсією

{event.event_currency}

Валюта виплати

Варіативні макроси (маппінг подій)

Щоб підставляти різні значення для різних типів подій, використовуйте синтаксис:

{event.event_type: CPA_HOLD=reg CPA_ACCEPT=dep}

Це підставить reg на реєстрації та dep на депозиті. Якщо для типу події пари немає, підставиться сам тип (наприклад, CPA_REDEP).

Важливо: у макросі {event.event_type: …} вказуйте повні назви типів — CPA_HOLD, CPA_ACCEPT, CPA_REDEP. З короткими назвами (hold=reg accept=dep) збігу не буде, і в зовнішній сервіс піде CPA_HOLD замість reg. Короткі назви працюють із макросом {postback.event}: {postback.event: hold=reg accept=dep}.

Постбек у зовнішній сервіс надсилається лише на CPA-конверсії: реєстрацію, депозит і редепозит.

Приклад повного Postback URL

https://pwastorm.com/postback?click_id={postback.eid}&status={event.event_type: CPA_HOLD=reg CPA_ACCEPT=dep}

У багатьох сервісів у каталозі вже є шаблон постбека: перевірте його та замініть місця, позначені як REPLACE, на значення з вашого кабінету. Якщо Postback URL заповнювали раніше і в ньому стоїть hold=reg accept=dep, замініть на CPA_HOLD=reg CPA_ACCEPT=dep.


Використання зовнішньої PWA в кампанії

Щоб пустити трафік на зовнішню PWA:

  1. Відкрийте кампанію на редагування.

  2. У налаштуваннях потоку (Flow) у полі PWA виберіть створену зовнішню PWA. Тип PWA автоматично стане external.

  3. Збережіть кампанію.

Далі зовнішня PWA використовується в звичному Flow трекера — так само, як звичайна PWA.

A/B-тестування сервісів

Створіть кілька зовнішніх PWA (наприклад, на різних сервісах) і розподіліть їх по різним потокам/сетам однієї кампанії з вагами. Трафік розділиться по заданим часткам, а порівняти ефективність можна в статистиці по одній воронці.


Список і управління

На сторінці /app/pwa/external відображається таблиця з усіма зовнішніми PWA. Колонки: Назва, Сервіс, URL PWA, Домен трекера, Postback URL, Теги, Власник, Статус, Створено.

Фільтри: пошук за назвою, власник, статус (активна/неактивна), сервіс, теги.

Дії по рядку (меню «⋮»): Редагувати, Управління тегами, Копіювати URL, Видалити.

  • Видалення = деактивація. PWA не видаляється фізично, а переводиться в статус «Неактивна» (тумблер Активна в діалозі редагування робить те ж саме).

  • Масові дії: призначення тегів і деактивація для вибраних рядків.


Статистика і білінг

Встановлення у зовнішніх PWA фіксуються окремою подією EXTERNAL_INSTALL і не змішуються зі статистикою ваших власних PWA:

  • Окрема метрика External Install і конверсії Click → External Install, External Install → Reg, External Install → Dep.

  • Загальна метрика Install в звітах сумує внутрішні та зовнішні встановлення, тому воронка залишається повною.

  • Пікселі та постбеки для зовнішніх встановлень працюють так само, як для звичайних PWA. Виняток — Facebook-пікселі за ввімкненого «Передавати Facebook CAPI у зовнішній сервіс» (див. питання нижче).

  • Білінг: зовнішні встановлення не тарифікуються як ваші PWA-інстали (метрика PWA_INSTALLS їх не враховує).


Часто задавані питання

Що відбувається з Facebook-пікселями при використанні зовнішньої PWA?
Залежить від перемикача «Передавати Facebook CAPI у зовнішній сервіс» (за замовчуванням увімкнений). Поки він увімкнений і заповнений Postback URL, наші Facebook-пікселі за кліками цієї PWA не надсилаються — конверсії у Facebook передає зовнішній сервіс. Якщо перемикач вимкнений або Postback URL порожній, Facebook-пікселі працюють як зазвичай. Інші типи пікселів (URL, TikTok, Telegram) працюють як зазвичай у будь-якому разі.

Чи можна працювати без Postback URL?
Так. Без нього трекінг і атрибуція працюють, але платформа не відправляє постбеки на зовнішній сервіс.

Що таке eid?
eid (External Event ID) — ідентифікатор, який зовнішній PWA-сервіс передає при поверненні користувача. Він зберігається і може використовуватися в Postback URL через макрос {postback.eid} для кореляції подій на стороні сервісу.

Скільки зберігається зв'язка clickId → eid?
7 днів. Протягом цього часу всі конверсії за даним кліком будуть містити коректний eid у постбеках.