Hive Adkit for AD(X): Unity

Hive AdKit is an advertisement module which fixes errors occurred in processing AD(X) Unity package and supports user convenience. Read this page one by one for using Hive AdKit as well as support SDK.

Installation

Access Hive Developers and download and apply AdKit.

  1. Download the latest version of AdKit from Hive Developers and unzip it here.
  2. In the Unity toolbar, select .unitypackage file under Assets > Import Package > Custom Package and click Import.

  3. After import completion, check if Hive AdKit and AD(X) related files and folders are created under the Assets folder.

Update

Uninstall the AdKit you are using and install the latest version to update.

How to Use

iOS (Unity 2019.4 and higher)

When you build an iOS project on Unity 2019.4 and higher, Unity generates the UnityFramework target that behaves with DynamicFramework.

  1. Setting EDM4U (Based on 1.2.171)
    Make sure that set up to build static_framwork in iOS Resolver Settings (menu: Assets > External Dependency Manager > iOS Resolver > Settings) of Unity editor.
  2. Check the settings of Podfile by using an editor.
  3. Perform a procedure of Xcode settings.

 

Features

  • Rewarded type
    • AD(X) does not provide an API for advertisement exposure but informs to follow the AdMob guide.
    • Sending log is determined depending on the called RewardVideo API if Hive AdKit API and Hive SDK are in use. Log data is sent to Hive Analytics server, and the minimum version which supports this feature is as follows.
      • Hive SDK v4.11.0
  • Interstital type
  • Adaptive banner type

For details how to use Hive AdKit, read the following guide.

Initializing Hive AdKit

Required step before initializing, loading and showing all types of advertisement (AD)

European and UK Targeting

If your game targets Europe and the UK (EEA & UK), it is required to display a GDPR (General Data Protection Regulation) consent popup. Hive Adkit supports Google‘s UMP (User Messaging Platform) for displaying the GDPR consent popup. To use Google UMP, first, refer to the GDPR Message Creation Guide to compose your GDPR message.

After completing the GDPR message composition, initialize Hive Adkit with InitializeWithShowADXConsent as follows:

 

When initializing Hive AdKit, if the targeted region is identified as Europe and the UK (EEA & UK), the GDPR consent screen will automatically be displayed as shown below.

Targeting Other Regions

When your game targets regions outside of Europe and the UK, initialize it with InitializeWithSetConsentState.

Advanced Settings

Rewarded type

Interstitial type

Adaptive Banner type

Supporting iOS 14

Following is SKAdNetwork list of AD(X) for supporting iOS 14 and later version. AdKitPostprocess is based on the update on January 29, 2021. Don’t forget to check the latest update.

Supporting Android 11

A tag <queries> is added to the AndroidManifest.xml file of AD(X) library by supporting Android 11. If you check the error log as follows while building your project on Unity, refer to the guidelines to build with UnityAndroid 11.

  • Sample error log on Unity

ADX Proguard Setting

The library AAR file includes the rule of Proguard, so that the setting carries out automatically.
 

Unity Integrate Notice

If the App ID on GoogleMobileAdsSettings is removed, go to Unity > Assets > Google Mobile Ads > Settings and select the Delay app measurement checkbox, then clear it again.

 

Gradle & Gradle Plug-in version configuration

We recommend Gradle 6.7.1 or a newer version for Hive Adkit 1.4.4 or higher. If you use lower Gradle versions for Hive Adkit 1.4.4 or higher, you may encounter “This feature requires ASM7” error from AdMob Unity plug-in, which can be resolved through one of the following solutions.

  • Change Gradle and Gradle Plug-in version (the recommended solution)
  • Update Unity engine
  • Annotate android.enableDexingArtifactTransform=false

 

For how to change Gradle and Gradle Plug-in version (to Gradle 6.7.1+, to Gradle Plugin 4.2.0+), refer to the steps below.

  1. Change to use Custom Base Gradle Template.
    • Check Build Settings > Project Settings > Player > Custom Base Gradle Template.
    • Assets/Plugins/Android/baseProjectTemplate.gradle will be generated.
  2. Change Gradle Plug-in version. Open Assets/Plugins/Android/baseProjectTemplate.gradle file and change the version like this: com.android.tools.build:gradle:4.2.0
  3. Download Gradle. Gradle 6.7.1 can be downloaded at here. After downloading it, unzip the downloaded file at the place you want (example: ~/Users/honggd/gradle-6.7.1).
  4. Change the Gradle installation path in Unity.
    1. Uncheck Preferences > External Tools > Gradle Installed with Unity.
    2. Set the installation path to the direactory you unzipped the downloaded Gradle file (example: ~/Users/honggd/gradle-6.7.1).
  5. Make sure that Player > Other Settings > Identification > Target API Level is 33 or higher, and build your project.

Test Ads

It is important for advertiser not to be charged when test ad is clicked in development. If you click ads too much out of test mode, it is regarded as invalid action. Therefore, be aware not to be a target account to report. Refer to the Google Developers to use a test ad.
 

Uninstallation

To uninstall Hive AdKit for AD(X), delete the following list of files and folders.

    • Related to Hive AdKit
      • /Assets/HIVEAdKit
      • /Assets/HIVEAdKit_Example
    • Related to AD(X)
      • /Assets/ADXLibrary
      • /Assets/GoogleMobilesAds
      • /Assets/MoPub
      • /Assets/Plugins/Android/GoogleMobileAdsPlugins