빠른 시작
빠른 시작 가이드에 따라 Android에서 탭조이를 초기화합니다.
읽는 시간 1분최근 업데이트: 4달 전
SDK 연동
Maven(권장)
Maven을 사용하면 애플리케이션 build.gradle 파일에 몇 줄을 추가하여 오퍼월을 연동할 수 있습니다.
탭조이를 사용하려면 다음을 build.gradle 파일에 추가합니다.
repositories { maven { name "Tapjoy's maven repo" url 'https://sdk.tapjoy.com/' } maven { name 'Google' url 'https://maven.google.com/' } } dependencies { implementation 'com.tapjoy:tapjoy-android-sdk:14.4.0' }
앱 권한 및 활동 추가
다음 권한이 필요합니다.
- (선택 사항)
ACCESS_WIFI_STATE
또한 앱의 매니페스트 활동에 동일한 configChanges를 추가해야 합니다.
android:configChanges="orientation|keyboardHidden|screenSize|uiMode"
이 시점에서 애플리케이션을 컴파일하고 실행하여 앱의 모든 사항이 계속 작동하는지 확인하는 것이 좋습니다. 실제로 애플리케이션의 코드에는 아무 작업도 하지 않았으므로 애플리케이션의 작동 방식에 오류나 변경 사항이 없어야 합니다.
AD_ID 및 Google Play 가족 프로그램
탭조이 12.9.0에는 v17.1.0이 포함되어 있습니다. 이 버전의 에는 Google Play 가족 프로그램의 구성원을 제거해야 하는 권한이 포함되어 있습니다.
play-services-adsplay-services-adsAD_ID매니페스트에 다음 요소를 추가하여 권한을 제외할 수 있습니다.
<uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
자세한 내용은 여기에서 확인할 수 있습니다.
탭조이에 연결
다음 단계로, 애플리케이션에 탭조이 연결 코드를 추가합니다. 이 코드의 키 비트는 애플리케이션에서 오퍼월 SDK를 ‘활성화’합니다.
참고
탭조이 연결 호출이 제대로 구현되지 않으면 탭조이의 제품이나 기능이 작동하지 않으므로 이 연결 호출은 매우 중요합니다.
탭조이 연결 호출을 구현하려면 연동하려는 애플리케이션에 오퍼월 SDK 키가 있어야 합니다. 이 키를 찾으려면 탭조이 대시보드에서 애플리케이션으로 이동하여 상단 내비게이션 바에서 ‘Settings’ 버튼을 클릭합니다. ‘App Settings’로 이동하면 페이지 하단에 SDK 키가 표시됩니다.
이제 코드를 작성해 봅니다. 활동에 탭조이 임포트:
import com.tapjoy.Tapjoy
그런 다음 주요 활동의 메서드에서 다음과 같이 탭조이에 연결합니다.
onCreate()Hashtable<String, Object> connectFlags = new Hashtable<String, Object>(); connectFlags.put(TapjoyConnectFlag.TJC_OPTION_LOGGING_LEVEL, TJLogLevel.DEBUG); // Disable this in production builds connectFlags.put(TapjoyConnectFlag.USER_ID, "USER_ID_GOES_HERE"); // Important for self-managed currencyTapjoy.connect(getContext().getApplicationContext(), "SDK_KEY_GOES_HERE", connectFlags, new TJConnectListener() { @Override public void onConnectSuccess() { } @Override public void onConnectWarning(int code, String message) { } @Override public void onConnectFailure(int code, String message) { } });
이 코드에서는 탭조이에 연결(성공, 실패, 경고 콜백 수신)하고 2개의 ‘연결 플래그’(로깅, 사용자 ID)를 설정합니다. 는 SDK가 탭조이 서버에 성공적으로 연결되었음을 나타냅니다. 성공적으로 연결되었지만 블로킹 이외 문제가 발생하면 이 먼저 작동합니다. 현재 이 기능은 ConnectFlags에서 전송된 경우에만 UserId 관련 문제를 감지합니다. 서버에 연결할 수 없으면 가 작동합니다.
onConnectSuccessonConnectWarningonConnectFailure퍼블리셔의 가장 일반적이고 유용한 2가지 연결 플래그는 TJC_OPTION_LOGGING_LEVEL과 USER_ID입니다.
디버그 빌드에서는 로깅 플래그를 사용하지만, 프로덕션용 빌드 시에는 이를 비활성화하는 것이 중요합니다.
자체 관리형 재화를 사용할 때 USER_ID 플래그 설정은 필수입니다. 연결 시 설정하면 플레이스먼트가 호출되기 전에 설정되어 잠재적인 보상 문제를 방지할 수 있으므로 중요합니다.
퍼블리셔가 운영체제에서 제공하는 다양한 Android 식별자를 탭조이에서 사용하는 방식을 제어하는 데 도움이 되는 몇 가지 연결 플래그는 다음과 같습니다.
플래그 | 설명 | 참고 |
|---|---|---|
| 이 플래그가 설정되어 있으면 오퍼월 SDK는 광고 ID를 사용할 수 없는 경우 광고 목적으로 영구 ID를 사용합니다. | 이는 SDK 버전 12.2.1 이상에서 지원됩니다. |
| 기본적으로 탭조이의 Android SDK는 Google 광고 식별자가 있는지 확인하며, 이를 찾지 못하면 초기화를 수행하지 못합니다. 이 플래그를 설정하면 오퍼월 SDK가 Google 광고 식별자가 없더라도 초기화할 수 있도록 이 확인을 비활성화할 수 있습니다. | 이는 Google Play가 아닌 앱 스토어에서 릴리스할 빌드를 만들 때와 같이 앱에 Google Play 서비스가 없는 경우에 유용합니다. |
모든 연결 플래그에 관한 설명은 Java SDK 레퍼런스를 참고하십시오.
이제 애플리케이션을 컴파일하고 실행합니다.
최대 사용자 레벨
게임의 레벨 수를 탭조이에 제공할 수 있습니다. 이 값은 연결을 호출하기 전이나 후에 설정 가능합니다.
Tapjoy.setMaxLevel(10);
사용자 세그먼트
setUserSegmentTapjoy.setUserSegment(TJSegment.VIP);Tapjoy.setUserSegment(TJSegment.PAYER);Tapjoy.setUserSegment(TJSegment.NON_PAYER);Tapjoy.setUserSegment(TJSegment.UNKNOWN);