TIL(Today I Learned)

유니티에 구글 애드몹 추가 후 발생할 수 있는 오류 및 해결 방법

1. 구글 모바일 광고 SDK 설치 오류

오류 설명: 구글 모바일 광고 SDK를 Unity에 설치할 때 Gradle 빌드 실패나 패키지 호환성 문제 등이 발생할 수 있습니다.

해결 방법:

최신 버전의 Unity 및 구글 모바일 광고 SDK 사용을 권장합니다.
Unity Package Manager를 통해 패키지를 추가할 때, 패키지 경로가 올바른지 확인합니다.

Gradle 버전을 확인하고, 필요한 경우 gradle-wrapper.properties 파일을 수정하여 호환되는 버전으로 설정합니다.

2. AndroidManifest.xml 충돌

오류 설명: 구글 애드몹을 통합할 때, 기존의 AndroidManifest.xml 파일과 충돌이 발생할 수 있습니다.

해결 방법:
Assets/Plugins/Android 폴더에 있는 AndroidManifest.xml 파일을 열어 중복된 항목이 없는지 확인합니다.

필요한 경우, 구글 애드몹 문서에서 제공하는 AndroidManifest.xml 예제를 참고하여 필요한 항목만 추가합니다.

3. 빌드 시 종속성 문제

오류 설명: 빌드 시 특정 라이브러리나 클래스가 누락되었다는 오류가 발생할 수 있습니다.

해결 방법:

Unity Editor에서 Assets > External Dependency Manager > Android Resolver > Resolve를 실행하여 모든 종속성이 올바르게 설정되었는지 확인합니다.

Assets > External Dependency Manager > Android Resolver > Force Resolve를 실행하여 강제로 종속성을 재설정합니다.

4. 광고 로드 실패

오류 설명: 광고를 요청했으나 로드되지 않는 경우가 발생할 수 있습니다.

해결 방법:

광고 단위 ID(Ad Unit ID)가 올바른지 확인합니다.
네트워크 연결 상태를 점검합니다.
로그를 확인하여 구체적인 오류 메시지를 파악하고, 구글 애드몹 문서에서 해당 오류에 대한 해결 방법을 찾아 적용합니다.

5. iOS 플랫폼에서의 오류

오류 설명: iOS 빌드 후 Xcode에서 빌드 오류가 발생할 수 있습니다.

해결 방법:

CocoaPods가 설치되어 있는지 확인하고, Podfile이 최신 상태인지 확인합니다.

pod install 명령을 실행하여 필요한 모든 CocoaPods 종속성이 설치되었는지 확인합니다.

Xcode 프로젝트 설정에서 Objective-C Bridging Header와 같은 필수 설정이 누락되지 않았는지 점검합니다.

이와 같은 오류들이 발생할 수 있으며, 각 오류에 대한 해결 방법을 적용하여 문제를 해결할 수 있습니다. 항상 최신의 SDK와 Unity 버전을 사용하는 것이 중요하며, 구글 애드몹 공식 문서를 참고하는 것도 많은 도움이 됩니다.

공식 문서

구글 애드몹 디벨로퍼
https://developers.google.com/admob/android/quick-start?hl=ko