수동 연동
.aar 파일을 다운로드하고 프로젝트의 libs 폴더에 추가하고 탭조이와 Google Play 서비스로 Gradle 종속성을 업데이트하여 탭조이 Android SDK를 수동으로 연동할 수 있습니다.
읽는 시간 1분최근 업데이트: 2일 전
SDK 다운로드
수동으로 SDK를 연동하려면 첫 단계로 Android SDK를 다운로드합니다.SDK를 프로젝트에 추가합니다
SDK 압축을 풀면 문서, 라이브러리, TapjoyEasyApp을 확인할 수 있습니다.- 프로젝트의 /lib 폴더에 파일을 복사합니다. 폴더가 없으면 먼저 폴더를 생성합니다.
tapjoyconnectlibrary.aar - 애플리케이션의 build.gradle에 탭조이를 추가합니다.
dependencies { implementation files('libs/tapjoyconnectlibrary.aar')}
- build.gradle에 Google Play 서비스를 추가합니다.
repositories { maven { url 'https://maven.google.com/' name 'Google' }}
dependencies { implementation 'com.google.android.gms:play-services-ads-identifier:17.1.0'}
앱 권한 및 활동 추가
다음 권한이 필요합니다.- (선택 사항)
ACCESS_WIFI_STATE
AD_ID 및 Google Play 가족 프로그램
play-services-adsAD_ID자세한 내용은 광고 ID에 관한 Play Console 도움말 기술 자료를 참고하십시오.<uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
JAR 연동
AAR 대신 JAR 옵션을 사용하는 경우 다음 권한과 활동도 필요합니다.INTERNETACCESS_NETWORK_STATE
현재 SDK 버전에서 탭조이의 모든 기능을 사용하려면 애플리케이션 블록의<uses-permission android:name="android.permission.INTERNET"/><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/><uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
AndroidManifest.xml또한 앱의 매니페스트 활동에 동일한 configChanges를 추가해야 합니다.<activity android:name="com.tapjoy.TJAdUnitActivity" android:configChanges="orientation|keyboardHidden|screenSize|uiMode" android:theme="@style/TranslucentTheme" android:enableOnBackInvokedCallback="true" android:hardwareAccelerated="true" tools:ignore="UnusedAttribute" /><activity android:name="com.tapjoy.TJWebViewActivity" android:configChanges="orientation|keyboardHidden|screenSize|uiMode" android:theme="@style/TranslucentTheme" android:enableOnBackInvokedCallback="true" android:hardwareAccelerated="true" tools:ignore="UnusedAttribute" />
이 시점에서 애플리케이션을 컴파일하고 실행하여 앱의 모든 사항이 계속 작동하는지 확인하는 것이 좋습니다. 실제로 애플리케이션의 코드에는 아무 작업도 하지 않았으므로 애플리케이션의 작동 방식에 오류나 변경 사항이 없어야 합니다.android:configChanges="orientation|keyboardHidden|screenSize|uiMode"
탭조이에 연결
다음 단계로, 애플리케이션에 탭조이 연결 코드를 추가합니다. 이 코드의 키 비트는 애플리케이션에서 오퍼월 SDK를 ‘활성화’합니다.
탭조이 연결 호출을 구현하려면 연동하려는 애플리케이션에 오퍼월 SDK 키가 있어야 합니다. 이 키를 찾으려면 탭조이 대시보드에서 애플리케이션으로 이동하여 상단 내비게이션 바에서 ‘Settings’ 버튼을 클릭합니다. ‘App Settings’로 이동하면 페이지 하단에 SDK 키가 표시됩니다.
이제 코드를 작성해 봅니다. 활동에 탭조이 임포트:
그런 다음 주요 활동의import com.tapjoy.Tapjoy
onCreate()이 코드에서는 탭조이에 연결(성공, 실패, 경고 콜백 수신)하고 2개의 ‘연결 플래그’(로깅, 사용자 ID)를 설정합니다.Hashtable<String, Object> connectFlags = new Hashtable<String, Object>();connectFlags.put(TapjoyConnectFlag.TJC_OPTION_LOGGING_LEVEL, TJLogLevel.DEBUG); // Disable this in production buildsconnectFlags.put(TapjoyConnectFlag.USER_ID, "USER_ID_GOES_HERE"); // Important for self-managed currencyTapjoy.connect(getApplicationContext(), "SDK_KEY_GOES_HERE", connectFlags, new TJConnectListener() { @Override public void onConnectSuccess() { } @Override public void onConnectWarning(int code, String message) { } @Override public void onConnectFailure() { } });
onConnectSuccessonConnectWarningonConnectFailure플래그 | 설명 | 참고 |
|---|---|---|
| 이 플래그가 설정되어 있으면 오퍼월 SDK는 광고 ID를 사용할 수 없는 경우 광고 목적으로 영구 ID를 사용합니다. | 이는 SDK 버전 12.2.1 이상에서 지원됩니다. |
| 기본적으로 탭조이의 Android SDK는 Google 광고 식별자가 있는지 확인하며, 이를 찾지 못하면 초기화를 수행하지 못합니다. 이 플래그를 설정하면 오퍼월 SDK가 Google 광고 식별자가 없더라도 초기화할 수 있도록 이 확인을 비활성화할 수 있습니다. | 이는 Google Play가 아닌 앱 스토어에서 릴리스할 빌드를 만들 때와 같이 앱에 Google Play 서비스가 없는 경우에 유용합니다. |