Getting Started

이 플러그인에 대한 설치 단계와 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하세요.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-app-tracking-transparency`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/app-tracking-transparency/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

설치

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

Import

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에서 native 추적 허가 대화창을 표시합니다.

주의: 이 메서드는 대화창을 한번만 표시합니다. 이후 호출은 대화창 없이 저장된 허가 상태를 반환합니다.

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

Source Of Truth

공개 __CAPGO_KEEP_0__이 업스트림에서 변경될 때 다시 싱크를 실행하세요. src/definitions.ts. Re-run the sync when the public API changes upstream.

Getting Started에서 계속하기 섹션

__CAPGO_KEEP_0__ 사용 중이라면 Getting Started API 대시보드와 API 연산을 계획하고 연결하세요. Using @capgo/capacitor-app-tracking-transparency for the native capability in Using @capgo/capacitor-app-tracking-transparency, API Overview API 소개 __CAPGO_KEEP_0__ Keys __CAPGO_KEEP_0__ Keys API 장치들에 대해 알아보세요. for the implementation detail in API Keys, and __CAPGO_KEEP_0__ __CAPGO_KEEP_0__의 구현 세부 사항입니다.