제품에 관해 논의하고 의견을 제공하려면 Google 광고 및 측정 커뮤니티 서버의 공식 AdMob Discord 채널에 참여하세요.

시작하기

플랫폼 선택: Android iOS Unity Flutter

Google 모바일 광고 Unity 플러그인을 사용하면 Unity 개발자가 Java 또는 Objective-C 코드를 작성하지 않고도 Android 및 iOS 앱에 Google 모바일 광고를 게재할 수 있습니다. 이 플러그인에서는 Unity 프로젝트의 C# 스크립트에서 사용되는 광고를 요청하기 위한 C# 인터페이스를 제공합니다.

이 가이드는 Unity 앱으로 수익을 창출하려는 게시자를 위해 작성되었습니다.

기본 요건

Unity Editor 2019.4 이상 사용
iOS에 배포하기 위한 요건
- Xcode 16.0 이상
- iOS 12.0 이상 타겟팅
- CocoaPods
Android에 배포하기 위한 요건
- 최소 Android API 수준 23 이상
- Android API 수준 34 이상 타겟팅

권장사항: AdMob 계정을 만들고 Android 또는 iOS 앱을 등록하세요.

Android API 수준은 프로젝트 설정 > 플레이어 > Android > 기타 설정 > 기타 설정에서 설정합니다.

Unity용 모바일 광고 플러그인 가져오기

OpenUPM-CLI

OpenUPM CLI가 설치되어 있으면 다음 명령어를 실행하여 OpenUPM 레지스트리를 설치할 수 있습니다.

openupm add com.google.ads.mobile

`.unitypackage` 플러그인 확장 소재 삭제

.unitypackage 사용에서 OpenUPM 사용으로 이전하는 경우 이전 위치에서 확장 소재를 수동으로 제거해야 합니다. .unitypackage에서 가져온 다음 디렉터리를 삭제합니다.

Assets/ExternalDependencyManager
Assets/GoogleMobileAds
Assets/Plugins/Android/googlemobileads-unity.aar
Assets/Plugins/Android/GoogleMobileAdsPlugin
Assets/Plugins/iOS/GADUAdNetworkExtras
Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

Unity 메뉴 옵션 Edit(수정) > Project Settings(프로젝트 설정) > Package Manager(패키지 관리자)를 선택하여 package manager settings(패키지 관리자 설정)를 엽니다.
OpenUPM을 Package Manager(패키지 관리자) 창에 범위가 지정된 레지스트리로 추가합니다.
```
Name: OpenUPM
URL: https://package.openupm.com
Scopes: com.google
```
Unity 메뉴 옵션 Window(창) > Package Manager(패키지 관리자)를 선택하여 package manager menu(패키지 관리자 메뉴)를 엽니다.
관리자 범위 드롭다운을 설정하여 My Registries(내 레지스트리)를 선택합니다.
패키지 목록에서 Google Mobile Ads for Unity(Unity용 Google 모바일 광고) 패키지를 선택하고 Install(설치)을 누릅니다.

`.unitypackage` 플러그인 확장 소재 삭제

Assets/ExternalDependencyManager
Assets/GoogleMobileAds
Assets/Plugins/Android/googlemobileads-unity.aar
Assets/Plugins/Android/GoogleMobileAdsPlugin
Assets/Plugins/iOS/GADUAdNetworkExtras
Assets/Plugins/iOS/unity-plugin-library.a

GitHub에서 가져오기

GitHub에서 최신 .unitypackage 버전을 다운로드합니다.
Unity 메뉴 옵션 Assets(확장 소재) > Import package(패키지 가져오기) > Custom Package(맞춤 패키지)를 선택하고 모든 항목을 가져와서 .unitypackage 파일을 가져옵니다.

외부 종속 항목 포함

Google 모바일 광고 Unity 플러그인은 Unity Play 서비스 리졸버 라이브러리와 함께 배포됩니다. 이 라이브러리는 Android 전용 라이브러리(예: AAR) 또는 iOS CocoaPods에 대한 액세스 권한이 필요한 Unity 플러그인에서 사용하기 위한 것입니다. 이 라이브러리는 Unity 플러그인에 종속 항목을 선언하는 기능을 제공합니다. 그러면 종속 항목이 자동으로 결정되어 Unity 프로젝트에 복사됩니다.

다음 단계에 따라 프로젝트에 모든 종속 항목이 포함되도록 하세요.

Android

Project Settings(프로젝트 설정) > Player(플레이어) > Android > Publishing Settings(게시 설정) > Build(빌드)로 이동한 후 다음을 선택합니다.

맞춤 기본 Gradle 템플릿
맞춤 Gradle 속성 템플릿

Unity 편집기에서 Assets(확장 소재) > External Dependency Manager(외부 종속 항목 관리자) > Android Resolver(Android 리졸버) > Resolve(결정)를 선택하여 Unity 외부 종속 항목 관리자 라이브러리가 선언된 종속 항목을 Unity 앱의 Assets/Plugins/Android 디렉터리에 복사하도록 합니다.

iOS

iOS용 Unity는 CocoaPods를 사용하여 종속 항목을 식별하고 관리합니다. iOS 종속 항목과 관련된 구체적인 요구사항 또는 문제 해결 단계는 CocoaPods 문서를 참고하세요.

Google 모바일 광고 Unity 플러그인 종속 항목은 Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml에 나와 있습니다.

AdMob 앱 ID 설정

Unity 편집기의 메뉴에서 Assets(확장 소재) > Google Mobile Ads(Google 모바일 광고) > Settings(설정)를 선택합니다.

각 필드에 Android 및 iOS AdMob 앱 ID를 입력합니다.

SDK 초기화

광고를 로드하기 전에 앱에서 MobileAds.Initialize()를 호출하여 Google 모바일 광고 SDK를 초기화합니다. 이 작업은 앱 실행 시 한 번만 처리하면 됩니다.

다음은 MobileAds.Initialize() 호출 방법의 예입니다.

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    // Google Mobile Ads events are raised off the Unity Main thread. If you need to
    // access UnityEngine objects after initialization,
    // use MobileAdsEventExecutor.ExecuteInUpdate(). For more information, see:
    // https://developers.google.com/admob/unity/global-settings#raise_ad_events_on_the_unity_main_thread
});GoogleMobileAdsController.cs