기술 자료

​
​

Development

User Acquisition

Monetization

산업 분야

Unity Ads Monetization

Unity Ads Android SDK

Unity Ads iOS SDK

Unity Ads SDK

Unity Ads Monetization

Unity Ads Monetization
​
​
Android 개발자 가이드
  • Android SDK 개요
  • 연동 요구 사항
  • Android용 Unity Ads SDK 설치
  • Android에서 SDK 초기화
  • Android에서 인터스티셜 광고 구현
  • Android에서 보상형 광고 구현
  • Android에서 배너 광고 구현
Android SDK API 레퍼런스
  • Android용 Unity Ads API 레퍼런스 (Java)
  1. 게임 성장
  2. Unity Ads
  3. Android 개발자용 Unity Ads SDK 연동 가이드

Android에서 SDK 초기화

Android 앱에서 Unity Ads SDK를 초기화합니다. 게임 ID를 설정하고 리스너를 구성하여 초기화 상태를 처리하고 광고 수익화를 활성화합니다.
읽는 시간 1분
최근 업데이트: 7시간 전

SDK를 초기화하려면, 해당 플랫폼의 프로젝트에 있는 게임 ID를 참조해야 합니다. Unity 수익화 대시보드의 두 번째 내비게이션 메뉴에서 CURRENT PROJECT > Project Settings를 선택하여 ID를 찾을 수 있습니다.
게임 스크립트에 초기화 콜백을 처리하는
IUnityAdsInitializationListener
인터페이스를 구현해야 합니다. SDK를 초기화하기 위한 initialize 메서드에는 파라미터로 이 리스너가 필요합니다. 프로젝트의 런타임 라이프사이클 초반에 SDK를 초기화한 후 광고를 로드해야 합니다. 예제는 아래와 같습니다.
참고
Unity Ads는 현재 실행 중인 작업에 대한 액세스 권한이 필요하므로 다음 예에서는
getApplicationContext()
를 사용합니다. 이는 모든 구현에 적합하지 않을 수 있으므로 일부 커스터마이징이 필요할 수 있습니다(연동에 따라 다름).

SDK 초기화 예제

import android.os.Bundle;import androidx.appcompat.app.AppCompatActivity;import com.unity3d.ads.example.R;import com.unity3d.ads.IUnityAdsInitializationListener;import com.unity3d.ads.UnityAds;public class InitializeAdsScript extends AppCompatActivity implements IUnityAdsInitializationListener { private String unityGameID = "1234567"; private Boolean testMode = true; @Override protected void onCreate (Bundle savedInstanceState) { super.onCreate (savedInstanceState); setContentView (R.layout.activity_main); // Initialize the SDK: UnityAds.initialize(getApplicationContext(), unityGameID, testMode, this); } @Override public void onInitializationComplete() { } @Override public void onInitializationFailed(UnityAds.UnityAdsInitializationError error, String message) { }}
initialize
함수의 경우,
context
파라미터는 현재의 Android
Context
입니다.
unityGameID
파라미터는 Monetization 대시보드, 특히 프로젝트의 설정 페이지에 있는 프로젝트의 Unity 게임 ID입니다.
IUnityAdsInitializationListener
는 초기화 호출 결과의 리스너입니다.
true
부울은 게임이 테스트 모드 상태임을 나타내며 테스트 광고만 표시합니다.
참고
리스너 인터페이스의 각 콜백 메서드를 구현해야 하며, 현재 빈 함수라 하더라도 구현해야 합니다. 다음 섹션에서 필요한 경우 적절한 로직으로 이를 채우게 됩니다. 각 리스너 콜백 메서드에 대한 자세한 내용은
IUnityAdsInitializationListener
API 기술 자료를 참조하십시오.
다음 단계: 연동을 계속 진행하려면 Android에서 인터스티셜 광고 구현 기술 자료를 참조하십시오.

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

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

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

  • 보고 있는 페이지
    • SDK 초기화 예제


이 페이지의 문제 보고