광고

게임에 광고 블록을 배치하여 수익을 창출할 수 있습니다. 이렇게 하려면 다음과 같이 하세요.

1. 광고 배치를 위한 팁 및 권장 사항을 검토하세요.
2. SDK를 사용하여 광고 호출을 구성합니다.
3. Yandex Games 개발자 대시보드를 사용하여 수익 창출을 활성화 합니다.

광고 배치를 위한 팁 및 권장 사항

• 사용자가 이것이 게임의 일부가 아닌 광고 유닛임을 인식할 수 있도록 광고 호출을 배치하세요.
• 게임 내 광고 삽입 권장 위치: 게임 시작 전, 다음 레벨로 진행하기 전, 게임 패배 후.
• 보상형 동영상을 원하는 만큼 자주 호출할 수 있습니다.
• 중간 광고 유닛을 호출하는 빈도는 Yandex Games에서 제어합니다.

setInterval(() => ysdk.adv.showFullscreenAdv(), 180000)

광고 호출 구성

중간 광고

중간 광고는 앱 배경을 완전히 가리고 사용자가 요청한 데이터(예: 다음 게임 레벨에 액세스)를 얻기 전에 표시되는 광고 단위입니다.

광고를 호출하려면 ysdk.adv.showFullscreenAdv({callbacks:{}}) 메서드를 사용합니다.

callbacks: 선택적 콜백 함수. 각 광고 유닛마다 개별적으로 구성됩니다.

• onOpen: 광고가 성공적으로 열렸을 때 호출됩니다.

• onClose: 광고가 닫혔거나 오류가 발생했거나 너무 자주 호출되어 광고가 열리지 않을 때 호출됩니다. 광고가 표시되었는지 여부를 나타내는 값인 wasShown 인자(부울 유형)와 함께 사용됩니다.

• onError: 오류가 발생하면 호출됩니다. 오류 객체는 콜백 함수에 전달됩니다.

예시

ysdk.adv.showFullscreenAdv({
    callbacks: {
        onOpen: function() {
          // 광고가 열린 후의 동작.
        },
        onClose: function(wasShown) {
          // 닫기 후 일부 작업.
        },
        onError: function(error) {
          // 오류 시 일부 작업.
        },
    }
})

보상형 동영상

보상형 동영상은 게임 수익 창출에 사용되는 동영상 광고 블록입니다. 사용자는 보상형 동영상을 시청하면 보상 또는 게임 내 화폐를 받을 수 있습니다.

광고를 호출하려면 ysdk.adv.showRewardedVideo({callbacks:{}}) 메서드를 사용합니다.

callbacks: 선택적 콜백 함수. 각 광고 유닛마다 개별적으로 구성됩니다.

• onOpen: 동영상 광고가 화면에 표시될 때 호출됩니다.

• onRewarded: 동영상 광고 노출 수가 카운트될 때 호출됩니다. 이 함수를 사용하여 동영상 광고 시청에 대한 보상을 지정할 수 있습니다.

• onClose: 사용자가 동영상 광고를 닫을 때 호출됩니다.

• onError: 오류가 발생하면 호출됩니다. 오류 객체는 콜백 함수에 전달됩니다.

예시

ysdk.adv.showRewardedVideo({
    callbacks: {
        onOpen: () => {
          console.log('Video ad open.');
        },
        onRewarded: () => {
          console.log('Rewarded!');
        },
        onClose: () => {
          console.log('Video ad closed.');
        },
        onError: (e) => {
          console.log('Error while open video ad:', e);
        },
    }
})

고정 배너

고정 배너 표시를 활성화하려면 다음과 같이 하세요.

1. 개발자 콘솔을 열고 초안으로 이동합니다.
2. 고정 배너로 이동하여 배너 표시를 설정합니다.

   • 모바일 기기의 경우:

     • 세로 방향의 고정 배너: 하단에 또는 상단에를 선택합니다.
     • 앨범 방향의 고정 배너: 하단에, 상단에 또는 오른쪽에를 선택합니다.

   • 컴퓨터의 경우: 데스크톱의 고정 배너 옵션을 활성화합니다. 배너가 오른쪽에 표시됩니다.

기본적으로 고정 배너는 게임이 시작될 때 표시되며 전체 세션 동안 표시됩니다. 배너를 표시할 순간을 설정하려면 다음과 같이 하세요.

1. 고정 배너 섹션에서 시작 시 고정 배너 표시 안 함을 활성화합니다.
2. 다음 메서드를 사용하여 배너 표시를 설정합니다.
   • ysdk.adv.getBannerAdvStatus(): 배너의 상태를 표시합니다.
   • ysdk.adv.showBannerAdv(): 배너를 호출합니다.
   • ysdk.adv.hideBannerAdv(): 배너를 제거합니다.

이 메서드들은 stickyAdvIsShowing: boolean 값을 반환합니다. stickyAdvIsShowing = false인 경우, ysdk.adv.getBannerAdvStatus() 및 ysdk.adv.showBannerAdv() 메서드는 다음과 같은 가능한 이유와 함께 선택적 reason 필드를 반환할 수 있습니다.

• ADV_IS_NOT_CONNECTED: 배너가 연결되지 않았습니다.
• UNKNOWN: Yandex 측에서 광고를 표시하는 동안 오류가 발생했습니다.

예시

ysdk.adv.getBannerAdvStatus().then(({ stickyAdvIsShowing , reason }) => {
    if (stickyAdvIsShowing) {
        // 광고가 표시됨.
    } else if(reason) {
        // 광고가 표시되지 않음.
        console.log(reason)
    } else {
        ysdk.adv.showBannerAdv()
    }
})

지원 서비스는 얀덱스 게임에서 완성 된 게임을 게시 할 수 있습니다. 개발 또는 테스트에 대한 질문이 있는 경우

Yandex Games SDK 사용과 관련하여 문제가 발생하거나 질문이 있는 경우 다음 방법으로 지원팀에 문의하세요.