기술 자료

지원

오퍼월

Monetization 시작하기

UA 시작하기

Unity SDK 연동

오퍼월

빠른 시작

빠른 시작 가이드에 따라 Android에서 탭조이를 초기화합니다.
읽는 시간 1분최근 업데이트: 2일 전

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에는 
play-services-ads
v17.1.0이 포함되어 있습니다. 이 버전의 
play-services-ads
에는 Google Play 가족 프로그램의 구성원을 제거해야 하는 
AD_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)를 설정합니다. 
onConnectSuccess
는 SDK가 탭조이 서버에 성공적으로 연결되었음을 나타냅니다. 성공적으로 연결되었지만 블로킹 이외 문제가 발생하면 
onConnectWarning
이 먼저 작동합니다. 현재 이 기능은 ConnectFlags에서 전송된 경우에만 UserId 관련 문제를 감지합니다. 서버에 연결할 수 없으면 
onConnectFailure
가 작동합니다. 퍼블리셔의 가장 일반적이고 유용한 2가지 연결 플래그는 TJC_OPTION_LOGGING_LEVEL과 USER_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 레퍼런스를 참고하십시오. 이제 애플리케이션을 컴파일하고 실행합니다.

최대 사용자 레벨

게임의 레벨 수를 탭조이에 제공할 수 있습니다. 이 값은 연결을 호출하기 전이나 후에 설정 가능합니다. 
Tapjoy.setMaxLevel(10);

사용자 세그먼트

setUserSegment
를 호출하여 사용자를 세그먼트의 일부로 식별할 수 있습니다. 이는 연결 호출 전이나 후에 설정할 수 있습니다. 
Tapjoy.setUserSegment(TJSegment.VIP);Tapjoy.setUserSegment(TJSegment.PAYER);Tapjoy.setUserSegment(TJSegment.NON_PAYER);Tapjoy.setUserSegment(TJSegment.UNKNOWN);