유니티 Google Play Billing API 8.0 업데이트: Unity IAP & AdMob 완벽 가이드

유니티 Google Play Billing API 8.0 업데이트: Unity IAP & AdMob 완벽 가이드

서론: 왜 지금 업데이트해야 할까요?

Google Play Store가 2025년 8월 31일부터 모든 신규 앱과 업데이트에 대해 Play Billing Library 7.0.0 이상의 버전을 의무화했습니다. 이는 인앱 결제(IAP)를 사용하는 모든 유니티 개발자들에게 중요한 변경사항입니다. 이 가이드에서는 기존 프로젝트를 최신 Google Play Billing Library 8.0.0에 맞춰 안전하게 업데이트하는 방법을 Unity IAP와 AdMob을 중심으로 자세히 설명합니다. 빌드 오류를 방지하고, 앱의 안정성을 확보하여 정책 위반 없이 성공적인 서비스를 운영하세요.

 

1. Unity IAP 업데이트: Play Billing 8.0.0 적용하기

가장 먼저 할 일은 유니티 인앱 결제 패키지를 최신 버전으로 업데이트하는 것입니다.

1. Unity Package Manager(UPM) 열기: 유니티 에디터 상단 메뉴에서 Window > Package Manager를 선택합니다.
2. 패키지 업데이트: Package Manager에서 In App Purchasing 패키지를 찾아 최신 버전(5.0.0 이상)으로 업데이트합니다. 여기서 보이는 "Update to 5.0.0"은 패키지 버전이며, 이 패키지 안에 Play Billing Library 5.0.0 이상이 포함되어 있습니다.
3. 코드 수정: 패키지를 업데이트하면 setOldSkuPurchaseToken과 같은 기존 API가 변경되거나 삭제되어 컴파일 오류가 발생합니다. Unity Console에 표시되는 오류 메시지를 참고하여 코드를 수정해야 합니다. 특히 정기 결제 관련 API의 변경사항을 꼼꼼히 확인하세요.
4. 테스트: 업데이트 후에는 반드시 Google Play Store의 내부 테스트 트랙을 통해 결제 기능이 정상적으로 작동하는지 확인해야 합니다.

2. AdMob 플러그인 업데이트: 호환성 및 정책 준수

Unity IAP만 업데이트하고 AdMob을 그대로 두면 종속성 충돌로 인해 빌드 오류가 발생할 수 있습니다. 또한 최신 광고 정책 및 규정을 준수하기 위해서도 AdMob 플러그인 업데이트는 필수입니다. 아래 꿀팁을 참고하여 안전하게 업데이트하세요.

1. 기존 AdMob 플러그인 제거 (핵심 꿀팁!):
   • 단순히 덮어쓰면 이전 버전의 잔여 파일이 남아 충돌을 일으킬 수 있습니다. 가장 안전한 방법은 기존 AdMob 플러그인 폴더를 삭제하는 것입니다.
   • Assets 폴더 내의 GoogleMobileAds 폴더를 삭제하세요.
2. 최신 AdMob 패키지 다운로드:
   • Google AdMob 공식 GitHub Releases 페이지에서 최신 .unitypackage 파일을 다운로드합니다.
3. 최신 패키지 임포트:
   • 다운로드한 파일을 유니티 프로젝트에 임포트합니다.
4. 광고 ID 설정:
   • 이전 버전과 달리, 최신 AdMob 플러그인에는 별도의 설정 파일이 없습니다. Assets > Google Mobile Ads > Settings 메뉴를 통해 AdMob 앱 ID를 설정하고, 광고 단위 ID는 C# 스크립트 파일에 직접 입력해야 합니다.
5. 외부 종속성 해결:
   • Assets > External Dependency Manager > Android Resolver > Force Resolve를 실행하여 AdMob과 IAP의 종속성 충돌을 자동으로 해결합니다. 이 과정에서 필요한 Google Play Billing Library도 호환되는 버전으로 정리됩니다. 이것을 실행해야 자동으로 종속성이 업데이트되니 절대 빼먹지 마세요!

3. iOS도 함께 업데이트해야 하는 이유

안드로이드 업데이트가 급하더라도 iOS 빌드도 함께 관리해야 합니다. 최신 Unity IAP 패키지는 iOS의 StoreKit을 최신 상태로 유지하며, AdMob 플러그인은 ATT(App Tracking Transparency) 프레임워크와 같은 Apple의 개인정보 보호 정책을 준수하는 데 필수적입니다. 두 플랫폼 모두 최신 버전으로 관리하는 것이 장기적인 안정성을 보장합니다.

 

4. 정리 및 요약

• Unity IAP: UPM에서 패키지를 최신 버전으로 업데이트하고, 코드의 변경된 API를 수정합니다.
• AdMob: 기존 GoogleMobileAds 폴더를 삭제하고, GitHub에서 최신 패키지를 다운로드해 임포트합니다.
• 광고 ID: Assets > Google Mobile Ads > Settings에서 앱 ID를, 스크립트에서 광고 단위 ID를 설정하세요.
• 종속성: 모든 Google 관련 플러그인을 업데이트한 후, External Dependency Manager를 통해 종속성을 해결하는 것이 핵심입니다.
• 플랫폼: 안드로이드뿐만 아니라 iOS 빌드도 함께 업데이트하여 모든 플랫폼의 안정성을 확보하세요.

이 가이드가 여러분의 앱 업데이트에 큰 도움이 되기를 바랍니다. 오류 없는 빌드, 안정적인 서비스로 성공적인 앱을 운영하세요!