パッケージ、リポジトリ、アプリカテゴリを検索

app_tracking_transparency のカバー
パッケージ詳細v2.0.7

app_tracking_transparency

このFlutterプラグインを使用すると、iOSのトラッキング許可ダイアログを表示し、データ収集の許可を要求できます。

iOS
30日間ダウンロード
46.2万
いいね数
481
Pub ポイント
160

パッケージをインストール

flutter pub add app_tracking_transparency

パッケージ概要

公開情報に基づく選定ガイドです。参考としてご利用ください。

app_tracking_transparency パッケージは、Apple のアプリ追跡の透明性フレームワークを介して、iOS アプリがユーザーのトラッキング許可を求めるための Flutter プラグインです。システムレベルの承認ダイアログを表示する簡単なインターフェースを提供し、開発者が Apple のプライバシー要件に準拠できるようにします。このプラグインは iOS とシームレスに統合され、ユーザーの同意状態を適切に処理します。iOS デバイス上で広告や分析目的でデータを収集するアプリには不可欠です。

用途

  • iOSでのトラッキングに対するユーザーの同意を求める
  • Appleのプライバシー規制に準拠する
  • トラッキング権限を必要とする広告ネットワークとの統合
  • リアルタイムでユーザーの同意状態をモニタリングする
  • プライバシー準拠の分析を有効にする

主な機能

  • ネイティブなiOSトラッキング許可ダイアログを表示します
  • iOSプラットフォームのみをサポート
  • 認証ステータスのトラッキング用コールバックを提供します
  • Flutterアプリとのシンプルな統合
  • Apple のアプリ追跡の透明性ガイドラインに従っています

適している対象

  • 広告サービスを使用するiOS専用アプリ
  • Appleのプライバシーポリシーに準拠する必要がある開発者
  • サードパーティの分析または広告SDKと統合されたアプリ
  • トラッキングのユーザー同意管理を必要とするプロジェクト

注意事項

  • iOS プラットフォームでのみ利用可能
  • アプリロジックでユーザー応答を適切に処理する必要があります
  • Androidデバイスでは動作しません
  • Apple の AppTrackingTransparency フレームワークと併用する必要があります
  • すべてのトラッキング活動において、ユーザーの同意を尊重する必要があります

元の README

関連するソースリポジトリの README 原文のスナップショットです。最新の内容はリポジトリをご覧ください。

app_tracking_transparency

pub package

This Flutter plugin allows you to display ios 14+ tracking authorization dialog and request permission to collect data. Collected data is crucial for ad networks (ie admob) to work efficiently on ios 14+ devices.

Introduction

Starting in iOS 14.0 App Tracking Transparency framework is available so we can present the app-tracking authorization request to the end user.

Starting in iOS 14.5, IDFA will be unavailable until an app calls the App Tracking Transparency framework to present the app-tracking authorization request to the end user. If an app does not present this request, the IDFA will automatically be zeroed out which may lead to a significant loss in ad revenue.

On iOS >=14.0 <14.5, tracking authorization request dialog isn't required in order to get IDFA. Keep in mind that, in those iOS versions, if you ask for it and the user rejects it you will lose access to IDFA (see tests).

This plugin lets you display App Tracking Transparency authorization request and ask for permission.

Usage

Step 1:

Make sure you update Info.plist file located in ios/Runner directory and add the NSUserTrackingUsageDescription key with a custom message describing your usage.

<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>
Step 2:

Google recommends that you should be using Google Mobile Ads SDK 7.64.0 or higher. The Google Mobile Ads SDK supports conversion tracking using Apple's SKAdNetwork, which means Google is able to attribute an app install even when IDFA is unavailable. This is a crucial step if you want to maximize your ad revenue when IDFA is not available. To enable this functionality, you will need to update the SKAdNetworkItems key with an additional dictionary in your Info.plist, check them here.

Example

In this example, the tracking authorization dialog is requested from the Home widget of the application. You can initiate this request from any StatefulWidget in your app.

// Import package
import 'package:app_tracking_transparency/app_tracking_transparency.dart';

void main() {
    runApp(MyApp());
}

class MyApp extends StatefulWidget {
    @override _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
    @override
    void  initState() {
        super.initState();
        // Show tracking authorization dialog and ask for permission
        WidgetsFlutterBinding.ensureInitialized().addPostFrameCallback((_) async { 
            final status = await AppTrackingTransparency.requestTrackingAuthorization();
        });     
    }

    @override
    Widget build(BuildContext context) {
        ...
    }
}


Google (admob) recommends implementing an explainer message that appears to users immediately before the consent dialogue. For additional info on this topic please refer to this article: https://support.google.com/admob/answer/9997589?hl=en

// If the system can show an authorization request dialog
if (await AppTrackingTransparency.trackingAuthorizationStatus ==
    TrackingStatus.notDetermined) {
  // Show a custom explainer dialog before the system dialog
  await showCustomTrackingDialog(context);
  // Wait for dialog popping animation
  await Future.delayed(const Duration(milliseconds: 200));
  // Request system's tracking authorization dialog
  await AppTrackingTransparency.requestTrackingAuthorization();
}

The explainer dialog must not contain a "Decide later" button. It should contain only a "Continue" button and the system dialog must be shown after the explainer dialog. See this issue for details.

You can also get advertising identifier after authorization. Until a user grants authorization, the UUID returned will be all zeros: 00000000-0000-0000-0000-000000000000. Also note, the advertisingIdentifier will be all zeros in the Simulator, regardless of the tracking authorization status.

final uuid = await AppTrackingTransparency.getAdvertisingIdentifier();

Notes

To use this plugin you should compile your project using XCode 12+ and run your app on an ios 14 + device.

Important Notice

IOS does not allow to display multiple native dialogs. If you try to open a native dialog when there is already a dialog on screen, previous dialog will be forcefully closed by the system. It's very common to show notification permission dialog on the first run of an ios application. If you both try to show a notification permission dialog and app tracking request dialog, one of the each will be cancelled. One way to handle this is using an explainer dialog before requesting tracking authorization. Please check the sample project for more on this. I highly recommend this approach.

Another way to get over this problem is postponing permission request until 2nd, or Nth run of the application. If you choose this way, please make sure that you inform app store reviewer that you postponed tracking request, or your submission may be rejected.

And finally; Always test on a real device with a fresh installed application.

カテゴリー

ソースリポジトリ

このパッケージを使用しているプロジェクト