# 빠른 시작

> 플러그인을 임포트하고 SDK 키를 추가하고 이를 앱에서 초기화하여 Flutter에서 탭조이를 설정하면 플레이스먼트를 빠르게 요청할 수 있습니다.

## 최소 요구 사항##minimum-requirements

* Flutter: 3.3.0
* Dart: 3.0.0
* iOS: 13.0
* Android: 5.0(API 21)

## SDK 연동##sdk-integration

탭조이 Flutter 플러그인을 설치하는 것이 앱과 연동하는 첫 번째 단계입니다.

### Pub.dev##pub.dev

```zsh
flutter pub add tapjoy_offerwall
```

#### 오퍼월 Maven 저장소 추가(Android)##add-the-offerwall-maven-repository-(android)

오퍼월 Maven 저장소와 오퍼월 SDK 종속성을 android/app/build.gradle 파일에 추가합니다.

```java
repositories {
    maven {
        name "Tapjoy's maven repo"
        url "https://sdk.tapjoy.com/"
    }
}

dependencies {
    implementation 'com.tapjoy:tapjoy-android-sdk:14.4.0'
}
```

그런 다음 탭조이를 애플리케이션으로 임포트하여 플러그인을 사용할 수 있습니다.

```dart
import 'package:tapjoy_offerwall/tapjoy_offerwall.dart';
```

## 탭조이에 연결##connect-to-tapjoy

연결 호출은 Offerwall SDK를 초기화하는 방법입니다. 앱 실행 후 가능한 한 빨리 수행합니다.

```dart
final Map<String, dynamic> optionFlags = {};

Tapjoy.connect(
    sdkKey:
        'SDK_KEY',
    options: optionFlags,
    onConnectSuccess: () async {

    },
    onConnectFailure: (int code, String? error) async {

    },
    onConnectWarning: (int code, String? warning) async {

    });
```

탭조이 설정을 마치면 애플리케이션을 빌드하고 실행할 수 있습니다.

### 로깅##logging

다음 메서드를 사용하여 로깅 레벨을 가져오고 설정할 수 있습니다.

```dart
// Set logging level
Tapjoy.setLoggingLevel(TJLoggingLevel.debug)

// Get logging level
var loggingLevel = await Tapjoy.getLoggingLevel();
```

### 최대 사용자 레벨##max-user-level

게임의 레벨 수를 탭조이에 제공할 수 있습니다. 이 값은 연결을 호출하기 전이나 후에 설정 가능합니다.

```dart
Tapjoy.setMaxLevel(10); 
```

### 사용자 세그먼트##user-segment

`setUserSegment`를 호출하여 사용자를 세그먼트의 일부로 식별할 수 있습니다. 이는 연결 호출 전이나 후에 설정할 수 있습니다.

```dart
Tapjoy.setUserSegment(TJSegment.nonPayer);
Tapjoy.setUserSegment(TJSegment.payer);
Tapjoy.setUserSegment(TJSegment.vip);
Tapjoy.setUserSegment(TJSegment.unknown);
```

## 앱 트래킹 투명성 승인 요청##request-app-tracking-transparency-authorization

애플리케이션이 [앱 트래킹 투명성](https://developer.apple.com/documentation/apptrackingtransparency)을 사용하도록 설계된 경우 IDFA에 대한 액세스 권한을 요청하는 다이얼로그를 표시하려면 애플리케이션에서 IDFA 사용 권한을 설명하는 커스텀 메시지와 함께 NSUserTrackingUsageDescription 키를 포함하여 Info.plist를 업데이트합니다.

다음으로 `app_tracking_transparency` [패키지](https://pub.dev/packages/app_tracking_transparency)를 설치합니다.

```zsh
flutter pub add app_tracking_transparency
```

라이브러리를 임포트한 다음 권한 다이얼로그를 표시합니다.

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

...

final status = await AppTrackingTransparency.requestTrackingAuthorization();
```