빠르게 시작하기

1. 최소 지원 사양

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

2. SDK 연동

SDK 연동을 위해서는 우선 Flutter 용 Tapjoy 플러그인을 설치합니다.

Pub.dev

flutter pub add tapjoy_offerwall

플러그인 설치가 완료되면 Flutter 프로젝트 내 플러그인을 import 하여 사용할 수 있습니다.

import 'package:tapjoy_offerwall/tapjoy_offerwall.dart';

3. Tapjoy 연결

Tapjoy SDK를 구동하기 위해서는 우선 connect API를 호출합니다. connect API는 앱 실행 직후 호출하는 것을 권장합니다.

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 SDk 연동이 완료되면 빌드 후 애플리케이션을 실행합니다.

축하합니다! 이제 Tapjoy SDK가 여러분의 애플리케이션에서 동작하기 시작하였습니다.

Max User Level

Tapjoy에 여러분의 게임의 최대 레벨을 설정할 수 있습니다. Tapjoy.connect API 호출 전후에 해당 API를 호출해야 합니다.

Tapjoy.setMaxLevel(10);

User Segment

setUserSegmentAPI 를 통해 사용자를 분류할 수 있습니다. Tapjoy.connect API 호출 전후, 해당 API를 호출해야 합니다.

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

4. App Tracking Transparency 권한 요청

Tapjoy SDK를 연동할 앱이 App Tracking Transparency를 통해 IDFA를 사용한다면 iOS 내 info.plist "NSUserTrackingUsageDescription" 를 추가하고 메시지를 작성하여 사용자로부터 IDFA 사용권한을 받도록 합니다.

이후 app_tracking_transparency package 를 다운로드 받습니다.

flutter pub add app_tracking_transparency

패키지 설치 후 프로젝트 내 해당 패키지를 import 하면 IDFA 권한 승인 팝업이 노출됩니다.

import 'package:app_tracking_transparency/app_tracking_transparency.dart';

...

final status = await AppTrackingTransparency.requestTrackingAuthorization();

빠르게 시작하기
1. 최소 지원 사양
2. SDK 연동
3. Tapjoy 연결
4. App Tracking Transparency 권한 요청