모듈: ads

목차

기능

• isEnabled
• isAdBlocked
• showBanner
• showInterstitial
• showRewarded

기능

isEnabled

▸ isEnabled(): boolean

현재 세션에서 광고가 활성화되어 있는지 여부를 반환합니다. 이를 통해 광고 또는 리워드 광고 버튼을 표시할지, 아니면 다른 플로우를 사용할지 결정할 수 있습니다.

예

if (Wortal.ads.isEnabled()) {
   // 리워드 광고 버튼을 표시한다
}

Returns

boolean

현재 세션에서 광고가 활성화된 경우 True, 광고가 비활성화된 경우 False로 표시된다.

---

isAdBlocked

▸ isAdBlocked(): boolean

현재 세션에서 광고가 차단되었는지 여부를 반환합니다. 이를 통해 광고를 표시하는 대신 대체 플로우를 사용할지 여부를 선택하거나 플레이어에게 광고 차단기를 비활성화하도록 유도할 수 있습니다.

예

if (Wortal.ads.isAdBlocked()) {
   // Show a message to the player to disable their ad blocker.
   // Or use an alternative flow that doesn't require ads - social invites for rewards as an example.
}

Returns

boolean

현재 세션에 대해 광고가 차단된 경우 true입니다. 광고가 차단되지 않으면 거짓입니다.

---

showBanner

▸ showBanner(shouldShow?, position?): void

배너 광고를 표시합니다. 화면 상단 또는 하단에 표시되는 작은 광고로, 일반적으로 메뉴나 게임 플레이 이외의 화면에서 사용됩니다. 언제든지 표시하거나 숨길 수 있습니다.

매개변수

이름	유형	설명
shouldShow	boolean	배너를 표시하거나 숨기도록 설정합니다. 기본적으로 표시되는 설정입니다.
position	BannerPosition	배너의 표시 위치를 설정합니다. 화면 상단 또는 하단에 표시됩니다. 기본값은 화면 하단에 표시됩니다.

Returns

void

---

showInterstitial

▸ showInterstitial(placement, description, beforeAd, afterAd, noFill?): void

인터스티셜 광고 표시. 이 광고는 레벨을 달성하거나 전환하는 사이에 표시할 수 있습니다.

예

// 플레이어가 레벨을 달성.
Wortal.ads.showInterstitial('next', 'NextLevel', pauseGame, resumeGame);

// 플레이어가 게임 일시정지.
Wortal.ads.showInterstitial('pause', 'PausedGame', pauseGame, resumeGame);

// 플레이어가 게임을 일시 중지했습니다.
Wortal.ads.showInterstitial('browse', 'BrowseShop', pauseAudio, resumeAudio);

매개변수

이름	유형	설명
placement	PlacementType	광고 배치 유형.
description	string	배치 설명.
beforeAd	() => void	광고가 표시되기 전 콜백. 이 때 게임을 일시 중지하십시오.
afterAd	() => void	광고가 표시된 후 콜백이 표시됩니다. 이때 게임을 다시 시작하세요.
noFill?	() => void	광고가 채워지지 않은 경우의 콜백. 이는 플랫폼에 표시할 광고가 없거나, 광고가 비율 제한에 도달한 경우 등에 발생할 수 있습니다. 이 경우 afterAd 콜백이 사용됩니다.

Returns

void

Throws

• INVALID_PARAM

---

showRewarded

▸ showRewarded(description, beforeAd, afterAd, adDismissed, adViewed, noFill?): void

리워드 광고 표시. 플레이어가 동영상 광고를 끝까지 시청하는 등 조건을 충족할 경우 보상을 제공하는 광고 유형입니다. 반드시 플레이어에게 알리고 허락을 받은 후 표시해야 합니다.

예

// 이 예시에서는 광고 조건 달성 여부와 상관없이 게임이 진행됩니다.
// 예: 플레이어는 광고를 시청하여 보너스 코인을 획득할 수 있지만, 그 결과와 상관없이 게임은 계속 진행됩니다.
Wortal.ads.showRewarded('BonusCoins', pauseGame, resumeGame, skipBonus, addBonusCoins);

// 이 예시에서는 광고 조건 달성 여부와 관련하여 게임이 진행됩니다.
// 예: 게임오버 시 플레이어는 광고를 시청하여 부활할 수 있지만, 광고를 건너뛰면 해당 레벨을 잃게 됩니다.
Wortal.ads.showRewarded('ReviveAndContinue', pauseAudio, resumeAudio, endGame, continueGame);

매개변수

이름	유형	설명
description	string	배치 설명.
beforeAd	() => void	광고가 표시되기 전 콜백. 이 때 게임을 일시 중지하십시오.
afterAd	() => void	광고가 표시된 후 콜백이 표시됩니다. 이때 게임을 다시 시작하세요.
adDismissed	() => void	플레이어가 동영상 광고를 끝까지 시청하지 않은 경우 콜백. 이 때 보상을 제공하지 마십시오.
adViewed	() => void	플레이어가 동영상 광고를 끝까지 시청한 경우 콜백을 제공합니다. 이때 보상을 제공하세요.
noFill?	() => void	광고가 채워지지 않은 경우의 콜백. 이는 플랫폼에 표시할 광고가 없거나, 광고 게재 한도에 도달했을 때 발생할 수 있습니다. 이 경우 afterAd 콜백이 사용됩니다.

Returns

void

Throws

• INVALID_PARAM