기술 자료

Unity Ads Monetization


Android API 레퍼런스

Unity Ads Monetization


Android에서 SDK 초기화

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

중요
SDK 초기화 전 또는 SDK 초기화 중에 사용자 동의를 설정 합니다. 동의 설정 없이 광고를 게재하면 일부 지역에서 개인정보 보호 규정을 위반할 수 있습니다.
SDK를 초기화하려면, 해당 플랫폼의 프로젝트에 있는 게임 ID를 참조해야 합니다. Unity Ads Monetization 대시보드의 두 번째 내비게이션 메뉴에서 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에서 인터스티셜 광고 구현 기술 자료를 참조하십시오.