개인화 오퍼 사용하기

들어가기 전에

개인화 오퍼는 텐투플레이 SDK v2021.2 부터 지원하므로, SDK 버전을 확인해주시기 바랍니다.
콘솔의 개인화 오퍼를 사용하기 전 반드시 SDK를 다운로드해야 합니다.
이 과정에 대해서는 아래 문서를 참고하세요.

TPPersonalizedOfferController

TPPersonalizedOffeController는 ShowOffer 메소드 호출 시
각각의 플레이어(player_uuid)에 해당하는 Offer를 동적으로 불러와 Canvas에 보여줍니다.

• ShowOffer는 TPPersonalizedOffer 클래스의 메소드이며,
  TPPersonalizedOffer는 텐투플레이 개인화 오퍼 출력 기능을 위한 클래스입니다.

Unity로 구현하기

TPPersonalizedOfferController.prefab은 아래 위치에서 확인할 수 있으며, -TPPersonalizedOfferController.cs 스크립트를 컴포넌트로 갖고 있습니다.

• Assets/TentuPlay/TPPersonalizedOfferTemplates/TPPersonalizedOfferController.prefab

TPPersonalizedOfferController 게임 오브젝트를 Canvas로 옮겨주세요.

tpPersonalizedOfferController GameObject 파라미터 값을 활용하여 ShowOffer를 호출하세요.
그 이후에는 텐투플레이가 자동으로 오퍼를 보여줍니다.

예시 코드

public void ShowPersonalizedOffer()
    {
        TPPersonalizedOffer myTPOffer = new TPPersonalizedOffer();

        StartCoroutine(
            myTPOffer.ShowOffer(tpPersonalizedOfferController, player_uuid, "en", (response=> {}), offer_id:offer_id));
    }

예시 화면

[개인화 오퍼가 화면에 뜬 모습]

ShowOffer 가 호출되면 캔버스에 있는 TPPersonalizedOfferController의 child로 TentuPlayOffer_landscape 혹은 TentuPlayOffer_portrait 가 생성되고(TPPersonalizedOfferController.ShowOffer) 콘솔에서 입력한 이미지는 OfferImage의 Texture/Raw Image(버전마다 약간 다름)가 됩니다.

[TPPersonalizedOfferController의 child로 TentuplayOffer_landscape가 생성된 모습]

UI 자세히 알아보기

TentuPlayManualOffer_landscape, TentuPlayManualOffer_portrait 구성요소에 대한 설명입니다.

TentuPlayManualOffer_landscape.prefab

GUI

Scripts

- MessageController: 쪽지 오픈 및 닫기를 위한 스크립트
- TentuPlayManualOffer: 개인화 오퍼를 위한 텐투플레이 스크립트

메시지 이미지: OfferImage

GUI

콘솔에 이미지 사이즈가 지정(580x896px)되어있지만, OfferImage에서 사이즈를 새로 지정할 시 그 사이즈로 맞춰집니다.

※ 디폴트 사이즈
- TentuPlayManualOffer_landscape: 640x400
- TentuPlayManualOffer_landscape: 400x640

Scripts

On Click()에 TentuPlayManualOffer.GoToOfferEvent

※ 유니티2017버전용 SDK에는 OfferButton으로 분리되어 있으니, SDK 버전을 확인하기 바랍니다.

닫기 버튼: CloseButton

GUI

Scripts

On Click()에 TentuPlayManualOffer.CloseOfferEvent

도움이 필요한가요?

궁금한 것이 있으신가요? 텐투플레이 디스코드에서 바로 문의주세요.