기술 자료

지원

수동 연동

.aar 파일을 다운로드하고 프로젝트의 libs 폴더에 추가하고 탭조이와 Google Play 서비스로 Gradle 종속성을 업데이트하여 탭조이 Android SDK를 수동으로 연동할 수 있습니다.
읽는 시간 1분최근 업데이트: 2일 전

SDK 다운로드

수동으로 SDK를 연동하려면 첫 단계로 Android SDK를 다운로드합니다.

SDK를 프로젝트에 추가합니다

SDK 압축을 풀면 문서, 라이브러리, TapjoyEasyApp을 확인할 수 있습니다.
  1. 프로젝트의 /lib 폴더에
    tapjoyconnectlibrary.aar
    파일을 복사합니다. 폴더가 없으면 먼저 폴더를 생성합니다.
  2. 애플리케이션의 build.gradle에 탭조이를 추가합니다.
dependencies { implementation files('libs/tapjoyconnectlibrary.aar')}
  1. 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-ads
v17.1.0에는 Google Play 가족 프로그램의 구성원을 제거해야 하는
AD_ID
권한이 포함되어 있습니다.
매니페스트에 다음 요소를 추가하여 권한을 제외할 수 있습니다.
<uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
자세한 내용은 광고 ID에 관한 Play Console 도움말 기술 자료를 참고하십시오.

JAR 연동

AAR 대신 JAR 옵션을 사용하는 경우 다음 권한과 활동도 필요합니다.
  • INTERNET
  • ACCESS_NETWORK_STATE
<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"/>
현재 SDK 버전에서 탭조이의 모든 기능을 사용하려면 애플리케이션 블록의
AndroidManifest.xml
파일에 다음 활동을 추가합니다.
<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" />
또한 앱의 매니페스트 활동에 동일한 configChanges를 추가해야 합니다.
android:configChanges="orientation|keyboardHidden|screenSize|uiMode"
이 시점에서 애플리케이션을 컴파일하고 실행하여 앱의 모든 사항이 계속 작동하는지 확인하는 것이 좋습니다. 실제로 애플리케이션의 코드에는 아무 작업도 하지 않았으므로 애플리케이션의 작동 방식에 오류나 변경 사항이 없어야 합니다.

탭조이에 연결

다음 단계로, 애플리케이션에 탭조이 연결 코드를 추가합니다. 이 코드의 키 비트는 애플리케이션에서 오퍼월 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 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() { } });
이 코드에서는 탭조이에 연결(성공, 실패, 경고 콜백 수신)하고 2개의 ‘연결 플래그’(로깅, 사용자 ID)를 설정합니다.
onConnectSuccess
는 SDK가 탭조이 서버에 성공적으로 연결되었음을 나타냅니다. 성공적으로 연결되었지만 블로킹 이외 문제가 발생하면
onConnectWarning
이 먼저 작동합니다. 현재 이 기능은 ConnectFlags에서 전송된 경우에만 UserId 관련 문제를 감지합니다. 서버에 연결할 수 없으면
onConnectFailure
가 작동합니다.
퍼블리셔의 가장 일반적이고 유용한 2가지 연결 플래그는 ENABLE_LOGGINGUSER_ID입니다. 디버그 빌드에서는 로깅 플래그를 사용하지만, 프로덕션용 빌드 시에는 이를 비활성화하는 것이 중요합니다. 자체 관리형 재화를 사용할 때 USER_ID 플래그 설정은 필수입니다. 연결 시 설정하면 플레이스먼트가 호출되기 전에 설정되어 잠재적인 보상 문제를 방지할 수 있으므로 중요합니다. 퍼블리셔가 운영체제에서 제공하는 다양한 Android 식별자를 탭조이에서 사용하는 방식을 제어하는 데 도움이 되는 몇 가지 연결 플래그는 다음과 같습니다.

플래그

설명

참고

ALLOW_LEGACY_ID_FALLBACK
이 플래그가 설정되어 있으면 오퍼월 SDK는 광고 ID를 사용할 수 없는 경우 광고 목적으로 영구 ID를 사용합니다.이는 SDK 버전 12.2.1 이상에서 지원됩니다.
DISABLE_ADVERTISING_ID_CHECK
기본적으로 탭조이의 Android SDK는 Google 광고 식별자가 있는지 확인하며, 이를 찾지 못하면 초기화를 수행하지 못합니다. 이 플래그를 설정하면 오퍼월 SDK가 Google 광고 식별자가 없더라도 초기화할 수 있도록 이 확인을 비활성화할 수 있습니다.이는 Google Play가 아닌 앱 스토어에서 릴리스할 빌드를 만들 때와 같이 앱에 Google Play 서비스가 없는 경우에 유용합니다.
모든 연결 플래그에 관한 설명은 Java SDK 레퍼런스를 참고하십시오. 이제 애플리케이션을 컴파일하고 실행합니다. 탭조이 대시보드의 상단 내비게이션 바에서 ‘Analytics’를 클릭한 다음, 왼쪽 내비게이션 바에서 ‘Real-time’ 탭을 클릭하면 애플리케이션 실행 직후에 애플리케이션의 활동이 표시됩니다.