AdKit Unity for DARO¶
AdKit Unity for DAROは、DARO APIを適用して開発されたUnity向け広告モジュールです。SDKまたは個別モジュールと併用すると、ログがAnalyticsサーバーに送信されるため、個別の広告分析作業を省略できます。また、Hive SDKユーザーがDARO提供のUnityパッケージを適用する際に発生するエラーを解消し、試行錯誤を減らすことができます。
このガイドでは、AdKit Unity for DAROのインストール方法、OSごとのUnity環境の事前設定方法、機能別の使用方法について説明します。
インストールまたは更新¶
初めてDARO用のAdKitを使用する場合は、次の順序でインストールしてください。
また、既存のAdKitインストールを更新したい場合は、既存のインストール済みバージョンを削除し、次の順序でDARO用の最新バージョンのAdKitをインストールしてください。
- 最新版のAdKitをDARO用にダウンロードしてインストールします。
-
Unityのツールバーで、Assets > Import Package > Custom Package...に移動し、.unitypackageファイルを選択してImportをクリックします。
-
インポート完了後、Hive AdKitおよびDARO関連のファイルとフォルダーがAssetsフォルダー内に作成されていることを確認してください。

-
ダウンロードして、EDM4Uの最新バージョンをインストールしてください。 EDM4UはHive SDK v4に含まれています。Hive SDK v4を使用している場合は、このステップをスキップしてください。
削除¶
DAROのためにHive AdKitを削除するには、Unityプロジェクト内の以下のフォルダーを削除してください:
- Assets/HIVEAdKit
- Assets/HIVEAdKit_Example
前提条件の設定¶
AdKit for DAROのインストールが完了したら、適用に必要な事前設定としてOSごとのDAROキー値を追加し、ビルド設定を確認します。
Android¶
AndroidベースのUnityプロジェクトに、DAROダッシュボードからダウンロードしたキー値を追加します。
- ダウンロードした_android-daro-key.txt_ファイルを_HIVEAdKit/Plugins/Android_フォルダーにコピーします。
- _android-daro-key.txt_ファイルは、DAROダッシュボード - Apps画面の'Key File'にあるDownloadをクリックしてダウンロードできます。
- gradleTemplate.propertiesに次のように
daroAppKeyを追加します。daroAppKeyは、DAROダッシュボード - Apps画面の'DARO App Key'で確認できます。
iOS¶
iOSベースのUnityプロジェクトに、DAROダッシュボードからダウンロードしたキー値を追加します。
- ダウンロードした_ios-daro-key.txt_ファイルを_HIVEAdKit/Plugins/iOS_フォルダーにコピーします。
- _ios-daro-key.txt_ファイルはDAROダッシュボードからダウンロードできます。
- _HIVEAdKit/Editor/iOSAdKitPostBuildProcessor.cs_ファイルで、次のようにコメントアウトされている
Google AdMob appIdとDaro App Keyのコメントを解除し、値を入力します。// Set GADApplicationIdentifier (Please contact Daro for your own ADMOB APPID) //rootDict.SetString("GADApplicationIdentifier", "YOUR GOOGLE ADMOB APPID"); // Set DaroAppKey (Please contact DARO for your own Daro App Key) //rootDict.SetString("DaroAppKey", "YOUR Daro App Key");Google AdMob appIdとDaro App KeyはDAROダッシュボードからダウンロードできます。
iOSビルド設定の確認¶
iOSプロジェクトをビルドすると、Dynamic Frameworkとして動作するUnityFrameworkターゲットが作成されます。
-
EDM4Uを設定します(1.2.179基準)。 UnityのiOS Resolver Settings(Assets > External Dependency Manager > iOS Resolver > Settings)で、static_frameworkビルドが設定されていることを確認します。
-
プロジェクトをビルドします。ビルド完了後、生成されたプロジェクトのルートパスでPodfileを開き、設定を確認します。
Warning
AdKit Unityを適用した本番サービスをビルドする前に、Assets/HIVEAdKit_Exampleフォルダーを必ず削除してください。HIVEAdKit Exampleの設定が含まれる場合があります。
DARO Proguard 設定¶
ProguardルールはライブラリAARファイルに含まれて配布されるため、別途設定しなくても自動的に適用されます。
使用ガイド¶
AdKit Unity for DAROの機能を使用するための設定方法とAPI呼び出し方法を説明します。
AdKitの初期化¶
- アプリがヨーロッパおよび英国(EEA & UK)地域を対象とする場合、GDPR同意ポップアップを表示するために
ShowConsentUIAPIを呼び出してからAdKitを初期化します。国内でのみサービスを提供する場合は、HIVEAdKit.InitializeAPIを呼び出して直接初期化します。
次のサンプルコードのように、HIVEAdKitクラスが提供するすべてのAPIはUnityのメインスレッドから呼び出す必要があります。
using hive.adkit.daro;
// Call GDPR popup
public void ShowGDPR(string noticeId)
{
HIVEAdKit.ShowConsentUI(noticeId, () =>
{
initSdk();
});
}
// Hive AdKit initialization
public void initSdk()
{
HIVEAdKit.Initialize(isSuccess =>
{
if (isSuccess)
Debug.Log("AdKit SDK initialization successful!");
else
Debug.Log("AdKit SDK initialization failed!");
});
}
コールバックの使用¶
コールバック関数を使用するには、HIVEAdKit.InitPluginを呼び出してAdKitCallbackManagerをGameObjectとして登録する必要があります。
アプリの起動時にStartコードブロック内で呼び出します。
using hive.adkit.daro;
void Start()
{
HIVEAdKit.InitPlugin(); // Create game object for Hive AdKit callback registration
}
追加情報の設定¶
追加情報を設定できます。実装コードは以下の通りです:
using hive.adkit.daro;
[Serializable]
public class SendInfo
{
public int level;
public int gold;
}
SendInfo addtionalInfo = new SendInfo();
public void SetAdditionalInfo()
{
addtionalInfo.level = 1;
addtionalInfo.gold = 100;
// Send as JSON Object format
HIVEAdKit.SetAdditionalInfo(JsonUtility.ToJson(addtionalInfo));
}
リワード広告機能¶
一定時間以上広告を視聴すると報酬が付与されるリワード広告機能を提供します。一度に読み込める広告は1つのみです。実装コードは以下のとおりです。
using hive.adkit.daro;
private HIVEAdKit.RewardVideo RewardVideoAd = null;
public void InitRewardedAd()
{
// Set Event Callback
EventHandlers eventHandlers = new EventHandlers.Builder()
.OnAdLoaded(OnRewardVideoAdLoadedCB)
.OnAdOpening(OnRewardVideoAdOpeningCB)
.OnAdClosed(OnRewardVideoAdClosedCB)
.OnAdFailed(OnRewardVideoAdFailedCB)
.OnAdReward(OnRewardVideoAdRewardCB)
.OnAdClick(OnRewardVideoAdClickCB)
.OnAdPaidEvent(OnRewardVideoAdPaidEventCB)
.Build();
// Create RewardVideoAd Instance
RewardVideoAd = HIVEAdKit.RewardVideo.Initialize(rewardVideoUnitId, eventHandlers);
}
public void LoadRewardedAd()
{
// Load RewardVideoAd
HIVEAdKit.RewardVideo.Load(RewardVideoAd, "Unity-RewardVideo-Load-AdPlacementInfo");
}
public void ShowRewardedAd()
{
// Show RewardVideoAd
if( HIVEAdKit.RewardVideo.IsLoaded(RewardVideoAd) ) {
HIVEAdKit.RewardVideo.Show(RewardVideoAd, "Unity-RewardVideo-Show-AdPlacementInfo");
}
}
public void DestroyRewardedAd()
{
// Destroy RewardVideoAd
HIVEAdKit.RewardVideo.Destroy(RewardVideoAd);
RewardVideoAd = null;
}
インタースティシャル広告機能¶
全画面を占有するインタースティシャル広告機能を提供します。実装コードは以下の通りです:
using hive.adkit.daro;
private HIVEAdKit.Interstitial InterstitialAd = null;
public void InitRewardedAd(string unitId)
{
// Set Event Callback
EventHandlers eventHandlers = new EventHandlers.Builder()
.OnAdLoaded(OnInterstitialAdLoadedCB)
.OnAdOpening(OnInterstitialAdOpeningCB)
.OnAdClosed(OnInterstitialAdClosedCB)
.OnAdFailed(OnInterstitialAdFailedCB)
.OnAdClick(OnInterstitialAdClickCB)
.OnAdPaidEvent(OnInterstitialAdPaidEventCB)
.Build();
// Create InterstitialAd Instance
InterstitialAd = HIVEAdKit.Interstitial.Initialize(unitId, eventHandlers);
}
public void LoadInterstitialAd()
{
// Load InterstitialAd
HIVEAdKit.Interstitial.Load(InterstitialAd, "Unity-Interstitial-Load-AdPlacementInfo");
}
public void ShowInterstitialAd()
{
// Show InterstitialAd
if( HIVEAdKit.Interstitial.IsLoaded(InterstitialAd) ) {
HIVEAdKit.Interstitial.Show(InterstitialAd, "Unity-Interstitial-Show-AdPlacementInfo");
}
}
public void DestroyInterstitialAd()
{
// Destroy InterstitialAd
HIVEAdKit.Interstitial.Destroy(InterstitialAd);
InterstitialAd = null;
}
バナー広告機能¶
画面の一部を占めるバナー広告機能を提供します。BannerPositionを入力することで、バナーの位置を画面の上部または下部に調整できます。
バナー広告はOnAdClosed()コールバックを受け取りません。
using hive.adkit.daro;
private HIVEAdKit.Banner BannerAd = null;
public void InitBannerAd(string unitId)
{
// Set Event Callback
EventHandlers eventHandlers = new EventHandlers.Builder()
.OnAdLoaded(OnBannerAdLoadedCB)
.OnAdFailed(OnBannerAdFailedCB)
.OnAdClick(OnBannerAdClickCB)
.OnAdPaidEvent(OnBannerAdPaidEventCB)
.Build();
BannerAd = HIVEAdKit.Banner.Initialize(unitId, BannerPosition.Bottom, eventHandlers);
}
public void LoadBannerAd()
{
// Automatic Load & Show BannerAd
HIVEAdKit.Banner.Load(BannerAd, "Unity-Banner-Load-AdPlacementInfo");
}
public void DestroyBannerAd()
{
// Destroy BannerAd
HIVEAdKit.Banner.Destroy(BannerAd);
BannerAd = null;
}
DAROの適用事例¶
Planet ExploreはDAROの広告モジュールを使用して、バナー広告とインタースティシャル広告を最適化して配信しています。Planet Exploreをダウンロードして、DARO広告を実際に適用した事例を直接ご確認ください。




