install_referrer

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

install_referrer 패키지는 Flutter 애플리케이션이 설치된 원본(예: Google Play, App Store, TestFlight)을 감지할 수 있도록 합니다. 앱 시작 시 리퍼러 정보를 검색할 수 있는 간단한 API를 제공하여 마케팅 캠페인과 사용자 획득 소스를 추적하는 데 도움을 줍니다. Android 및 iOS 모두와 호환되며 플러그인 인터페이스를 통해 네이티브 플랫폼 기능을 활용합니다. 이 패키지는 모바일 앱의 분석, 할당, 캠페인 추적에 유용합니다.

사용 사례

사용자 획득 원천 추적
마케팅 캠페인 성과 분석
분석 플랫폼과의 통합
특정 광고에 설치를 할당하기
추천 프로그램 지원

주요 기능

크로스 플랫폼 지원 (Android 및 iOS)
참조자 검색을 위한 간단한 API
플랫폼 채널을 통한 네이티브 통합
경량이며 최소한의 종속성
보안 데이터 처리

적합한 대상

마케팅 분석 팀
모바일 앱 개발자
캠페인 추적 시스템
추천 및 인센티브 프로그램
설치 추적을 필요로 하는 앱

고려 사항

두 플랫폼 모두에서 적절한 설정이 필요합니다
초기 설치 추천인에만 제한됨
플랫폼 고유의 구현에 따라 다름
모든 테스트 환경에서 작동하지 않을 수 있습니다
데이터 사용 가능성은 광고 네트워크 및 스토어 정책에 따라 달라집니다

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

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
    },
);

패키지, 저장소 및 앱 카테고리 검색