Hive AdKit은 Hive SDK와 개별모듈 유저가 AD(X)에서 제공하는 Unity 패키지를 적용하는 과정에 발생하는 오류를 수정하고, 사용의 편의를 돕기 위해 제작된 광고모듈입니다. Hive AdKit을 지원하는 버전과 적용 방법을 아래에서 차근차근 살펴보세요.

  • 최소 지원 버전
    • Hive SDK v4.14.4.0
    • Hive SDK v4.14.4.0 KS
    • Hive SDK v1.18.3.0
    • 개별모듈 Peppermint Android v2.9.2
    • 개별모듈 Peppermint iOS v2.8.4

Unity와 Cocos2D-X 환경을 지원합니다.

최신 다운로드

배포일 다운로드
2021-10-27 HiveAdKit_v1.2.3_for_CPP.zip

릴리즈 노트

V1.2.3 (Oct 27, 2021)

  • ADX-Unity 1.10.3 버전으로 업데이트
    • ADXLibrary-Android 1.17.1 버전 추가
    • ADXLibrary-iOS 1.9.4 버전으로 업데이트
    • AdMob-Unity 6.1.2
    • MoPub-Unity 5.18.0
    • FBSDKCoreKit-Basic.Framework 동적 라이브러리 자동 적용 기능 추가
  • SKAdNetwork ID 갱신

V1.2.2 (Aug 10, 2021)

ADX-Unity 1.10.1 버전으로 업데이트

  • ADXLibrary-Android-adx-library-standard 1.17.0.3 버전 추가
  • ADXLibrary-iOS 1.9.1 버전으로 업데이트
  • AdMob-Unity 6.0.1
    • googleads-mobile-unity/ChangeLog.txt 링크
    • Interstitial 타입 광고와 Adaptive Banner 타입 광고에서 사용하던 OnAdLeavingApplication 이벤트 제거 및 OnPaidEvent 이벤트로 대체
    • Interstitial 타입 광고와 Adaptive Banner 타입 광고에서 사용하던 onAdFailedToLoadOld 이벤트 제거 및 onAdFailedToLoad 이벤트로 통합
    • AdMob-Unity 라이브러리는 소스코드 버전에서 배포된 라이브러리 버전 사용
  • MoPub-Unity 5.17.0
    • Unity 2019.3 이상에서 iOS 타겟 빌드 시 영향을 주는 오류 수정

V1.2.1 (Jun 9, 2021)

  • [All] LoadAd 또는 Show API 사용 시 입력한 AdPlacement 값이 LoadShow 이벤트 이외에 전송되지 않는 오류 수정
  • [Android] ADXLibrary-Android-adx-library-standard 1.16.2 추가
  • [iOS] AD(X)Library-iOS 1.8.7 적용

V1.2 (Mar 25, 2021)

  • [All] Admob에서 지원하고 AD(X)에서 최적화한 새 배너 타입 Interstitial Ads, Adaptive Banner를 새롭게 추가. Reward Video 타입 기능 개선

V1.1.3 (Feb 8, 2021)

  • [Android] AD(X) Android 1.16.2 적용
  • [iOS] AD(X) iOS 1.8.5 적용
  • [CPP] Firebase C++ SDK v7.0.1 적용

 

적용하기

개발 환경 구축

  • Android
    Prebuilt-Firebase-Library와 포함된 Hive AdKit SourceCode를 빌드하여 사용할 수 있습니다. Android Studio 3.0 이상 버전에서 빌드하기를 권장합니다.

    1. ExternalNativeBuild
      • #ndk-build를 사용할 경우
      • #cmake를 사용할 경우
    2. build.gradle 파일에 아래 내용을 추가합니다.
    3. AdMob-AdManager Service를 이용하는 AD(X), ADOP를 활용할 경우, AndroidManifest.xml 파일에 아래 내용을 추가합니다.
    4. AD(X)를 활용할 경우 build.gradle 파일에 아래 내용을 추가합니다.
  • iOS
    Firebase-Framework와 포함된 AdKit SourceCode를 빌드하여 사용할 수 있습니다.

    1. HIVEAdKit/srcHIVEAdKit/include 폴더를 끌어서 놓기(Drag-and-drop) 동작으로 XCode 프로젝트에 포함시킵니다.
      • .cpp, .hpp, .mm 파일을 모두 포함시킵니다.
      • Hive AdKit 코드는 Bridge 코드이며, 실제 사용을 목적으로 제공합니다.
    2. Project > Build Settings > Search Paths > Framework Search PathHIVEAdKit/firebase_cpp_sdk/frameworks/ios/universal 경로를 추가합니다.
    3. Project > Build Settings > Search Paths > Header Search PathHIVEAdKit/firebase_cpp_sdk/include 경로를 추가합니다.
    4. Project > Build Settings > Other Flags에 -framework “firebase”와 -framework “firebase_admob”를 추가합니다.
    5. CocoaPods 설정으로 아래 내용을 추가합니다.
    6. AD(X)를 사용할 경우 CocoaPods 설정으로 아래 내용을 추가합니다.
    7. Xcode에서 iOS의 최신 SDK를 다운로드 진행을 위해서는 하기 커맨드를 수행이 필요합니다.
  • 적용 예제에는 AdMob의 테스트 광고 키가 설정되어 있습니다.
  • 제공 기능

    Hive AdKit C++에서 제공하는 Reward Video API를 Hive SDK 또는 개별모듈과 함께 사용하는 경우, 호출된 RewardVideo API에 따라서 로그 정보 전송 여부가 결정됩니다. 로그 정보는 Hive 애널리틱스 서버로 전송되며 해당 기능을 지원하는 최소 버전은 다음과 같습니다. Hive SDK나 개별모듈이 포함되지 않거나 초기화되지 않았을 경우에는 동작하지 않습니다.

    • Hive SDK v4.11.0
    • Hive SDK v1.17.2
    • 개별모듈 ModuleManager v2.6.0
    • 개별모듈 CommonModule v1.5.0

    아래는 Hive AdKit 활용 가이드입니다.

    AdMob 초기화

    모든 타입의 광고를 초기화, 로딩, 노출하기 전 필수적으로 수행해야 하는 단계입니다.

    Rewarded 타입 광고

    Interstitial 타입 광고

    Adaptive Banner 타입 광고

     

    iOS 14 업데이트

    iOS 14 이상 버전에 대응하는 AD(X)의 SKAdNetwork 목록입니다. 2021년 01월 29일 진행된 업데이트를 기준으로 AdKitPostprocess가 작성되었습니다. 수시 업데이트되는 항목이니 잊지 말고 확인해주세요.

    Unity Integrate Notice

    1. Unity 엔진 2019.4 이상 버전에서 ADXUnityPackage 1.10.0 이상 버전 연동 시, 아래 내용을 실행합니다.
      • Unity 에디터에서 Assets > External Dependency Manager > iOS Resolver > Settings에서 Add use_frameworks! to Podfile을 체크 후 Link frameworks statically를 체크하고 저장합니다.
      • iOS 프로젝트의 Targets > Build Phases > Embed Frameworks에 OMSDK_Mopub.xcframework (Pods/mopub-ios-sdk/Frameworks/OMSDK_Mopub.xcframework)를 추가합니다.
      • Unity 엔진 2019.4 이상 버전에서 ADXUnityPackage 1.10.3 이상 버전 연동 시, Targets > Build Phases > Embed FrameworksFBSDKCoreKit_Basics.xcframework (Pods/FBSDKCoreKit_Basics/XCFrameworks/FBSDKCoreKit_Basics.xcframework)를 추가합니다.
    2. GoogleMobileAdsSettings에 입력한 App ID가 삭제되는 경우 Unity > Assets > Google Mobile Ads > Settings에서 Delay app measure를 체크 후 다시 해제하여 주시기 바랍니다.

     

    이슈 확인하기

    Cocos2D-X 환경에서 개발하는 경우, Cocos2D-X 엔진 내 포함된 FlatBuffers 라이브러리와 Firebase에 포함된 라이브러리에서 중복이 발생합니다. 이를 방지하려면 FlatBuffers 라이브러리를 빌드에 포함시키지 않거나 Firebase 오픈소스 라이브러리를 직접 빌드하는 방법이 있습니다. Firebase는 아래에 언급한 오픈소스 라이브러리를 포함하고 있으니 중복이 발생할 경우 Firebase 오픈소스 라이브러리를 이용해 직접 빌드하기를 권장합니다.

    • Curl
    • FlatBuffers
    • libuv
    • Nanopb
    • uWebSockets
    • Zlib

     

    적용/포함된 라이브러리 버전 (Hive AdKit v1.2.3 기준)

    • ADXLibrary
      • ADXLibrary-Unity 1.10.3
      • ADXLibrary-Android 1.17.1
        • ADXLibrary-Android-rewarded-video 1.17.1
        • ADXLibrary-Android-adx-library-standard 1.17.1
        • ADXLibrary-Android-adx-library-base 1.17.1
      • ADXLibrary-iOS 1.9.4
      • ADXLibrary-iOS-FBAudienceNetwork 1.9.4
      • ADXLibrary-iOS-UnityAds 1.9.4
      • ADXLibrary-iOS-Vungle 1.9.4
      • ADXLibrary-iOS-Pangle 1.9.4
      • ADXLibrary-iOS-Cauly 1.9.4
    • AdMob-Unity 6.1.2
      • AdMob-Android 20.2.0
      • AdMob-iOS 8.11.0
    • MoPubSDK-Unity 5.18.0
      • MoPubSDK-Android 5.18.0
      • MoPubSDK-iOS 5.18.2
    • Facebook Audience Network-Android 6.6.0
    • Facebook Audience Network-iOS 6.7.0
    • Vungle-Android 6.10.2
    • Vungle-iOS 6.10.3
    • UnityAds-Android 3.7.5
    • UnityAds-iOS 3.7.5
    • Cauly-Android 3.5.20
    • Caluy-iOS 3.1.14
    • AdPieSDK-Android 1.9.2
    • AdPieSDK-iOS 1.2.10
    • AdFit-Android 3.8.5
    • AppLovin-iOS 10.3.6
    • AppLovin-Android 10.3.3
    • Fyber-iOS 7.9.0
    • Fyber-Android 7.8.4
    • Pangle-iOS 3.9.0.4