# クイックスタート

> Tapjoy を Flutter に設定するには、プラグインをインポートし、SDK キーを加え、アプリで初期化します。これにより、プレースメントのリクエストをすばやく開始できます。

## 最小要件##minimum-requirements

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

## SDK のインテグレーション##sdk-integration

アプリと統合する最初のステップは、Tapjoy Flutter プラグインをインストールすることです。

### Pub.dev##pub.dev

```zsh
flutter pub add tapjoy_offerwall
```

#### Offerwall Maven リポジトリを加える (Android)##add-the-offerwall-maven-repository-(android)

Offerwall Maven リポジトリと Offerwall 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'
}
```

その後、Tapjoy をアプリケーションにインポートしてプラグインを使用できます。

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

## Tapjoy への接続##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 {

    });
```

Tapjoy の設定が完了したら、アプリケーションをビルドして実行できます。

### ロギング##logging

以下の方法を使用して、ロギングレベルを取得および設定できます。

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

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

### 最大ユーザーレベル##max-user-level

Tapjoy にゲーム内のレベル数を伝えることができます。この値は、connect を呼び出す前または後に設定できます。

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

### ユーザーセグメント##user-segment

`setUserSegment` を呼び出すことで、ユーザーをセグメントの一部として識別できます。これは connect を呼び出す前または後に設定できます。

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

## App Tracking Transparency 承認のリクエスト##request-app-tracking-transparency-authorization

アプリケーションが [App Tracking Transparency](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();
```