기술 자료

지원

오퍼월

Monetization 시작하기

UA 시작하기

Unity SDK 연동

오퍼월

SDK

React Native SDK 가이드를 임포트하여 TJPlacement를 사용해 광고 플레이스먼트를 요청하고 표시하는 방법을 알아보며, 여기에는 콘텐츠 사전 캐싱과 원활한 사용자 경험을 위한 콜백 처리가 포함됩니다.
읽는 시간 1분최근 업데이트: 2일 전

플레이스먼트 요청

먼저 
TJPlacement
를 임포트합니다. 
import Tapjoy, { TJPlacement } from "tapjoy-react-native-sdk";
TJPlacement
의 인스턴스를 생성하고 플레이스먼트 이름으로 초기화합니다. 코드의 플레이스먼트 이름 문자열이 대시보드의 플레이스먼트 이름과 정확히 일치해야 합니다. 또한 콜백을 수신하기 위한 델리게이트를 구현할 수 있습니다(아래 설명 참고). 
let placement = new TJPlacement("Placement Name");
이제 콘텐츠를 요청할 수 있습니다. 
placement.requestContent();
콘텐츠를 요청하기 전에 탭조이 연결 호출이 성공해야 합니다. 
onConnectSuccess
콜백을 수신한 이후 요청해야 합니다.

콘텐츠 사전 캐싱

최적의 사용자 경험을 제공하려면 사용자에게 해당 콘텐츠가 표시되기 전에 콘텐츠를 요청합니다. 예를 들어 플레이스먼트가 메인 메뉴의 버튼이면 탭조이 연결 호출 성공 직후 애플리케이션이 시작될 때 해당 콘텐츠를 요청할 수 있습니다. 마지막 순간까지 대기하여 콘텐츠를 요청하면 사용자가 콘텐츠가 로드될 때까지 기다리고 로딩 스피너를 보게 될 수 있습니다. 이렇게 하면 광고에서 사용자가 광고와 상호 작용할 가능성이 감소하므로 사용자가 수익을 창출할 가능성 역시 줄어듭니다.

콜백

콘텐츠 요청 상태에 관한 피드백을 받으려면 다음 콜백을 구현합니다. 
placement.on(TJPlacement.REQUEST_DID_SUCCEED, (placement: TJPlacement) => { });placement.on(TJPlacement.REQUEST_DID_FAIL, (placement: TJPlacement) => { });placement.on(TJPlacement.CONTENT_IS_READY, (placement: TJPlacement) => { });placement.on(TJPlacement.CONTENT_DID_APPEAR, (placement: TJPlacement) => { });placement.on(TJPlacement.CONTENT_DID_DISAPPEAR, (placement: TJPlacement) => { });

플레이스먼트 표시

콘텐츠를 표시하려면 
placement.showContent();
를 사용합니다. 
showContent()
전에 콘텐츠가 준비되었는지 확인합니다. 
if (placement.isContentReady()) {   placement.showContent();}
동영상이 포함될 수 있는 플레이스먼트의 콘텐츠를 표시하기 전에 앱 오디오를 음소거로 설정하는 것이 좋습니다. 그렇지 않으면 동영상 오디오와 앱 오디오가 충돌할 수 있습니다. 종종 
CONTENT_IS_READY
콜백이 작동할 때까지 기다린 후 사용자에게 콘텐츠를 표시하는 것이 좋습니다. 이렇게 하면 콘텐츠가 실제로 디바이스에 있는지 확인할 수 있으며 사용자에게 지연 없이 표시할 수 있습니다. 다른 동등한 방법은 위의 예시와 같이 
p.isContentReady()
가 true인지 확인하는 것입니다. 적절한 기능을 제공하려면 플레이스먼트 오브젝트를 생성하기 전에 탭조이 연결 호출을 수행하고 성공해야 합니다.

콘텐츠 다시 요청

플레이스먼트에서 사용자에게 콘텐츠를 성공적으로 표시할 경우 다른 콘텐츠 단위로 플레이스먼트를 ‘재로드’하려면 콘텐츠를 다시 요청해야 합니다(예: 
placement.requestContent();
다시 호출). 
placement.showContent();
를 다시 호출할 수 없습니다. 콘텐츠를 요청하기 전에 콘텐츠를 표시하려고 하면 콘텐츠가 표시되지 않습니다. 동영상 콘텐츠를 표시하려는 플레이스먼트의 경우 콘텐츠를 다시 요청할 가장 적절한 재요청 시점은 콘텐츠가 표시된 직후입니다. 사용자가 현재 동영상을 시청하는 동안 다음 동영상을 미리 로드합니다. 콘텐츠가 닫힐 때까지 대기하여 콘텐츠를 다시 요청하는 경우 사용자가 즉시 다른 동영상을 시청하려고 하면 지연 시간이 발생합니다.

엔트리 포인트 설정

필요에 따라 각 플레이스먼트의 ‘엔트리 포인트’를 탭조이에 제공할 수 있습니다. 선택 가능한 다양한 프리셋 값은 다음과 같습니다. 
TJEntryPointUnknownTJEntryPointOtherTJEntryPointMainMenuTJEntryPointHudTJEntryPointExitTJEntryPointFailTJEntryPointCompleteTJEntryPointInboxTJEntryPointInitTJEntryPointStore
플레이스먼트 오브젝트를 생성한 후, 콘텐츠를 요청하기 전에 엔트리 포인트를 설정합니다. 
let placement = new TJPlacement("myPlacement");placement.setEntryPoint(TJEntryPoint.TJEntryPointMainMenu);placement.requestContent();