Добавьте партнёрскую или реферальную программу в приложение на Capacitor или Ionic.

Почему в приложениях на WebView больше рефералов определяется точно

Нативное приложение получает точное совпадение по введённому коду, а переход через магазин сопоставляется уже после. Приложение на WebView может получить сам код тремя способами:

• URL запуска. Укажите Settings → General → Web app URL, и реферальные ссылки будут отправлять туда посетителей с компьютера (и с телефона, если для их платформы нет страницы в магазине), добавляя influto_code и influto_click. initialize читает оба параметра и очищает адресную строку.

• Диплинки. listenForCapacitorLaunchUrls(InfluTo) передаёт SDK URL холодного старта и каждое событие appUrlOpen; в Cordova вызовите InfluTo.handleLaunchUrl(url).

• Play Install Referrer. Ссылки InfluTo на Google Play несут код и клик в параметре referrer. Прочитайте его при первом запуске плагином Install Referrer и передайте в captureInstallReferrer.

Если код не передан, InfluTo переходит к сопоставлению по клику на ссылку в течение 72 часов. Характеристики устройств при этом не сравниваются.

Шаг 1: установка

Добавьте пакет. В Capacitor три плагина необязательны, но рекомендуются: @capacitor/device — данные об устройстве, @capacitor/preferences — хранилище, которое переживает сброс WebView, @capacitor/app — диплинки. После добавления выполните npx cap sync. Если плагинов нет, SDK использует настройки браузера по умолчанию.

Нет сборщика? Подключите сборку для script-тега с https://cdn.jsdelivr.net/npm/@influto/web@1/dist/index.global.js и используйте window.InfluTo. В ней только базовый SDK, а вспомогательным функциям из подпутей нужен сборщик.

npm install @influto/web
# Capacitor / Ionic apps (device info, storage, deep links):
npm install @capacitor/device @capacitor/preferences @capacitor/app

Шаг 2: инициализируйте один раз и в нужный момент

Вызовите initialize один раз в корне приложения и дождитесь результата. При сбое он выбрасывает InfluToApiError (status, body): перехватите ошибку, запишите в лог и продолжайте. При следующем запуске SDK попробует снова. В таблице ниже — когда вызывать initialize в каждой среде.

API-ключ (it_…, в разделе Setup & SDK) подходит и для разработки, и для продакшена. Храните его в .env.local, исключённом из git, и читайте через сборщик. Типичный запуск приложения на Capacitor с RevenueCat по порядку:

import InfluTo from '@influto/web';
import { capacitorAdapters, listenForCapacitorLaunchUrls } from '@influto/web/capacitor';
import { revenueCatCapacitor } from '@influto/web/revenuecat';
import { Purchases } from '@revenuecat/purchases-capacitor';

export async function startInfluTo() {
  await Purchases.configure({ apiKey: 'appl_…' }); // RevenueCat apps: configure it first
  try {
    await InfluTo.initialize({
      apiKey: import.meta.env.VITE_INFLUTO_API_KEY,
      appVersion: '1.4.0',
      ...(await capacitorAdapters()),
      revenueCat: revenueCatCapacitor(Purchases),
    });
  } catch (error) {
    console.warn('InfluTo initialize failed', error); // retried on the next launch
    return;
  }
  await listenForCapacitorLaunchUrls(InfluTo); // deep links → referral claim
  const attribution = await InfluTo.checkAttribution();
  const { appUserID } = await Purchases.getAppUserID();
  await InfluTo.identifyUser(appUserID);
}

Шаг 3: точно определяйте установки из Play Store

На Android прочитайте строку referrer при первом запуске через @capgo/capacitor-install-referrer или cordova-play-install-referrer и передайте её после initialize, до checkAttribution. Код, полученный позже, отменяет прежний ответ «органика», а установка с атрибуцией остаётся за своим автором.

await InfluTo.captureInstallReferrer(referrer); // the raw referrer string from the plugin
const attribution = await InfluTo.checkAttribution();

Шаг 4: дайте пользователям ввести код

applyCode(code) проверяет код, введённый пользователем, и применяет его, если он действителен. Пробелы по краям убираются, буквы переводятся в верхний регистр. Для недействительного кода возвращается valid: false и error_code, например CODE_NOT_FOUND или CODE_EXPIRED.

В React и Ionic React ReferralCodeInput из @influto/web/react — простая форма без стилей: она подставляет код из ссылки и применяет его при отправке. В Angular, Vue или без фреймворка соберите поле на основе applyCode.

Шаг 5: подключите покупки

InfluTo платит комиссию только за покупки, проверенные в магазине. Выберите один путь для каждой платформы:

• RevenueCat: передайте привязку как revenueCat: revenueCatCapacitor(Purchases) для @revenuecat/purchases-capacitor 7.5.10+, revenueCatCordova(window.Purchases) для cordova-plugin-purchases или revenueCatJs для purchases-js. Подключите её до checkAttribution: атрибут записывается в момент, когда реферал найден. Неудачные записи повторяются до 3 раз.

• Напрямую через магазин: передайте purchaseSource (см. таблицу). Если в Settings → Validation для приложения выбран режим store-direct, initialize сообщает о новых покупках и дозаписывает уже совершённые, каждую один раз.

На iOS для store-direct нужна подписанная транзакция StoreKit 2. capgoNativePurchasesSource передаёт её дальше, а с cordova-plugin-purchase проверьте, что ваша настройка её отдаёт. На Android эти источники не передают цену, поэтому разовые товары отправляйте сами, с price и currency, иначе они запишутся как $0.

В TWA у Digital Goods API нет события покупки, поэтому после каждой оплаты вызывайте InfluTo.syncExistingPurchases(). Цену digitalGoodsSource найдёт сам.

Подводные камни платформ

Большинство неудачных интеграций в WebView сводится к одной из этих причин:

• Хранилище Capacitor. Если установлен @capacitor/preferences, SDK хранит состояние там. localStorage в WebView стирается при смене androidScheme или iosScheme.

• ionic serve. В веб-сборке для разработки плагин RevenueCat для Capacitor — заглушка, поэтому запись атрибутов там ничего не делает. Тестируйте на устройстве.

• Cordova по умолчанию блокирует API. В новом шаблоне нужно добавить запись access origin для https://influ.to в config.xml и connect-src https://influ.to в Content-Security-Policy. RevenueCat объявил свой плагин для Cordova устаревшим, поэтому для нового приложения лучше выбрать Capacitor.

• Браузеры и PWA. В браузере или PWA всегда передавайте platform (ios или android) в reportPurchase: если SDK определяет веб, он не угадывает платформу. Веб-приложения на домашнем экране iOS не могут продавать встроенные покупки, но атрибуция работает.

Шаг 6: проверьте

Тестовые покупки не двигают деньги и не меняют вашу статистику:

1. 1

   Загляните в Setup & SDK. После первого успешного initialize там появится «SDK connected» с платформой, @influto/web и версией SDK. Флаг debug: true записывает в лог каждый шаг.

2. 2

   Имитируйте покупку. Кнопка Simulate a purchase в Setup & SDK отправляет тестовую sandbox-покупку через настоящий конвейер InfluTo. Введите один из своих кодов, чтобы увидеть, как он сработает.

3. 3

   Проверьте установку по реферальной ссылке на устройстве. Откройте реферальную ссылку автора на тестовом устройстве, установите приложение, запустите его и совершите покупку как sandbox-, TestFlight- или license-тестер. Integration log в режиме Sandbox покажет покупку с атрибуцией.

clearAttribution() стирает сохранённую атрибуцию, код и код запуска, чтобы пройти проверку заново. Если через MCP подключён кодовый агент, он может выполнить эти проверки за вас.