install_referrer

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

O pacote install_referrer permite que aplicativos Flutter detectem a origem de sua instalação, como o Google Play, App Store ou TestFlight. Ele fornece uma API simples para recuperar informações de referrer no momento do lançamento do aplicativo, ajudando os desenvolvedores a rastrear campanhas de marketing e fontes de aquisição de usuários. Compatível com Android e iOS, ele utiliza recursos nativos da plataforma por meio de uma interface de plug-in. O pacote é útil para análise, atribuição e rastreamento de campanhas em aplicativos móveis.

Casos de uso

Rastrear fontes de aquisição de usuários
Analisando o desempenho da campanha de marketing
Integração com plataformas de análise
Atribuindo instalações a anúncios específicos
Apoio a programas de indicação

Principais recursos

Suporte multiplataforma (Android e iOS)
API simples para recuperação de referência
Integração nativa por meio de canais de plataforma
Leve e dependências mínimas
Manipulação segura de dados

Indicado para

equipes de análise de marketing
Desenvolvedores de aplicativos móveis
sistemas de rastreamento de campanha
Programas de indicação e incentivo
Aplicativos que exigem atribuição de instalação

Considerações

Requer configuração adequada em ambas as plataformas
Limitado ao referrer inicial de instalação apenas
Dependente da implementação específica da plataforma
Pode não funcionar em todos os ambientes de teste
A disponibilidade de dados depende das políticas da rede publicitária e da loja

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

A Flutter plugin that allows you to detect how your application was installed.

Supported platforms

Android: ✅
iOS: ✅

Feel free to open a PR to support new platforms.

Installation

Add install_referrer: ^1.2.1 to your pubspec.yaml file.
Import import 'package:install_referrer/install_referrer.dart';
Get the value by invoking the Future InstallReferrer.referrer

Possibles values

Android

Store	Value
Google Play	`InstallationAppReferrer.androidGooglePlay`
Amazon App Store	`InstallationAppReferrer.androidAmazonAppStore`
Huawei App Gallery	`InstallationAppReferrer.androidHuaweiAppGallery`
Oppo App Market	`InstallationAppReferrer.androidOppoAppMarket`
Samsung App Shop	`InstallationAppReferrer.androidSamsungAppShop`
Vivo App Store	`InstallationAppReferrer.androidVivoAppStore`
Xiaomi App Store	`InstallationAppReferrer.androidXiaomiAppStore`
Others	`InstallationAppReferrer.androidManually`

If the application was installed from a third party app (eg: GMail, Google Drive, Chrome…), it will be considered as a manual installation (InstallationAppReferrer.androidManually).

If the application was installed from a store (FDroid, Amazon App Shop…) which was not preinstalled on the device (a "non-system" app), it will also be considered as a manual installation (InstallationAppReferrer.androidManually).

If the Android application is in debug mode, it will be marked as InstallationAppReferrer.androidDebug.

iOS

Store	Value
App Store	`InstallationAppReferrer.iosAppStore`
Test Flight	`InstallationAppReferrer.iosTestFlight`

If the iOS application is in debug mode (eg: from the simulator), it will be marked as InstallationAppReferrer.iosDebug.

Package name

You can also get the package name (Android) or app id (iOS), by calling instead InstallReferrer.app

Widgets

If you want to receive the result directly in a Widget, you have two choices: InstallReferrerDetectorListener and InstallReferrerDetectorBuilder :

InstallReferrerDetectorBuilder(
  builder: (BuildContext context, InstallationApp? app) {
    if (app == null) {
      return const CircularProgressIndicator.adaptive();
    } else {
      return Text(
        'Package name:\n${app.packageName ?? 'Unknown'}\n'
        'Referrer:\n${referrerToReadableString(app.referrer)}',
          textAlign: TextAlign.center,
      );
    }
  },
);

InstallReferrerDetectorListener(
  child: YourWidget(),
    onReferrerAvailable: (InstallationApp? app) {
      // TODO
    },
);

Buscar pacotes, repositórios e categorias de apps