광고 관리

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

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

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

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

광고 호출 구성

중간 광고

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

광고를 호출하려면 ysdk.adv.show_fullscreen_adv() 메서드를 사용합니다.

ysdk.adv.show_fullscreen_adv(callbacks: table)

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

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

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

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

• on_offline — 네트워크 연결이 끊겼을 때(오프라인 모드로 전환될 때) 호출됩니다.

예시

ysdk.adv.show_fullscreen_adv({
  on_close = function (self, was_shown)
    -- 닫기 후 일부 작업
  end,
  on_error = function (self, error)
    -- 오류 시 일부 작업
  end
})

보상형 동영상

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

광고를 호출하려면 ysdk.adv.show_rewarded_video() 메서드를 사용합니다.

ysdk.adv.show_rewarded_video(callbacks: table)

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

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

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

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

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

예시

ysdk.adv.show_rewarded_video({
  on_open = function (self)
    print("Video ad open")
  end,
  on_close = function (self)
    print("Rewarded!")
  end,
  on_rewarded = function (self)
    print("Video ad closed.")
  end,
  on_error = function (self, error)
    print("Error while open video ad: " .. error)
  end
})

고정 배너

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

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

   • 모바일 기기의 경우:

     • Sticky banner in portrait orientation: At the bottom 또는  At the top를 선택합니다.
     • Sticky banner in landscape orientation: At the bottom, At the top 또는 On the right를 선택합니다.

   • 컴퓨터의 경우: Sticky banner on the desktop 옵션을 활성화합니다. 배너가 오른쪽에 표시됩니다.

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

1. Sticky banners 섹션에서 Use the API to display a sticky-banner을 활성화합니다.
2. 다음 메서드를 사용하여 배너 표시를 설정합니다:
   • ysdk.adv.get_banner_adv_status() — 배너의 상태를 표시합니다.
   • ysdk.adv.show_banner_adv() — 배너를 호출합니다.
   • ysdk.adv.hide_banner_adv() — 배너를 제거합니다.

ysdk.adv.get_banner_adv_status() 메서드는 sticky_adv_is_showing: boolean 값을 반환합니다. 만약 sticky_adv_is_showing = false라면, ysdk.adv.get_banner_adv_status() 메서드는 선택적으로 가능한 이유를 담은 reason 필드를 반환할 수 있습니다:

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

예시

ysdk.adv.get_banner_adv_status(
  function (self, sticky_adv_is_showing, reason)
    if sticky_adv_is_showing then
      -- 광고가 표시됨
    elseif reason then
      -- 광고가 표시되지 않음
      print(reason)
    else
      ysdk.adv.show_banner_adv()
    end
  end
)