はじめに

インストール

bun add @capgo/capacitor-app-tracking-transparency
bunx cap sync

インポート

import { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';

API オーバービュー

getStatus

ユーザーに質問せずに現在のトラッキング認可状態を取得します。

import { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';

const { status } = await AppTrackingTransparency.getStatus();
if (status === 'authorized') {
  console.log('Tracking is authorized');
}

requestPermission

ユーザーにアプリ関連データのトラッキングへのアクセスを許可するよう求めます。 iOSのネイティブトラッキング許可ダイアログを表示します。

注: このメソッドは、ダイアログを一度だけ表示します。以降の呼び出しはダイアログを表示せずに、保存された認可状態を返します。

import { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';

const { status } = await AppTrackingTransparency.requestPermission();
switch (status) {
  case 'authorized':
    console.log('User authorized tracking');
    break;
  case 'denied':
    console.log('User denied tracking');
    break;
  case 'restricted':
    console.log('Tracking is restricted');
    break;
  case 'notDetermined':
    console.log('Status not determined');
    break;
}

型の参照

AppTrackingStatusResponse

トラッキング承認状態の認証情報を含むレスポンスオブジェクト。

export interface AppTrackingStatusResponse {
  /**
   * The current tracking authorization status.
   *
   * @since 1.0.0
   */
  status: AppTrackingStatus;
}

AppTrackingStatus

トラッキング承認状態の可能な値。

export type AppTrackingStatus = 'authorized' | 'denied' | 'notDetermined' | 'restricted';

ソースオブトゥルース

パブリック__CAPGO_KEEP_0__がアップストリームで変更された場合に再度同期してください。 src/definitions.ts. Re-run the sync when the public API changes upstream.