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

시작하기

Google 모바일 광고 Unity 플러그인을 사용하면 Unity 개발자가 자바 또는 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 수준 34 이상 타겟팅

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

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

플러그인 확장 소재 `.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 서비스 리졸버 라이브러리와 함께 배포됩니다. 이 라이브러리는 AAR 또는 iOS CocoaPods와 같은 Android 관련 라이브러리에 액세스해야 하는 모든 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에 나와 있습니다.

Ad Manager 앱 ID 설정

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

각 필드에 Android 및 iOS Ad Manager 앱 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 => { });
    }
}

미디에이션을 사용하는 경우 광고를 로드하기 전에 콜백이 발생할 때까지 기다려야 모든 미디에이션 어댑터가 초기화됩니다.