RuStore Install Referrer #

Language / Язык: 🇺🇸 English | 🇷🇺 Русский

English #

A Flutter plugin for getting install referrer information from RuStore (Russian app store). This plugin allows you to track app installations that came from advertising links and measure the effectiveness of your marketing campaigns.

Features #

• 🎯 Get install referrer information from RuStore
• 📊 Track advertising campaign effectiveness
• 🔒 Secure referrer retrieval with proper error handling
• ⚡ Multiple API methods for different use cases
• 🛡️ Safe methods that don't throw exceptions
• ⏱️ Timeout support for network requests
• 🔄 Automatic availability checking
• 📱 Supports RuStore SDK 7.0.0+

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  rustore_install_referrer: ^1.0.0

Then run:

flutter pub get

Android Setup #

1. Add RuStore repository

For build.gradle:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("https://artifactory-external.vkpartner.ru/artifactory/maven")
        }
    }
}

For build.gradle.kts:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("https://artifactory-external.vkpartner.ru/artifactory/maven")
        }
    }
}

2. Add dependency

For build.gradle:

dependencies {
    implementation("ru.rustore.sdk:installreferrer:7.0.0")
}

For build.gradle.kts:

dependencies {
    implementation("ru.rustore.sdk:installreferrer:7.0.0")
}

3. Minimum SDK version

For build.gradle.kts:

android {
    defaultConfig {
        minSdk = 23
        // ...
    }
}

Usage #

Basic Usage

import 'package:rustore_install_referrer/rustore_install_referrer.dart';

try {
  final details = await RustoreInstallReferrer.getInstallReferrer();
  print('Install Referrer: ${details.installReferrer}');
  print('Click Time: ${details.referrerClickTime}');
  print('Install Time: ${details.installBeginTime}');
  print('Has Referrer: ${details.hasReferrer}');
} on RuStoreInstallReferrerException catch (e) {
  print('Error: ${e.code} - ${e.message}');
}

Safe Usage (No Exceptions)

final result = await RustoreInstallReferrer.getInstallReferrerSafe();
if (result.isSuccess) {
  print('Referrer: ${result.referrerDetails!.installReferrer}');
} else {
  print('Error: ${result.error!.message}');
}

Get Only Referrer String

final referrer = await RustoreInstallReferrer.getInstallReferrerString();
print('Referrer: $referrer'); // Empty string if not available

Check RuStore Availability

final isAvailable = await RustoreInstallReferrer.isRuStoreAvailable();
if (isAvailable) {
  // RuStore is installed and supports Install Referrer API
} else {
  // RuStore is not available
}

With Timeout

try {
  final details = await RustoreInstallReferrer.getInstallReferrerWithTimeout(
    timeout: Duration(seconds: 5),
  );
  print('Referrer: ${details.installReferrer}');
} on RuStoreInstallReferrerException catch (e) {
  if (e.code == 'TIMEOUT') {
    print('Request timed out');
  }
}

API Reference #

ReferrerDetails

Available Methods

Error Handling #

Exception Types

The plugin throws RuStoreInstallReferrerException with the following error codes:

Example Error Handling

try {
  final details = await RustoreInstallReferrer.getInstallReferrer();
  // Handle success
} on RuStoreInstallReferrerException catch (e) {
  switch (e.code) {
    case 'REFERRER_NOT_FOUND':
      print('No referrer available');
      break;
    case 'RU_STORE_NOT_INSTALLED':
      print('Please install RuStore');
      break;
    case 'RU_STORE_OUTDATED':
      print('Please update RuStore');
      break;
    default:
      print('Error: ${e.message}');
  }
}

How RuStore Install Referrer Works #

1. Advertising Link: User clicks on a RuStore advertising link like:

   https://www.rustore.ru/catalog/app/com.yourapp?referrerId=campaign123
   

2. Installation: When user installs the app, RuStore stores the referrerId value

3. Retrieval: Your app can retrieve this referrer value using this plugin

4. One-time Use: The referrer can only be retrieved once, then it's deleted

5. Expiration: If not retrieved within 10 days, the referrer expires

Important Notes #

• ⚠️ One-time use: Install referrer can only be retrieved once
• ⏰ Expiration: Referrer data expires after 10 days
• 📱 RuStore required: Requires RuStore to be installed on the device
• 🔒 Security: Uses secure RuStore SDK for data retrieval

Platform Support #

Russian #

Flutter плагин для получения информации о Install Referrer из RuStore (российский магазин приложений). Этот плагин позволяет отслеживать установки приложений, которые пришли из рекламных ссылок, и измерять эффективность ваших маркетинговых кампаний.

Возможности #

• 🎯 Получение информации о Install Referrer из RuStore
• 📊 Отслеживание эффективности рекламных кампаний
• 🔒 Безопасное получение referrer с корректной обработкой ошибок
• ⚡ Несколько методов API для разных случаев использования
• 🛡️ Безопасные методы, которые не выбрасывают исключения
• ⏱️ Поддержка таймаутов для сетевых запросов
• 🔄 Автоматическая проверка доступности
• 📱 Поддержка RuStore SDK 7.0.0+

Установка #

Добавьте это в файл pubspec.yaml вашего проекта:

dependencies:
  rustore_install_referrer: ^1.0.0

Затем выполните:

flutter pub get

Настройка Android #

1. Добавьте репозиторий RuStore

Для build.gradle:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("https://artifactory-external.vkpartner.ru/artifactory/maven")
        }
    }
}

Для build.gradle.kts:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("https://artifactory-external.vkpartner.ru/artifactory/maven")
        }
    }
}

2. Добавьте зависимость

Для build.gradle:

dependencies {
    implementation("ru.rustore.sdk:installreferrer:7.0.0")
}

Для build.gradle.kts:

dependencies {
    implementation("ru.rustore.sdk:installreferrer:7.0.0")
}

3. Минимальная версия SDK

Для build.gradle.kts:

android {
    defaultConfig {
        minSdk = 23
        // ...
    }
}

Использование #

Базовое использование

import 'package:rustore_install_referrer/rustore_install_referrer.dart';

try {
  final details = await RustoreInstallReferrer.getInstallReferrer();
  print('Install Referrer: ${details.installReferrer}');
  print('Время клика: ${details.referrerClickTime}');
  print('Время установки: ${details.installBeginTime}');
  print('Есть Referrer: ${details.hasReferrer}');
} on RuStoreInstallReferrerException catch (e) {
  print('Ошибка: ${e.code} - ${e.message}');
}

Безопасное использование (без исключений)

final result = await RustoreInstallReferrer.getInstallReferrerSafe();
if (result.isSuccess) {
  print('Referrer: ${result.referrerDetails!.installReferrer}');
} else {
  print('Ошибка: ${result.error!.message}');
}

Получить только строку Referrer

final referrer = await RustoreInstallReferrer.getInstallReferrerString();
print('Referrer: $referrer'); // Пустая строка если недоступен

Проверка доступности RuStore

final isAvailable = await RustoreInstallReferrer.isRuStoreAvailable();
if (isAvailable) {
  // RuStore установлен и поддерживает Install Referrer API
} else {
  // RuStore недоступен
}

С таймаутом

try {
  final details = await RustoreInstallReferrer.getInstallReferrerWithTimeout(
    timeout: Duration(seconds: 5),
  );
  print('Referrer: ${details.installReferrer}');
} on RuStoreInstallReferrerException catch (e) {
  if (e.code == 'TIMEOUT') {
    print('Истекло время ожидания');
  }
}

Справочник API #

ReferrerDetails

Доступные методы

Обработка ошибок #

Типы исключений

Плагин выбрасывает RuStoreInstallReferrerException со следующими кодами ошибок:

Пример обработки ошибок

try {
  final details = await RustoreInstallReferrer.getInstallReferrer();
  // Обработка успеха
} on RuStoreInstallReferrerException catch (e) {
  switch (e.code) {
    case 'REFERRER_NOT_FOUND':
      print('Referrer недоступен');
      break;
    case 'RU_STORE_NOT_INSTALLED':
      print('Пожалуйста, установите RuStore');
      break;
    case 'RU_STORE_OUTDATED':
      print('Пожалуйста, обновите RuStore');
      break;
    default:
      print('Ошибка: ${e.message}');
  }
}

Как работает RuStore Install Referrer #

1. Рекламная ссылка: Пользователь нажимает на рекламную ссылку RuStore вида:

   https://www.rustore.ru/catalog/app/com.yourapp?referrerId=campaign123
   

2. Установка: Когда пользователь устанавливает приложение, RuStore сохраняет значение referrerId

3. Получение: Ваше приложение может получить это значение referrer с помощью данного плагина

4. Однократное использование: Referrer можно получить только один раз, затем он удаляется

5. Истечение: Если не получить в течение 10 дней, referrer истекает

Важные замечания #

• ⚠️ Однократное использование: Install referrer можно получить только один раз
• ⏰ Истечение: Данные referrer истекают через 10 дней
• 📱 Требуется RuStore: Необходим установленный RuStore на устройстве
• 🔒 Безопасность: Использует безопасный RuStore SDK для получения данных

Поддержка платформ #