기술 자료

지원

오퍼월

Monetization 시작하기

UA 시작하기

Unity SDK 연동

오퍼월

변경 기록

Unity 플러그인 변경 기록을 확인하여 로깅 개선 사항, 종속성 관리 변경 사항 등 최신 업데이트를 계속 확인합니다.
읽는 시간 3분최근 업데이트: 2일 전

14.6.0(2025년 11월 20일)

  • 레퍼런스로 JSONSerializeModule 추가
  • 내부적인 개선 사항
  • iOS와 Android 버전에서 상속된 버그가 해결되었습니다.

14.5.0(2025년 10월 10일)

  • TJActionRequest가 사용 중단 예정입니다.
  • 이제 External Dependency Manager에서 UPM을 사용합니다. 에셋이 아니라 패키지로 설치됩니다.

14.4.0(2025년 6월 3일)

  • 로깅 개선 사항: 
    • SetLoggingLevel
      과 
      GetLoggingLevel
      메서드가 추가되었습니다.
    • 탭조이 창에 로깅 레벨을 선택하는 옵션이 추가되었습니다.
    • SetDebugEnabled
      메서드가 사용 중단 예정입니다.
  • 패키지에서 External Dependency Manager가 제거되었습니다. 이제 포함되지 않은 경우 스크립트를 사용하여 임포트합니다.
  • 패키지의 ‘manifest.json’ 샘플에서 중복된 종속성이 제거되었습니다.

14.3.1(2025년 4월 25일)

  • iOS와 Android 버전에서 상속된 버그가 해결되었습니다.

14.3.0(2025년 4월 7일)

  • 프로젝트에 아직 없는 경우 External Dependency Manager를 자동으로 추가합니다.
  • EasyApp에 UnityAds가 추가되었습니다.
  • EasyApp에 구매와 재화 값 입력이 추가되었습니다.
  • EasyApp UI에 OptOutAdvertisingId 토글이 추가되었습니다.
  • iOS와 Android 버전에서 상속된 버그가 해결되었습니다.

14.2.1(2024년 12월 9일)

  • 버전 번호를 높였습니다.

14.2.0(2024년 12월 4일)

  • TJPlacement didClick 콜백이 사용 중단 예정입니다.
  • getSupportUrl이 사용 중단 예정입니다.
  • External Dependency Manager가 v1.2.183으로 업데이트되었습니다.
  • iOS와 Android 버전에서 상속된 버그가 해결되었습니다.

14.1.1(2024년 10월 15일)

  • Android 버전에서 상속된 버그가 해결되었습니다.

14.1.0(2024년 10월 2일)

  • External Dependency Manager가 1.2.180으로 업데이트되었습니다.
  • PPE가 사용 중단 예정입니다.
  • EasyApp plist에 NSUserTrackingUsageDescription이 추가되었습니다.
  • OnSetUserIdFailureHandler가 사용 중단 예정입니다.
  • 과도한 로깅 문제가 해결되었습니다.
  • 불필요한 BuildPostProcess 스크립트가 제거되었습니다.
  • iOS와 Android 버전에서 상속된 버그가 해결되었습니다.

14.0.1(2024년 7월 16일)

  • iOS 버전에서 상속된 버그가 해결되었습니다.

14.0.0(2024년 7월 1일)

  • 오퍼월 상단에 표시되는 내비게이션 메뉴 관련 문제가 해결되었습니다.
  • 사용 중단 예정인 푸시 알림 인터페이스가 제거되었습니다.
  • 사용 중단 예정인 UserCohortVariables 인터페이스가 제거되었습니다.
  • 사용 중단 예정인 CustomEvents 인터페이스가 제거되었습니다.
  • 사용 중단 예정인 PrivacyPolicy 인터페이스가 제거되었습니다.
  • 사용 중단 예정인 UserFriendCount 인터페이스가 제거되었습니다.
  • 사용 중단 예정인 connectFailure 핸들러가 제거되었습니다.
  • 기존의 
    trackPurchase
    메서드는 사용 중단 예정이고, 파라미터가 적은 새로운 
    trackPurchase
    메서드가 추가되었습니다.
  • UserId getter 
    Tapjoy.GetUserID()
    가 추가되었습니다.
  • 사용자 레벨 getter 
    Tapjoy.GetUserLevel()
    이 추가되었습니다.
  • 이제 플러그인이 DLL 대신 소스 코드로 공유됩니다.
  • 내비게이션 메뉴로 가려지는 EasyApp 사용자 프로퍼티 UI 문제가 해결되었습니다.
  • 일부 Android 디바이스에서 EasyApp UI가 노치로 가려지는 문제가 해결되었습니다.
  • EasyApp에서 복수 행 로그 메시지 지원이 활성화되었습니다.
  • iOS와 Android 버전에서 상속된 버그가 해결되었습니다.

알려진 문제

  • 오퍼월 SDK 인증서가 만료되었다는 메시지가 표시되면 캐시를 지우거나 최신 SDK로 업데이트해야 할 수 있습니다. 자세한 내용은 수익화 FAQ를 참고하십시오.

13.4.1(2024년 3월 19일)

  • iOS 버전에서 상속된 버그가 해결되었습니다.

13.4.0(2024년 3월 4일)

  • connectWarning
    콜백이 추가되었습니다.
  • EasyApp이 개선되었습니다.
  • 푸시 알림이 제거되었습니다.

13.3.0(2023년 11월 30일)

  • iOS와 Android 버전에서 상속된 버그가 해결되었습니다.

13.2.1(2023년 10월 5일)

  • iOS 버전에서 상속된 버그가 해결되었습니다.

13.2.0(2023년 9월 27일)

  • 최대 사용자 레벨을 설정하는 새로운 API가 추가되었습니다.
  • 사용자 세그먼트를 설정하는 새로운 API가 추가되었습니다.
  • 재화 잔액을 설정하는 새로운 API가 추가되었습니다. (자체 관리형만 해당)
  • 통화 수요를 설정하는 새로운 API가 추가되었습니다.
  • 플레이스먼트 엔트리 포인트를 설정하는 새로운 API가 추가되었습니다.
  • 이제 연결 실패 콜백에 오류 메시지가 반환됩니다.
  • External Dependency Manager가 v1.2.176으로 업데이트되었습니다.
  • 동영상 메서드/콜백 지원이 사용 중단 예정입니다.
  • 푸시 알림 지원이 사용 중단 예정입니다.
  • 이제 iOS PostBuildScript 코드를 플랫폼에 래핑합니다.
  • iOS와 Android 버전에서 상속된 버그가 해결되었습니다.

13.1.2(2023년 7월 14일)

  • Android 버전에서 상속된 버그가 해결되었습니다.

13.1.1(2023년 6일 30일)

  • Android 버전에서 상속된 버그가 해결되었습니다.

13.1.0(2023년 6월 28일)

  • 개인정보 처리방침 인터페이스가 업데이트되었습니다.
  • EasyAPP UI에 개인정보 처리방침 설정이 추가되었습니다.
  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

13.0.1(2023년 4월 18일)

  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

13.0.0(2023년 4월 6일)

  • 이제 탭조이 씬(scene)을 추가할 때 GameObject가 자동으로 포함됩니다.
  • 이제 플러그인 파일이 단일 위치에 저장됩니다.
  • EasyApp 관련 문제가 해결되었습니다.
  • 사용 중단 예정인 개인정보 보호 인터페이스가 제거되었습니다. 대신 TJPrivacyPolicy를 사용하십시오.
  • 사용 중단 예정인 디스플레이 멀티플라이어 인터페이스가 제거되었습니다.
  • 사용 중단 예정인 AppDataVersion 인터페이스가 제거되었습니다.
  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

12.11.1(2022년 12월 1일)

  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

12.11.0(2022년 10월 7일)

  • Bitcode는 기본적으로 비활성화되어 있습니다. 탭조이 창에서 Bitcode를 활성화할 수 있습니다.
  • External Dependency Manager가 업데이트되었습니다.
  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

12.10.0(2022년 5월 3일)

  • Android 광고 ID 동의 지원이 추가되었습니다.
  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

12.9.1(2022년 3월 16일)

  • 탭조이 Unity 창에서 GCM 전송자 ID를 제거했습니다.
  • setGCMSender API를 제거했습니다.
  • Android 12 디바이스에서 푸시 알림은 아직 정식 지원되지 않습니다(알려진 문제 - targetSDK 31 앱: 푸시를 클릭해도 앱이 실행되지 않음).
  • Play Store PendingIntent 관련 경고가 해결되었습니다.
  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

12.9.0(2022년 1월 13일)

  • 이제 
    TapjoySettings
    에 대한 커스텀 디렉토리 사용을 지원합니다.
  • 이제 
    TapjoyUnityInit.cs
    에 대한 커스텀 디렉토리 사용을 지원합니다.
  • Xcode 프로젝트를 수정한 포스트 프로세스 빌드 파일이 제거되었습니다.
  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

알려진 문제

  • External Dependency Manager 문제로 인해 일부 Unity 버전에서는 pod가 올바르게 설치되지 않습니다. External Dependency Manager를 최신 버전으로 업데이트하여 이 문제를 해결할 수 있습니다.

12.8.1(2021년 5월 25일)

12.8.0(2021년 3월 16일)

12.7.1(2020년 11월 2일)

  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

12.7.0(2020년 9월 16일)

  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

12.6.1(2020년 7월 9일)

  • Unity 2019.3에서 UnityFramework.h가 main.mm으로 익스포트된 Unity 프로젝트로 인식되지 않는 문제가 수정되었습니다.

12.6.0(2020년 6월 29일)

  • 이 릴리스에는 퍼블리셔가 CCPA(캘리포니아 소비자 개인정보 보호법)를 준수하는 데 도움이 되는 기능이 있습니다. 각 플랫폼(iOS, Android, Unity, C++)에는 모든 개인정보 보호 플래그(GDPR, 사용자 동의, 동의 연령 미만, 미국 개인정보 보호)를 관리할 수 있는 새로운 TJPrivacyPolicy 클래스가 있습니다.
이전 버전의 오퍼월 SDK에서 업데이트하고 이전 메서드를 사용하여 개인정보 보호 값을 설정한 경우 새 SDK에서 여전히 이전에 설정한 값을 읽을 수 있으므로 수동으로 다시 설정할 필요가 없습니다. 하지만 이 새로운 메서드를 사용하려면 코드를 마이그레이션하는 것을 권장합니다.
  • GDPR, 미국 개인정보 보호, 동의, 동의 연령 미만을 한 곳에서 처리하기 위한 새로운 TJPrivacyPolicy 클래스가 추가되었습니다.
  • 기존 GDPR, 사용자 동의, 동의 연령 미만 API가 사용 중단 예정입니다.
  • 기존 GDPR, 사용자 동의, 동의 연령 미만 API가 사용 중단 예정입니다.

12.4.2(2020년 2월 7일)

  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

12.4.1(2020년 1월 7일)

  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

12.4.0(2019년 12월 4일)

  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

12.3.4(2019년 10월 9일)

  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

12.3.3(2019년 9월 20일)

  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

12.3.2(2019년 9월 16일)

  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.
  • TapjoyAndroidManifest.xml의 UnityPlayerActivity가 업데이트되었습니다.

12.3.1(2019년 6월 6일)

  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다(iOS와 Android 섹션에서 언급된 추가 동영상 성능 개선 사항 포함).

12.3.0(2019년 5월 28일)

  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다(iOS와 Android 섹션에서 언급된 동영상 성능 개선 사항 포함).
  • onClickHandler가 추가되었습니다. 이 콜백은 백엔드 서버 지원이 마련되기 전까지는 실제로 호출되지 않습니다. 해당 지원은 2019년 6월 중순경 시작될 예정입니다.
public delegate void OnClickHandler(TJPlacement placement);

12.2.1(2019년 3월 14일)

  • iOS와 Android 버전에서 상속된 버그와 기능이 수정되었습니다.

12.2.0(2018년 11월 13일)

이 릴리스는 퍼블리셔가 COPPA(아동 온라인 프라이버시 보호법) 규정을 준수하면서 사용자 기반을 수익화하는 데 도움이 되는 사용자의 동의 연령 미만 플래그를 추가합니다. 이 함수를 구현하는 것은 퍼블리셔의 책임이며, 오퍼월 SDK가 애플리케이션에 연동될 때 자동으로 구현되지 않으니 참고하시기 바랍니다. COPPA, 기타 관련 법률, 규정을 전체적으로 준수하는 것은 퍼블리셔의 책임입니다. 미국에서 COPPA(아동 온라인 프라이버시 보호법)는 (a) 연결된 사용자가 13세 미만의 아동임을 실제로 알고 있거나 (b) 13세 미만의 아동을 대상으로 하는 서비스(앱 포함)를 운영하는 온라인 서비스 운영자에게 특정 요구 사항을 부과합니다. 마찬가지로 GDPR은 해당 지역의 온라인 동의에 대한 최소 연령(멤버 국가별로 설정된 13~16세) 미만인 데이터 주체와 관련하여 특정 요구 사항을 부과합니다. 13세 미만 아동을 대상으로 하지 않지만, 여전히 최소 연령 미만인 것으로 알려진 소수의 사용자가 있는 애플리케이션의 경우 이 메서드를 활용하여 탭조이의 수익화 기능에 액세스합니다. 이 메서드는 사용자 문맥 광고만 표시하는 탭조이의 경우 ad_tracking_enabled를 false로 설정합니다. 이 사용자에 대한 광고 트래킹은 수행되지 않습니다. 
public static void BelowConsentAge(bool isBelowConsentAge);
  • 이 값을 TRUE로 설정하면 오퍼월 SDK는 해당 설정이 켜져 있으면 사용자를 광고 개인화 거부 switch (Android) , 광고 트래킹 제한으로 취급합니다. switch (iOS) in their settings is on. This means they will still see Tapjoy ads, but the ads will not be targeted based on user behavior, and the user's ad behavior will not be tracked by Tapjoy.
  • iOS와 Android 버전에서 상속된 버그가 해결되었습니다.

12.1.0(2018년 10월 11일)

  • SDK는 현재 FCM(Firebase Cloud Messaging)을 지원합니다. 이전 GCM(Google Cloud Messaging) 시스템을 사용하는 앱은 결국 이 시스템이 Android 요구 사항이 되므로 FCM으로 업데이트해야 합니다. FCM을 탭조이와 함께 사용하는 설명은 Unity 퍼블리셔를 위한 시작 가이드에서 확인할 수 있습니다.
  • 이제 탭조이의 Unity 플러그인이 iOS의 Unity 프로젝트 순환 설정을 준수합니다.
  • iOS와 Android 버전에서 상속된 버그가 해결되었습니다.

12.0.0(2018년 6월 26일)

이 릴리스는 iOS 12, Android 9 Pie와 호환됩니다.
  • iOS와 Android SDK 업데이트의 모든 문제와 기능이 수정되었습니다.
  • Bitcode의 최근 업데이트로 인해 이 버전의 iOS 빌드에는 Xcode 9.3 이상 버전을 사용해야 합니다.

11.12.2(2018년 5월 18일)

이 릴리스에는 퍼블리셔가 일반 데이터 보호 규정(GDPR)을 준수하는 데 도움이 되는 기능이 포함됩니다. 각 플랫폼(iOS, Android, Unity, AIR)에는 2가지 새로운 기능이 있습니다. 탭조이는 정당한 관심을 기반으로 GDPR을 준수하므로 다음 기능은 필수가 아닙니다. 하지만 이러한 기능은 탭조이에 동의 정보를 전달하려는 퍼블리셔를 고려해 제공됩니다. 퍼블리셔가 이러한 기능을 구현하고 사용자가 동의하지 않으면 탭조이는 관심 기반이 아닌 콘텐츠를 해당 사용자에게 제공합니다. 다음 함수는 애플리케이션이 탭조이 Connect 함수를 호출하기 전에 호출할 수 있으며, 애플리케이션이 탭조이에서 콘텐츠를 요청하기 전에 호출해야 합니다. setUserConsent 함수는 
0
(사용자가 동의하지 않음), 
1
(사용자가 동의함) 또는 더 상세한 동의 문자열을 사용합니다. 더 자세한 문자열은 IAB에서 지원하는 투명성과 동의 프레임워크에서 설명하는 동의 문자열입니다. 경우에 따라 YES/TRUE(사용자가 GDPR 규정의 적용 대상인 경우)나 NO/FALSE(사용자가 GDPR 규정의 적용 대상이 아닌 경우)로 설정할 수 있는 GDPR 적용 대상 플래그입니다. 이 함수는 애플리케이션에서 GDPR이 사용자에게 적용되는지 여부에 대해 직접 확인한 경우에만 호출되어야 합니다. 이 함수가 호출되지 않으면 탭조이는 애플리케이션이 이 확인을 완료하지 않았다고 가정하고, 탭조이에서 자체적으로 GDPR 적용 여부를 확인합니다.

GDPR 관련 자주 묻는 질문

예. 위에 나열된 함수는 관심 기반 광고용으로 설계되었으며, 관심 기반 광고에 대한 사용자 동의 상태를 탭조이에 전송합니다. 따라서 동의 상태는 오퍼월 SDK가 SDK 초기화나 광고 요청 중에 광고 식별자를 전송하는 것을 비활성화하지 않습니다.탭조이의 규정 준수에 대한 법적 근거는 ‘정당한 관심’입니다. 그러나 퍼블리셔의 규정 준수에 대한 법적 근거, 즉 광고주 식별자 수집 관련 요구 사항은 탭조이의 법적 근거와 다를 수 있습니다.애플리케이션의 규정 준수 요구 사항에 따라 오퍼월 SDK를 초기화할지 여부를 확인하는 것은 애플리케이션에 달려 있습니다. 예를 들어 애플리케이션의 광고 식별자 수집에 대한 합법적 근거가 동의이고 사용자가 동의하지 않은 경우 오퍼월 SDK를 해당 사용자를 대상으로 초기화해서는 안 됩니다.

오퍼월 SDK는 사용자가 GDPR의 적용 대상인지 여부를 확인하는 앱 내 메서드가 없는 애플리케이션을 비롯하여 다양한 유형의 애플리케이션을 유연하게 처리할 수 있도록 지원합니다. 따라서 애플리케이션에서 확인할 수 없으면(예: subjectToGDPR 함수가 호출되지 않음) 탭조이 서버에서 사용자가 GDPR의 적용 대상인지 확인합니다. 그런 다음 탭조이는 GDPR이 적용된 사용자를 통해 유입되는 탭조이의의 광고 요청에 대해서만 사용자의 동의 환경 설정을 따릅니다.목적이 모든 국가의 사용자가 GDPR이 적용되는 것처럼 동의를 철회할 수 있는 옵션을 제공하는 것이면 모든 비동의 사용자에 대해 subjectToGDPR 메서드를 TRUE로 호출하여 이 작업을 수행할 수 있습니다. 이 경우 탭조이의 서버는 subjectToGDPR 메서드 호출의 콘텐츠를 준수하며, 사용자가 GDPR의 적용 대상인지를 직접 확인하지 않습니다. 또한 퍼블리셔는 support@tapjoy.com에 문의하여 GDPR의 적용 여부와 관계없이 탭조이가 애플리케이션을 사용하는 모든 사용자의 동의 환경 설정을 준수해 줄 것을 요청할 수 있습니다.
추가 내역:public static void SetUserConsent(string value);Example: //User consent string generated according to consent string guidelines Tapjoy.SetUserConsent("BOEFEAyOEFEAyAHABDENAI4AAAB9vABAASA");public static void SubjectToGDPR(bool gdprApplicable);Example:Tapjoy.SubjectToGDPR(true); // This user is subject to GDP
  • Unity에서 GDPR 설정을 초기 탭조이 Connect 호출에 적용하려면 탭조이 UI에서 자동 연결 해제를 설정하고 직접 코드에서 수동으로 탭조이 Connect 호출을 수행합니다. 그렇지 않으면 GDPR 설정이 적용되기 전에 탭조이 Connect 호출이 이루어집니다.
  • Bitcode의 최근 업데이트로 인해 이 버전의 iOS 빌드에는 Xcode 9.3 이상 버전을 사용해야 합니다.

11.12.1(2018년 4월 30일)

  • iOS와 Android SDK 업데이트의 모든 문제와 기능이 수정되었습니다.
  • Bitcode의 최근 업데이트로 인해 이 버전의 iOS 빌드에는 Xcode 9.3 이상 버전을 사용해야 합니다.

11.12.0(2018년 3월 29일)

  • Unity Android용 빌드 시 표시되는 잘못된 
    Error while downloading Asset Bundle
    오류 메시지가 제거되었습니다.
  • iOS와 Android SDK 업데이트의 모든 문제와 기능이 수정되었습니다.