이 페이지는 Cloud Translation API를 통해 번역되었습니다.

시작하기

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

이 가이드는 Unity 앱으로 수익을 창출하려는 게시자를 대상으로 합니다.

기본 요건

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

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

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

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

OpenUPM-CLI

OpenUPM CLI가 설치된 경우 다음 명령어를 사용하여 OpenUPM 레지스트리를 설치할 수 있습니다.

openupm add com.google.ads.mobile

플러그인 애셋 `.unitypackage`개 삭제

.unitypackage 사용에서 OpenUPM 사용으로 마이그레이션하는 경우에는 이전 위치에서 애셋을 수동으로 제거해야 합니다. .unitypackage에서 가져온 다음 디렉터리를 삭제합니다.

애셋/ExternalDependencyManager
애셋/Google모바일 광고
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를 선택하여 패키지 관리자 설정을 엽니다.
OpenUPM을 범위가 지정된 레지스트리로 Package Manager 창에 추가합니다.
```
Name: OpenUPM
URL: https://package.openupm.com
Scopes: com.google
```
Unity 메뉴 옵션 Window > Package Manager를 선택하여 package Manager(패키지 관리자) 메뉴를 엽니다.
관리자 범위 드롭다운을 설정하여 내 레지스트리를 선택합니다.
패키지 목록에서 Unity용 Google 모바일 광고 패키지를 선택하고 설치를 누릅니다.

플러그인 애셋 `.unitypackage`개 삭제

애셋/ExternalDependencyManager
애셋/Google모바일 광고
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 Services Resolver 라이브러리와 함께 배포됩니다. 이 라이브러리는 AAR 또는 iOS CocoaPods와 같은 Android 전용 라이브러리에 액세스해야 하는 모든 Unity 플러그인에서 사용할 수 있습니다. 이 라이브러리는 Unity 플러그인에 종속 항목을 선언하는 기능을 제공합니다. 종속 항목은 자동으로 해결되어 Unity 프로젝트에 복사됩니다.

프로젝트에 모든 종속 항목이 포함되어 있는지 확인하려면 다음 단계를 따르세요.

Android

프로젝트 설정 > 플레이어 > Android > 게시 설정 > 빌드로 이동하여 다음을 선택합니다.

맞춤 기본 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에 나열되어 있습니다.

앱 ID AdMob 설정

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

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

SDK 초기화

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

다음은 GameObject에 첨부된 스크립트의 Start() 메서드 내에서 Initialize()를 호출하는 방법의 예입니다.

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

미디에이션을 사용하는 경우 광고를 로드하기 전에 콜백이 발생할 때까지 기다렸다가 모든 미디에이션 어댑터가 초기화되도록 하세요.

광고 형식 선택

이제 Android 또는 iOS 플랫폼에 배포할 때 Unity 앱에 Google 모바일 광고 SDK가 포함됩니다. 이제 광고를 구현할 준비가 되었습니다. AdMob은 다양한 광고 형식을 제공하므로 최상의 사용자 환경을 위한 광고 형식을 선택할 수 있습니다.

배너 광고 단위에는 앱 레이아웃의 일부를 차지하는 직사각형 광고가 게재됩니다. 일정 시간이 지나면 자동으로 새로고침될 수 있습니다. 즉, 사용자가 앱에서 같은 화면에 머물러 있더라도 정기적으로 새 광고를 보게 됩니다. 또한 구현하기에 가장 간단한 광고 형식이기도 합니다.

배너 광고 구현