기술 자료

지원

오퍼월

Monetization 시작하기

UA 시작하기

Unity SDK 연동

오퍼월

오퍼월 마이그레이션 가이드

앱의 기존 아이언소스 오퍼월 구현에서 탭조이 오퍼월로 전환하려면 단계별 마이그레이션 설명을 따릅니다.
읽는 시간 1분최근 업데이트: 2일 전
  1. 먼저 아이언소스 탭조이 어댑터를 연동해야 합니다. 이렇게 podfile에 추가할 수 있습니다.
pod 'IronSourceTapjoyAdapter','4.1.23.1'
최신 어댑터 버전은 여기에서 찾을 수 있습니다.
  1. 이 어댑터에는 오퍼월 SDK 사본이 함께 제공되므로 오퍼월 SDK 함수를 직접 호출할 수 있습니다. 탭조이 오퍼월을 표시하는 데 필요한 작업입니다. 먼저 탭조이를 다음 클래스로 임포트해야 합니다.
#import <Tapjoy/TJPlacement.h>
  1. 그런 다음 오퍼월 SDK를 초기화해야 합니다 성공하거나 실패하면 콜백이 수신되며, 성공 콜백을 수신하기 전까지 오퍼월 SDK 호출은 수행할 필요가 없습니다.
[Tapjoy connect:@"TJ_SDK_KEY"];    - (void)tjcConnectSuccess:(NSNotification *)notifyObj {    NSLog(@"Tapjoy connect succeeded");}- (void)tjcConnectFail:(NSNotification *)notifyObj {    NSLog(@"Tapjoy connect failed");}
  1. 다음으로 플레이스먼트 오브젝트를 생성합니다 플레이스먼트는 탭조이 대시보드에서 설정하고, 오퍼월 콘텐츠 카드가 포함됩니다. 이 예시에서는 플레이스먼트의 이름을 ‘오퍼월’이라고 가정합니다. 실제로는 원하는 대로 이름을 지정할 수 있지만 코드에서 사용하는 이름은 대시보드와 일치해야 합니다.
TJPlacement *placement = [TJPlacement placementWithName:@"Offerwall" delegate:self];
  1. 이제 플레이스먼트를 요청할 준비가 되었습니다. 이 호출로 플레이스먼트를 로드하여 사용자가 표시하기로 선택했을 때 준비되도록 합니다. 오퍼월 플레이스먼트는 빠르게 로드되어야 하지만, 오퍼월을 표시할 때보다 사전에 호출하는 것이 좋습니다.
[p requestContent];
  1. 구현할 수 있는 다양한 콜백을 제공합니다.
- (void)requestDidSucceed:(TJPlacement*)placement{}- (void)requestDidFail:(TJPlacement*)placement error:(NSError*)error{}- (void)contentIsReady:(TJPlacement*)placement{}- (void)contentDidAppear:(TJPlacement*)placement{} - (void)contentDidDisappear:(TJPlacement*)placement{}
이 중 일부는 이미 구현한 아이언소스 콜백을 대체할 수 있습니다. 커스텀 로직을 적절한 탭조이 콜백으로 쉽게 이전할 수 있도록 아래 표에서 해당 콜백을 확인할 수 있습니다.

아이언소스 콜백

탭조이 콜백

offerwallDidShowcontentDidAppear
offerwallDidClosecontentDidDisappear
offerwallHasChangedAvailabilitycontentIsReady
콘텐츠 요청이 탭조이의 서버에서 반환되면 
requestDidSuceed
가 호출됩니다. 콘텐츠(오퍼월)가 표시될 준비가 되면 
contentIsReady
가 호출됩니다. 이 시점에서 오퍼월을 표시하거나 필요 시 표시할 준비가 되도록 몇 가지 플래그를 설정할 수 있습니다.
  1. 오퍼월 플레이스먼트를 표시하려면 콘텐츠가 준비되었는지 확인한 다음 showContent를 호출합니다.
if (placement.isContentReady) {   [placement showContentWithViewController:nil];}
기존 아이언소스 호출을 대체합니다. 
[IronSource showOfferwallWithViewController:UIViewController];
showContent
메서드는 뷰 컨트롤러 인자를 취합니다. nil을 전달하고 탭조이에서 뷰 컨트롤러를 생성하도록 허용하는 것이 좋습니다. 대부분의 경우에 맞는 가장 안전한 옵션입니다. 복잡한 뷰 계층 구조가 있고 어떤 이유로든 디스플레이를 직접 관리하고 싶으면 이 메서드에 전달된 ViewController가 최상위 뷰이고 다른 뷰로 인해 방해받지 않고 탭조이 콘텐츠가 닫힌 후에 다른 뷰가 이 뷰 위에 배치되지 않도록 해야 합니다.
  1. 사용자가 오퍼월을 닫으면 콘텐츠를 다시 요청해야 합니다. 여러 번 플레이스먼트를 표시할 수 없습니다. 다음에 사용자가 요청할 때 다시 표시할 준비가 되도록 
    contentDidDisappear
    콜백에서 플레이스먼트를 요청하는 것을 권장합니다.
  2. 이제 남아 있는 아이언소스 오퍼월 코드를 제거할 수 있습니다. 예제는 아래와 같습니다. 
[IronSource setOfferwallDelegate:yourOfferwallDelegate];
동등한 탭조이 버전으로 전환하지 않은 콜백도 마찬가지입니다. 아이언소스 SDK를 초기화할 때 
@[IS_OFFERWALL]
을 지정하면 이 인수도 제거할 수 있습니다.

개인정보

Unity 레벨플레이를 사용하는 경우 레벨플레이 API를 사용하여 탭조이와 다음의 개인정보 보호 플래그를 공유할 수 있습니다.
  1. GDPR을 동의합니다.
  2. 미국의 개인정보 보호법에 따라 개인정보를 판매하거나 공유하는 것을 거부합니다.
  3. 특정 최종 사용자의 플래그를 아동으로 지정합니다. COPPA(아동 온라인 프라이버시 보호법)에 따라 앱의 주요 대상이 아동인 경우 모든 최종 사용자의 플래그를 아동으로 지정해야 합니다.
Unity 레벨플레이를 사용하지 않거나 오퍼월 SDK를 별도로 설정하려면 이 가이드라인에 따라 탭조이와 관련 개인정보 보호 플래그를 공유합니다.