기술 자료

​
​

Development

User Acquisition

Monetization

산업 분야

레벨플레이 SDK - Adobe AIR

Unity SDK

Android SDK

iOS SDK

Adobe AIR SDK

Flutter SDK

React Native SDK

레벨플레이 SDK - Adobe AIR

Unity LevelPlay
​
​
Adobe AIR SDK
  • 시작하기
  • 규정 및 설정
  • 광고 형식
    • 보상형 광고
      • Manual rewarded ads integration
    • 인터스티셜 광고
    • 배너 및 MREC
  • Mediation 네트워크
  • 연동 테스트
  1. 게임 성장
  2. Unity 레벨플레이
  3. LevelPlay SDK
  4. Adobe AIR 개발자를 위한 레벨플레이 SDK

Adobe AIR를 위한 보상형 광고 통합

이벤트 리스너와 광고 플레이스먼트 설정 포함하여 레벨플레이 SDK를 사용하여 보상형 비디오 광고를 Adobe AIR 애플리케이션 통합합니다.
읽는 시간 4분
최근 업데이트: 9시간 전

필수 조건

Ironsource Adobe AIR 플러그인 올바르게 연동했는지 확인합니다. 통합은 여기 설명되어 있습니다.

1단계. 보상형 비디오 리스너 구현

Ironsource AIR 플러그인 광고 유효성 알려주기 위해 여러 이벤트를 발생시킵니다. 이벤트 수신하려면 다음 메서드를 호출.
IronSource.instance.addEventListener( "EventName", functionToCall );
  • EventName은 듣고자 하는 이벤트를 포함하는 문자열입니다.
  • functionToCall은 이벤트가 발생할 때 호출할 함수입니다.
플러그인 아래에 나열된 가능한 모든 이벤트를 리스너에게 알립니다.
IronSource.instance.addEventListener("levelPlayRewardedAvailable", levelPlayRewardedAvailable);IronSource.instance.addEventListener("levelPlayRewardedAdUnavailable", levelPlayRewardedAdUnavailable);IronSource.instance.addEventListener("levelPlayRewardedAdOpened", levelPlayRewardedAdOpened);IronSource.instance.addEventListener("levelPlayRewardedOnAdRewarded", levelPlayRewardedOnAdRewarded);IronSource.instance.addEventListener("levelPlayRewardedAdShowFailed", levelPlayRewardedAdShowFailed);IronSource.instance.addEventListener("levelPlayRewardedVideoAdClicked", levelPlayRewardedVideoAdClicked);IronSource.instance.addEventListener("levelPlayRewardedAdClosed", levelPlayRewardedAdClosed);
플러그인 아래에 나열된 가능한 모든 이벤트를 리스너에게 알립니다.
private function levelPlayRewardedAdOpened(event:Event):void { //level Play Rewarded Ad Opened}private function levelPlayRewardedOnAdRewarded(event:Event):void { //level Play Rewarded On Ad Rewarded}private function levelPlayRewardedAdShowFailed(event:Event):void { //level Play Rewarded Ad Show Failed}private function levelPlayRewardedVideoAdClicked(event:Event):void { //level Play Rewarded Video Ad Clicked}private function levelPlayRewardedAdClosed(event:Event):void { //level Play Rewarded Ad Closed}private function levelPlayRewardedAdUnavailable(event:Event):void { //level Play Rewarded Ad Unavailable}private function levelPlayRewardedAvailable(event:Event):void { //level Play Rewarded Available}
Ironsource 연동 또는 라이브 프로덕션 중에 발생할 수 있는 오류를 이해하는 데 도움이 되는 오류 코드 메커니즘을 제공합니다. 다음과 같이 DataEvent 오브젝트에서 오류 데이터를 추출합니다.
var errorCode:String;var errorDescription:String; if(event.data){ var error:오브젝트 = JSON. 파싱(이벤트.data); errorDescription = error.error_description; errorCode = error.error_code;}
여기에서 Ironsource 오류 코드에 대한 전체 설명을 참조하십시오.

2단계. 사용자에게 동영상 광고 표시

광고 유효성

보상형 비디오 리스너와 그 기능을 올바르게 구현하면 levelPlayRewardedAvailable을 통해 유효성 상태를 확인할 수 있습니다. 그런 다음 광고 유효성 변경 시 아래의 델리게이트 함수 통해 알림을 받게 됩니다.
private function levelPlayRewardedAvailable(event:Event):void { }
다음 라인을 사용하여 DataEvent 오브젝트 확인합니다
event.data == “true/false”
또는 다음을 호출하여 광고 유효성 직접 요청할 수도 있습니다.
IronSource.instance.isRewardedVideoAvailable()

동영상 광고 게재

광고 네트워크에 이용 가능한 동영상이 표시되면 이 동영상 광고를 사용자에게 표시할 수 있습니다. 사용자가 동영상 광고를 시청하도록 유도하는 트리거를 삽입하는 이상적인 시점입니다. IronSource 인스턴스에서 showRewardedVideo() 메서드를 호출하면 사용자에게 동영상 광고를 표시할 수 있습니다.
IronSource.instance.showRewardedVideo();

광고 플레이스먼트

레벨플레이 광고 플레이스먼트를 사용하면 보상형 비디오 경험 커스터마이즈 최적화할 수 있습니다. 이 툴을 사용하면 보상에 따라 다양한 플레이스먼트의 사용자에게 동영상을 표시할 수 있습니다. 아래 함수 사용하여 광고를 표시할 플레이스먼트를 정확하게 정의할 수 있습니다.
Ironsource 인스턴스에서 showRewardedVideo() 메서드를 호출하면 사용자에게 동영상 광고를 표시하고 정확하게 광고를 표시할 위치를 정의할 수 있습니다. 이 플레이스먼트의 보상 설정은 Ironsource 서버에서 가져옵니다.
IronSource.instance.showRewardedVideo(YOUR_PLACEMENT_NAME);
각 광고 플레이스먼트와 관련된 정보(예: 보상 정보)를 확인하려면 다음을 호출.
function getRewardedVideoPlacementInfo(placementName:String):String {}

캡핑 및 패싱

이제 레벨플레이 광고 플레이스먼트 외에 선택한 플레이스먼트에 대한 제한 및 페이싱 설정을 설정 수 있습니다. 캡핑과 페이싱은 정해진 기간 내에 게재되는 광고의 양을 제한하여 앱의 사용자 경험 개선합니다.
보상형 비디오 대한 제한 및 속도 조절 툴을 사용하는 경우 아래 메서드를 호출하여 특정 플레이스먼트가 광고 한도에 도달했는지 확인하는 것이 좋습니다. 이는 플레이스먼트가 제한되거나 속도가 조정된 경우 보상형 비디오 버튼을 표시하지 않으므로 비디오 광고를 게재하지 않습니다.
var isPlacementCapped: 부울 = Ironsource.instance.isRewardedVideoPlacementCapped(YOUR_PLACEMENT_NAME);

동적 UserId

동적 사용자 ID는 AdRewarded 거래를 확인하는 파라미터, 세션 전반에 걸쳐 변경될 수 있습니다. 이 파라미터는 서버 간 광고 보상형 광고 콜백을 통해 수신되며 showRewardedVideo를 호출하기 전에 설정해야 합니다.
  • 문자열 값은 영숫자 1~64자로 구성되어야 합니다.
  • 보상 세부 정보가 포함된 콜백 URL에
    dynamicUserId
    파라미터가 표시됩니다.
IronSource.instance.setDynamicUserId(id);

3단계. 사용자 보상

Ironsource SDK는 사용자가 동영상을 성공적으로 완료할 때마다 levelPlayRewardedOnAdRewarded 이벤트를 실행합니다. 이 이벤트를 수신하기 위해 levelPlayRewardedVideoListener가 설치되어 있으므로 사용자에게 보상을 제공할 수 있습니다.
DataEvent 오브젝트 보상 데이터를 추출하는 방법은 다음과 같습니다.
var placementId:String;var placementName:String;var rewardName:String;var rewardAmount:int; if(event.data){ var placement:오브젝트 = JSON. 파싱(이벤트.data); placementId = placement.placement_id; placementName = placement.placement_name; rewardName = placement.placement_reward_name; rewardAmount = parseInt(placement.placement_reward_amount);}
levelPlayRewardedOnAdRewarded 및 levelPlayRewardedAdClosed 이벤트는 비동기입니다. levelPlayRewardedOnAdRewarded가 levelPlayRewardedAdClosed 이벤트 후 발생한 경우에도 보상을 부여하도록 리스너를 설정해야 합니다.
private function levelPlayRewardedOnAdRewarded(event:Event):void {}
  • 레벨플레이 계정의 기본 설정은 앱의 클라이언트 내의 levelPlayRewardedOnAdRewarded 콜백을 사용하여 사용자 완료/보상을 알립니다. 백엔드 서버에 알림을 받으려면 서버 간 콜백을 활성화할 수도 있습니다.
  • 서버 간 콜백을 활성화하는 경우 동일한 완료 시 사용자 두 번 이상 보상을 제공하지 마십시오. 클라이언트 측 콜백 서버 간 콜백 모두 작동하므로 각 완료마다 두 개의 알림이 전송됩니다.
이제 애플리케이션 보상형 비디오 제공할 준비가 되었습니다.
참고
애플리케이션 대한 새로운 통합인 경우 앱은 기본적으로 Ironsource 대시보드의 'Test Mode'에 있습니다. 앱이 테스트 모드일 때 레벨플레이 SDK는 SDK 프로세스의 가시성을 높이기 위해 더 많은 로그를 콘솔 출력합니다. 광고 인벤토리를 테스트하려면 테스트 디바이스를 설정하십시오. 라이브 광고 인벤토리를 활성화할 때까지 매출 창출하지 않는 테스트 캠페인을 수신하게 됩니다. 앱이 라이브 광고 인벤토리를 준비할 때 Ad Units 페이지에서 **Go Live!**를 선택해야 합니다.

다음 단계

Mediation 플랫폼에 보상형 비디오 광고 네트워크를 추가로 구현하거나 추가 광고 유닛을 설정 연동 가이드를 따르십시오.
  • Mediation(미디에이션)
  • 인터스티셜 광고

Copyright © 2026 Unity Technologies
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

'Unity', Unity 로고 및 기타 Unity 상표는 미국 및 기타 지역 내 Unity Technologies 또는 그 계열사의 상표 또는 등록상표입니다(자세한 내용은 여기에서 확인하세요). 기타 명칭 또는 브랜드는 해당 소유자의 상표입니다.

일부 페이지는 편의를 위해 기계 번역되었으며 부정확한 내용이 있을 수 있습니다. 정보가 상충되는 경우, 영어 버전을 우선으로 참조하세요.

  • 보고 있는 페이지
    • 필수 조건

    • 1단계. 보상형 비디오 리스너 구현

    • 2단계. 사용자에게 동영상 광고 표시

      • 광고 유효성

      • 동영상 광고 게재

        • 광고 플레이스먼트

      • 캡핑 및 패싱

      • 동적 UserId

    • 3단계. 사용자 보상

    • 다음 단계


이 페이지의 문제 보고