Google 입찰 통합
Google Ad Manager 계정을 구성하고 입찰 프로세스를 설정하고 프로젝트에 필요한 어댑터를 추가하여 Google 입찰을 Unity 레벨플레이 연동할 수 설정.
읽는 시간 5분최근 업데이트: 11시간 전
이 가이드는 Unity 레벨플레이 Mediation Google을 입찰자 네트워크로 설정하는 방법을 단계별로 설명합니다.
필수 조건
-
보상형 광고 광고, 인터스티셜 광고 또는 배너 광고를 애플리케이션 올바르게 연동했는지 확인합니다. 연동 지침은 다음 가이드를 참고하십시오.
-
레벨플레이 SDK 버전 7.2.7 이상부터 Google 입찰이 지원됩니다.
1단계. AdMob 계정 생성
- Unity 레벨플레이 Mediation을 통해 Google의 광고 인벤토리에 액세스, 접근하려면 AdMob 계정을 생성해야 합니다.
- Unity 레벨플레이 플랫폼에 맞게 AdMob 계정의 시간대를 UTC로 조정하는 것이 좋습니다. 이렇게 하면 정확한 리포트가 보장됩니다. 자세히 알아보기
2단계. AdMob에서 애플리케이션 및 광고 유닛 생성
이제 앱을 AdMob 계정에 추가해야 합니다.
앱 추가
- AdMob 계정에 로그인합니다. 대시보드에서 앱을 선택한 다음 앱 추가를 선택합니다.
- 앱을 검색하거나 앱을 수동으로 추가하거나 기존 앱을 선택하여 수익화를 수행할 수 있는 모달이 나타납니다. Ironsource 계정과 유사하게 플랫폼별로 고유한 AdMob 애플리케이션(iOS + Android)이 필요합니다.
- 인터스티셜 광고, 보상형 광고 또는 배너를 광고 유닛 형식으로 선택하고 관련 세부 정보를 입력합니다.
- 인터스티셜 광고
- Ad unit name: 광고 유닛의 이름을 직관적으로 지정하면 게재할 광고 유닛으로 쉽게 인식할 수 있습니다.
- 파트너 입찰: 체크박스를 선택하면 다른 Mediation 플랫폼에서 입찰을 사용하고 있음을 나타냅니다.
- 보상형 광고
- Ad unit name: 광고 유닛의 이름을 직관적으로 지정하면 게재할 광고 유닛으로 쉽게 인식할 수 있습니다.
- 파트너 입찰: 체크박스를 선택하면 다른 Mediation 플랫폼에서 입찰을 사용하고 있음을 나타냅니다.
- 배너
- Ad unit name: 광고 유닛의 이름을 직관적으로 지정하면 게재할 광고 유닛으로 쉽게 인식할 수 있습니다.
- 파트너 입찰: 체크박스를 선택하면 다른 Mediation 플랫폼에서 입찰을 사용하고 있음을 나타냅니다.
3단계. 레벨플레이 네트워크 설정 모듈에서 Google 활성화
레벨플레이 Meta Audience Network 설정을 얻는 방법에는 두 가지가 있습니다.
- 자동 설정 - Google 계정으로 로그인하여 새로운 애플리케이션과 입찰 플레이스먼트를 자동으로 생성하고 Google AdMob 플랫폼에서 필요한 모든 구성 설정을 가져옵니다.
- 매뉴얼 - 레벨플레이와 Google AdMob 플랫폼 간에 이동하여 필요한 정보를 검색하고 입력하십시오.
자동 설정
- 레벨플레이 계정에 로그인하고 레벨플레이 측 바 > 설정 > 네트워크로 이동합니다.
- 사용 가능한 광고 네트워크 목록에서 Google AdMob을 선택합니다.
- Google 로그인을 선택하고 승인된 Google 계정으로 로그인합니다.
- 이미 로그인한 경우 재설정 로그인을 선택합니다**(새 로그인 필요)**
- 로그인 후 Google 자동 설정 입찰자 토글
- 이제 인스턴스 페이지로 이동하여 인터스티셜 광고, 보상형 광고 또는 배너 광고를 게재할 앱을 선택합니다.
- AdMob 플랫폼에서 새 앱과 입찰 플레이스먼트를 자동으로 생성하고 광고 유닛 ID를 임포트하려면 Add Bidder를 선택합니다. 앱에 이미 연결된 앱 ID가 있는 경우 광고 유닛 ID 파라미터 값이 없는 플레이스먼트가 1개 이상 있는 경우 자동 설정 툴을 사용할 수 있습니다. 이 경우 새 입찰 플레이스먼트가 생성됩니다.
- 저장을 선택하여 모든 구성을 승인하고 승인합니다. 저장하지 않고 모듈을 닫으면 데이터를 레벨플레이 플랫폼으로 임포트하지 않고 AdMob 플랫폼에서 에셋이 생성됩니다.
Google 입찰자 인스턴스의 상태는 광고 형식별로 Ironsource Ads 입찰자의 상태와 동일합니다. 예를 들어 보상형 광고 광고에 Ironsource 광고 입찰자를 사용하지 않는 경우 Google 네트워크에서 자동으로 활성화되지 않습니다.
매뉴얼 설정
- 레벨플레이 계정에 로그인하고 레벨플레이 측 바 > 설정 > 네트워크로 이동합니다.
- 사용 가능한 광고 네트워크 목록에서 Google AdMob을 선택합니다.
- AdMob이 레벨플레이 SDK를 연동할 활성화하다, 사용 가능하다 있도록 레벨플레이 네트워크 설정 모듈에 다음 데이터를 입력합니다.
데이터 | Description |
|---|---|
| App ID | Admob 대시보드에서 앱에 할당된 고유 ID입니다. |
| 광고 유닛 ID | Admob 대시보드에서 앱의 광고 유닛에 할당된 고유 ID입니다. |
| Client ID | 계정과 광고 유닛 간의 관계를 지정하는 고유 식별자. |
| 클라이언트 비밀 | 클라이언트 ID와 페어링되는 비밀 키 |
| 갱신 토큰 | 클라이언트 애플리케이션 이미 수신한 새로고침 토큰. |
이 AdMob 파라미터를 레벨플레이 연동하려면 다음 지침을 참고하십시오.
App ID
- 앱 ID를 검색하려면 Admob 플랫폼의 왼쪽 바에 있는 '앱' 탭으로 이동하여 앱 설정을 선택합니다. 그러면 애플리케이션 설정과 앱 ID가 표시됩니다.
Ad Unit ID
- Ad Unit ID Ad Unit ID를 가져오려면 Admob 플랫폼의 왼쪽 바 있는 '앱' 탭으로 이동하여 Ad Units를 선택합니다. 그러면 애플리케이션 광고 유닛과 광고 유닛 ID가 표시됩니다.
Client ID and Client Secret
- 클라이언트 ID 및 클라이언트 비밀을 가져오려면 Google의 API 관리자로 이동합니다.
- 페이지 왼쪽 상단의 API Project 드롭다운을 선택하고 Create a project를 선택하거나 이 앱에 대해 이미 생성한 프로젝트를 선택합니다. 이 목적으로 새 프로젝트를 생성하는 경우 다이얼로그 상자에 Project name, Billing account 및 Location을 입력하고 Create를 선택합니다.
- 왼쪽 사이드바에서 Credentials를 선택한 다음 OAuth consent screen 탭을 선택합니다.그런 다음 Product Name을 입력하고 Save를 선택합니다.
- 왼쪽 사이드바에서 Dashboard를 선택하고 활성화하다, 사용 가능하다 APIs and Services**로 이동합니다.
- 다음으로 **AdMob API 활성화하다, 사용 가능하다.
- 왼쪽 사이드바에서 Credentials 탭을 선택합니다. Create Credentials 드롭다운을 선택하고 OAuth 클라이언트 ID를 선택합니다.
- Web 애플리케이션을 선택하고 앱 이름을 입력합니다. 아래 필드에는 최소 하나의 Authorized 리디렉트 URI에 대해 https://developers.google.com/oauthplayground를 입력해야 합니다. 예제는 아래와 같습니다.
- 승인된 JavaScript 원점:
https://YOUR_NAMESPACE **(Optional)** - 승인된 리디렉트 URI: https://developers.google.com/oauthplayground
- Create를 선택하면 클라이언트 ID와 클라이언트 Secret이 표시됩니다.
Refresh Token
- Refresh 토큰을 가져오려면 **[OAuth 2.0 Playground](https://developers.google.com/oauthplayground/#step1\&scopes=https%3A//www.googleapis.com/auth/adwords\&url=https%3A//\&content_type=application/json\&http_method=GET\&useDefaultOauthCred=checked\&oauthEndpointSelect=Google\&oauthAuthEndpointValue=https%3A//accounts.google.com/o/oauth2/auth\&oauthTokenEndpointValue=https%3A//www.googleapis.com/uth2/v3/token_include\&dentiethAuthEndpointValue=https%3A//accounts.com/o/oauth2/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth.
- 오른쪽 상단의 설정 아이콘을 선택합니다. 힘 approval 프롬프트 체크박스를 선택 선택 해제 Use your own OAuth credentials를 선택합니다. 클라이언트 ID와 클라이언트 Secret을 입력.
- 다음으로 1단계: APIS를 선택하고 권한을 부여합니다. **https://www.googleapis.com/auth/admob.report**를 입력하고 **권한을 부여합니다.**를 선택합니다.
- AdMob 데이터에 대한 프로젝트 액세스, 접근 권한 부여
- 그런 다음 1단계의 권한 부여, 인증 코드를 수신하면 Exchange 권한 부여, 인증 code for tokens 버튼을 선택할 수 있습니다. 그런 다음 **Refresh 토큰 액세스, 접근 토큰 받게 됩니다.
- 이 모든 파라미터를 얻은 후 레벨플레이 Google AdMob 계정 설정에 입력합니다.
- 다음으로 Instances 페이지로 이동합니다 페이지 상단에서 Unity 레벨플레이 Mediation Google 입찰을 실행할 앱을 선택합니다.
- Ad Networks의 설정 목록에서 Google을 선택하고 도구 정의 아이콘을 선택합니다. 그런 다음 앱 ID와 광고 유닛 ID를 인터스티셜 광고, 보상형 광고 비디오 또는 배너 설정에 삽입합니다.
4단계. 빌드 Admob 어댑터 추가
V17.0.0부터 **(어댑터 버전 4.3.1 이상)**에는 퍼블리셔가 앱의 Android 매니페스트에 AdMob 앱 ID를 태그의 자식으로 추가해야 합니다.
<application/><meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="[ADMOB_APP_ID]"/>
"ADMOB_APP_ID"를 3단계에서 가져온 APP ID 값으로 대체합니다.
-
allprojects > repositories 차단 안에 다음 줄이 있는지 확인합니다.allprojects { repositories { flatDir { dirs 'libs' } google() }}
-
종속성 차단 다음 종속성을 추가합니다.dependencies { implementation 'com.unity3d.ads-mediation:admob-adapter:5.11.0' implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1'}
Android
레벨플레이 SDK는 Gradle 종속성과 매뉴얼 다운로드 메커니즘을 모두 지원합니다.
Admob 어댑터를 Gradle과 연동하려면
-
앱 모듈의 Gradle다음 Maven URL이 있는지 확인합니다. 모든 어댑터에는 한 번만 표시되어야 합니다.repositories { google() mavenCentral()}
-
어댑터의 Maven 이름을 앱 모듈의 빌드.gradle 스크립트에 추가합니다.dependencies { implementation 'com.unity3d.ads-mediation:admob-adapter:5.11.0' implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1'}
매뉴얼 다운로드 통해 Admob 어댑터 연동하는 방법
-
Admob 어댑터 다운로드: 빌드 Admob 어댑터 추가합니다. 여기에서 최신 Admob 어댑터를 찾을 수 있습니다. 중요! Admob 어댑터 Admob SDK가 포함되어 있지 않습니다. Admob SDK를 추가로 직접 추가해야 합니다.
-
Admob 어댑터를 프로젝트에 추가합니다. 어댑터를 다운로드한 후에는 Android 프로젝트의 libs 폴더에 Admob 어댑터 상자를 놓습니다.

-
Gradle 빌드 파일의 종속성 섹션 아래에 다음을 추가해야 합니다.dependencies { implementation 'com.unity3d.ads-mediation:admob-adapter:5.11.0' implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1'}
5단계 AndroidManifest.xml 업데이트
레벨플레이 Android SDK 버전 6.17.0(AdMob Android 어댑터 버전 4.3.10 이상)부터 AdMob 어댑터는 AAR로 릴리스됩니다. Jar 연동을 유지하려는 경우 매니페스트 추가합니다.
매니페스트 사용 권한:
<uses-permission android:name="android.permission.INTERNET"/><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
매니페스트 활동: manifestAdditions의 태그 안에 다음 활동을 추가합니다.
<application><activity android:name="com.google.android.gms.ads.AdActivity"android:configChanges="keyboard|keyboardHidden|방향, 방향 설정 |screenLayout|uiMode|screenSize|smallestScreenSize" android:theme="@android:style/Theme.Translucent" />
V17.0.0부터 **(어댑터 버전 4.3.1 이상)**에는 퍼블리셔가 앱의 Android 매니페스트에 AdMob 앱 ID를 태그의 자식으로 추가해야 합니다.
<application></application><meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="[ADMOB_APP_ID]"/>
3단계에서 가져온 APP ID 값으로 를 교체합니다. 이렇게 하지 않으면 AdMob의 SDK로 인해 크래시가 발생합니다. 자세한 내용은 AdMob의 가이드를 참조하십시오.
[ADMOB_APP_ID]6단계. 추가 단계
자식 지향 설정 - COPPA
Unity 레벨플레이 Mediation 사용하면 퍼블리셔가 AdMob 자식 다이렉트 설정을 AdMob 네트워크에 직접 전달할 수 있습니다. 이 기능은 레벨플레이 SDK 6.14.0 이상의 AdMob Android 어댑터 4.3.9 이상을 사용하여 활성화된, 사용 가능한 수 있습니다.
다음 구문을 사용하여 AdMob setTagForChildDirectedTreatment를 파라미터 TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE로 설정합니다.
LevelPlay.setMetaData("AdMob_TFCD","true");
다음 구문을 사용하여 AdMob setTagForChildDirectedTreatment를 파라미터 TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE로 설정합니다.
LevelPlay.setMetaData("AdMob_TFCD","false");
AdMob 네트워크에서 자식 지정 설정에 대해 자세히 알아보려면 여기를 방문하십시오.
동의 연령 미만의 사용자 - GDPR
Unity 레벨플레이 Mediation 사용하면 퍼블리셔가 AdMob 네트워크, 즉 TFUA(유럽 동의 연령)에서 사용자용 태그 요청과 통신할 수 있습니다. 이 기능은 레벨플레이 SDK 6.14.0 이상의 AdMob Android 어댑터 4.3.9 이상을 사용하여 활성화된, 사용 가능한 수 있습니다.
다음 구문을 사용하여 TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE로 setTagForUnderAgeOfConsent를 설정합니다.
LevelPlay.setMetaData("AdMob_TFUA","true");
다음 구문을 사용하여 TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE로 setTagForUnderAgeOfConsent를 설정합니다.
LevelPlay.setMetaData("AdMob_TFUA","false");
AdMob 네트워크에서 동의 연령 미만의 사용자에 대해 자세히 알아보려면 여기를 방문하십시오.
광고 콘텐츠 필터링
Unity 레벨플레이 Mediation 사용하면 퍼블리셔가 AdMob 네트워크와 커뮤니케이션하여 모든 광고 요청에 대한 최대 광고 콘텐츠 등급을 제공할 수 있습니다. 이 기능은 레벨플레이 SDK 7.12.0 이상의 AdMob Android 어댑터 4.3.23 이상을 사용하여 활성화된, 사용 가능한 수 있습니다.
maxAdContentRating을 설정하려면 다음 구문 사용합니다.
LevelPlay.setMetaData("AdMob_MaxContentRating","MAX_AD_CONTENT_RATING_G");
이 프로퍼티 대한 가능한 값은 Google에서 정의한 디지털 콘텐츠 레이블 분류에 기반합니다.
- MAX_AD_CONTENT_RATING_G
- MAX_AD_CONTENT_RATING_PG
- MAX_AD_CONTENT_RATING_T
- MAX_AD_CONTENT_RATING_MA
Ad Content Rating Under 네트워크에 대해 자세히 알아보려면 여기를 방문하십시오.
콘텐츠 URL 매핑 지원
Unity 레벨플레이는 앱용 Google 콘텐츠 매핑을 지원하며, "Google_Content_Mapping" 설정을 사용하여 URL을 공유할 수 있습니다. 이 기능은 레벨플레이 SDK 7.7.0 이상의 AdMob 어댑터 4.3.41 이상을 사용하여 활성화된, 사용 가능한 수 있습니다. Google의 콘텐츠 매핑에 대해 자세히 알아보기 여기.
단일 콘텐츠 URL을 전달 다음 구문 사용하십시오.
LevelPlay.setMetaData("Google_Content_Mapping","https://www.example.com");
여러 URL을 지원하려면 동일한 키를 사용하고 최대 4개의 URL을 공유하십시오.
LevelPlay.setMetaData("Google_Content_Mapping",["https://www.example1.com","https://www.example2.com"]);
광고 네트워크 통합 확인
레벨플레이 SDK는 Mediation 통합이 성공적으로 완료되었는지 확인하는 간편한 방법을 제공합니다. 레벨플레이와 추가 광고 네트워크의 통합을 확인하려면 이 문서를 따르십시오.
이제 애플리케이션 내에서 Admob Ads를 제공할 수 있습니다.
다음 단계
Unity 레벨플레이 통해 추가 광고 네트워크를 활용하려면 어댑터를 연동하고 Unity 연동 가이드를 따르십시오.