Getting Started

インストール

AI-Assisted セットアップを使用してプラグインをインストールできます。AI ツールに Capgo スキルを追加するには、以下のコマンドを使用してください。

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

次に、以下のプロンプトを使用してください。

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-app-tracking-transparency` plugin in my project.

Manual Setup を好む場合は、以下のコマンドを実行してプラグインをインストールし、以下のプラットフォーム固有の説明を参照してください。

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';

ソース オブ トゥルース

プラグインの生成元のページ src/definitions.tsパブリック API がアップストリームで変更された場合に、再度同期を実行してください。

始めから始める

あなたが使用している場合 始めから始める ダッシュボードと API の計画と実行に使用する場合、 Using @capgo/capacitor-app-tracking-transparency Using @capgo/capacitor-app-tracking-transparency API オーバービュー 実装詳細については API の概要を参照してください。 概要 実装詳細については Introduction を参照してください。 API のキー 実装詳細については API のキー、 デバイス 実装詳細については Devices を参照してください。