이 가이드에서는 Google 모바일 광고 SDK를 사용하여 미디에이션을 통해 i-mobile에서 광고를 로드하고 표시하는 방법을 보여주며, 폭포식 구조 통합에 대해 다룹니다. 광고 단위의 미디에이션 구성에 i-mobile을 추가하는 방법과 i-mobile SDK 및 어댑터를 Unity 앱에 통합하는 방법에 대해서도 다룹니다.
i-mobile용 대시보드 인터페이스는 라벨, 버튼, 설명에 일본어 텍스트를 사용합니다. 이 가이드의 스크린샷은 번역되지 않았습니다. 그러나 이 가이드의 설명 및 안내에서 라벨과 버튼은 괄호 안에 영어에 해당하는 것과 함께 번역됩니다.
지원되는 통합 및 광고 형식
i-mobile용 Ad Manager 미디에이션 어댑터에는 다음과 같은 기능이 있습니다.
통합 | |
---|---|
입찰 | |
폭포 | |
형식 | |
배너 | |
전면 광고 | |
리워드 제공됨 |
요구사항
- Unity 5.6 이상
- 최신 Google 모바일 광고 SDK
- Android에 배포하려면 다음 단계를 따르세요.
- Android API 수준 19 이상
- iOS에 배포하는 방법
- iOS 배포 대상 12.0 이상
- Google 모바일 광고 SDK로 구성된, 작동하는 Unity 프로젝트 자세한 내용은 시작하기를 참고하세요.
- 미디에이션 시작 가이드를 완료합니다.
1단계: i-mobile UI에서 구성 설정
サイト/アプに管 (사이트/애플리케이션 관리) 탭과 앱 플랫폼 버튼을 클릭하여 i-mobile 대시보드에 앱을 추가합니다.
Android
iOS
양식을 작성하고 新規設 (Sign up) 버튼을 클릭하세요.
Android
iOS
새 광고 스팟을 만들려면 サイト/アプ管 (사이트/애플리케이션 관리) 탭에서 앱을 선택합니다.
Android
iOS
広告ット管ン (광고 스팟 관리) 탭으로 이동하여 新規広告スス動ット (신규 광고 지점) 버튼을 클릭합니다.
그런 다음 広告ット名 (광고 스팟 이름), 広告ットサイズ (광고 스팟 크기) 및 기타 세부정보를 제공하여 양식을 작성합니다. 그런 다음 新規設 (Sign up) 버튼을 클릭합니다.
새 광고 스팟이 준비되었습니다. 통합 세부정보를 보려면 アプ設件動得 (Get App settings) 버튼을 클릭합니다.
【ホホテテーID (게시자 ID), 건너뛴 문서 ID (미디어 ID), ヰトID (Spot ID)를 기록해 두세요. 이러한 매개변수는 나중에 Ad Manager UI에서 미디에이션을 위해 i-mobile을 구성할 때 필요합니다.
Android
iOS
2단계: UI에서 i-모바일 수요 Ad Manager 설정
광고 단위에 대한 미디에이션 설정 구성
3단계: i-mobile SDK 및 어댑터 가져오기
변경 로그의 다운로드 링크에서 i-mobile용 Google 모바일 광고 미디에이션 플러그인의
최신 버전을 다운로드하고
zip 파일에서 GoogleMobileAdsIMobileMediation.unitypackage
를 추출합니다.
Unity 프로젝트 편집기에서 Assets(애셋) > Import Package(패키지 가져오기) > Custom Package(맞춤 패키지)를 선택하고 다운로드한 GoogleMobileAdsIMobileMediation.unitypackage
파일을 찾습니다. 모든 파일이 선택되었는지 확인하고 Import를 클릭합니다.
그런 다음 Assets(애셋) > Play Services Resolver(Play 서비스 리졸버) > Android Resolver(Android 리졸버) > Force Resolve(강제 해결)를 선택합니다. Unity Play 서비스 리졸버 라이브러리는 처음부터 종속 항목 해결을 실행하고 선언된 종속 항목을 Unity 앱의 Assets/Plugins/Android
디렉터리에 복사합니다.
4단계: 추가 코드 필요
Android
i-mobile 통합에는 추가 코드가 필요하지 않습니다.
iOS
SKAdNetwork 통합
i-mobile 문서에 따라
프로젝트의 Info.plist
파일에 SKAdNetwork 식별자를 추가하세요.
5단계: 구현 테스트
테스트 광고 사용 설정
Ad Manager i-mobile은 테스트용 테스트 Spot ID, 미디어 ID, 게시자 ID를 제공하며 여기에서 확인할 수 있습니다.
테스트 광고 확인
i-mobile에서 테스트 광고를 수신하고 있는지 확인하려면 광고 검사기에서 i-mobile (Waterfall) 광고 소스를 사용하여 단일 광고 소스 테스트를 사용 설정하세요.
오류 코드
어댑터가 i-mobile에서 광고를 수신하지 못하는 경우 게시자는
다음 클래스에서 ResponseInfo
를
사용하여 광고 응답의 기본 오류를 확인할 수 있습니다.
Android
형식 | 클래스 이름 |
---|---|
배너 | com.google.ads.mediation.imobile.IMobileAdapter |
전면 광고 | com.google.ads.mediation.imobile.IMobileAdapter |
네이티브 | com.google.ads.mediation.imobile.IMobileMediationAdapter |
iOS
형식 | 클래스 이름 |
---|---|
배너 | IMobileAdapter |
전면 광고 | IMobileAdapter |
네이티브 | GADMediationAdapterIMobile |
다음은 광고 로드에 실패할 때 i-mobile 어댑터에서 발생하는 코드와 함께 표시되는 메시지입니다.
Android
오류 코드 | 이유 |
---|---|
0-99 | i-mobile SDK에서 오류를 반환했습니다. 자세한 내용은 코드를 참고하세요. |
101 | i-mobile은 광고를 로드하려면 Activity 컨텍스트가 필요합니다. |
102 | UI에 구성된 i-mobile 서버 매개변수가 Ad Manager 누락되거나 잘못되었습니다. |
103 | 요청한 광고 크기가 i-mobile 지원 배너 크기와 일치하지 않습니다. |
104 | i-mobile의 네이티브 광고 로드 성공 콜백이 빈 네이티브 광고 목록을 반환했습니다. |
iOS
오류 코드 | 이유 |
---|---|
0-10 | i-mobile SDK에서 오류를 반환했습니다. 자세한 내용은 코드를 참고하세요. |
101 | UI에 구성된 i-mobile 서버 매개변수가 Ad Manager 누락되거나 잘못되었습니다. |
102 | 요청한 광고 크기가 i-mobile 지원 배너 크기와 일치하지 않습니다. |
103 | i-mobile이 광고를 표시하지 못했습니다. |
104 | i-mobile에서 빈 네이티브 광고 배열을 반환했습니다. |
105 | i-mobile이 네이티브 광고 애셋을 다운로드하지 못했습니다. |
106 | i-mobile은 동일한 Spot ID를 사용하는 여러 전면 광고에 대한 요청을 지원하지 않습니다. |
i-mobile Unity 미디에이션 플러그인 변경 로그
버전 1.3.2
- 어댑터 콘텐츠를
GoogleMobileAds/Mediation/IMobile/
로 이동했습니다. - i-mobile Android 어댑터 버전 2.3.1.1을 지원합니다.
- i-mobile iOS 어댑터 버전 2.3.2.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 8.1.0으로 빌드 및 테스트되었습니다.
버전 1.3.1
- i-mobile Android 어댑터 버전 2.3.0.0을 지원합니다.
- i-mobile iOS 어댑터 버전 2.3.0.1을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 7.4.1로 빌드 및 테스트되었습니다.
버전 1.3.0
- i-mobile Android 어댑터 버전 2.3.0.0을 지원합니다.
- i-mobile iOS 어댑터 버전 2.3.0.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 7.3.1로 빌드 및 테스트되었습니다.
버전 1.2.2
- i-mobile Android 어댑터 버전 2.0.23.1을 지원합니다.
- i-mobile iOS 어댑터 버전 2.2.0.1을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 7.0.2로 빌드 및 테스트되었습니다.
버전 1.2.1
- i-mobile Android 어댑터 버전 2.0.23.0을 지원합니다.
- i-mobile iOS 어댑터 버전 2.2.0.1을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 7.0.0으로 빌드 및 테스트되었습니다.
버전 1.2.0
- i-mobile Android 어댑터 버전 2.0.23.0을 지원합니다.
- i-mobile iOS 어댑터 버전 2.2.0.0을 지원합니다.
버전 1.1.0
- i-mobile Android 어댑터 버전 2.0.22.2를 지원합니다.
- i-mobile iOS 어댑터 버전 2.1.0.1을 지원합니다.
버전 1.0.2
- i-mobile Android 어댑터 버전 2.0.22.0을 지원합니다.
- i-mobile iOS 어댑터 버전 2.0.32.0을 지원합니다.
버전 1.0.1
- i-mobile Android 어댑터 버전 2.0.21.0을 지원합니다.
- i-mobile iOS 어댑터 버전 2.0.31.0을 지원합니다.
버전 1.0.0
- 첫 출시!
- i-mobile Android 어댑터 버전 2.0.20.1을 지원합니다.
- i-mobile iOS 어댑터 버전 2.0.29.0을 지원합니다.