이 페이지는 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 수준 31 이상 타겟팅

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

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

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

Unity용 Google 모바일 광고 플러그인은 GitHub 및 OpenUPM 저장소에서 .unitypackage로 배포됩니다.

GitHub에서 가져오기

GitHub에서 최신 .unitypackage 출시 버전을 다운로드합니다.
Unity 메뉴 옵션 Assets > Import package > Custom Package를 선택하고 모든 항목을 가져와 .unitypackage 파일을 가져옵니다.

OpenUPM으로 가져오기

OpenUPM CLI로 OpenUPM 레지스트리 설치

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

openupm add com.google.ads.mobile

수동으로 OpenUPM 레지스트리 설치

Unity 메뉴 옵션 Edit > Project Settings > Package Manager를 선택하여 패키지 관리자 설정을 엽니다.
패키지 관리자 창에 OpenUPM을 범위가 지정된 레지스트리로 추가합니다.
```
Name: OpenUPM
URL: https://package.openupm.com
Scopes: com.google
```

Unity용 Google 모바일 광고 패키지 설치

Unity 메뉴 옵션 Window > Package Manager를 선택하여 패키지 관리자 메뉴를 엽니다.
관리자 범위 드롭다운을 설정하여 내 레지스트리를 선택합니다.
패키지 목록에서 Unity용 Google 모바일 광고 패키지를 선택하고 설치를 누릅니다.

외부 종속 항목 포함

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

다음 단계에 따라 프로젝트에 모든 종속 항목이 포함되어 있는지 확인합니다.

Android

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

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

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

iOS

추가 단계에 따라 Google 모바일 광고 SDK를 Unity 프로젝트에 포함할 필요가 없습니다.

iOS 종속 항목은 CocoaPods를 사용하여 식별합니다. CocoaPods는 빌드 후 프로세스 단계에서 실행됩니다.

Unity 5.6 이상을 사용하는 경우 필요한 종속 항목 라이브러리가 포함된 xcworkspace가 생성됩니다. 표준 Xcode 프로젝트 대신 생성된 xcworkspace를 사용하세요.
이전 버전의 Unity를 사용하는 경우 종속 항목이 표준 Xcode 프로젝트에 포함됩니다.

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

앱 ID AdMob 설정

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

각 입력란에 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에서 제공하는 다양한 광고 형식 중 최고의 사용자 환경을 만드는 데 가장 적합한 형식을 선택할 수 있습니다.

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

배너 광고 구현