レビュー/終了ポップアップ

このプロモーションは、ゲーム内で使用するためのゲームレビューのポップアップとゲーム退出のポップアップを提供します。ゲーマーからのポジティブな評価やユーザーレビューは、他のユーザーのゲームへの関与に影響を与えます。誘引ポップアップを提供することで、ユーザーの参加を5倍から10倍に増加させることができることが知られています。Hiveが提供する機能を使用するか、ゲーム内に直接実装してマーケットURLにリンクすることができます。

ポップアップタイプ	説明
Hive レビューポップアップ	ユーザーがゲームアプリをダウンロードしたマーケットで評価とレビューを残すことを促すポップアップです。
ネイティブレビューポップアップ (Android/iOS)	ユーザーがマーケットに移動することなく、ゲーム内で即座に評価とレビューを残すことを促すポップアップです。

以下は、2種類のレビューポップアップアクションのプロセスを示すフローチャートです。

これは、Hive UIを使用してユーザーをマーケットに導き、評価やレビューを残すよう促すポップアップです。Hiveレビューのポップアップは、提供されたデフォルトのポップアップを使用するか、UI用にカスタマイズすることができます。

設定タイプ	説明
デフォルト設定	提供されたデフォルトポップアップ
カスタム設定	カスタムUIポップアップ

Note

Hiveレビューのポップアップを設定する際には、ポップアップにアプリマーケットのURLリンク（アプリマーケットで評価やレビューを書くことができる場所へのリンク）を挿入する必要があります。

Hive レビューポップアップ条件¶

Hive SDKのレビューポップアップの推奨条件は以下の通りです。

インストール後にユーザーがゲームを初めて起動してから5分以内にレビューのプロンプトを表示する
ユーザーがゲーム内で良い体験をしたとき（例：ステージクリア、報酬獲得）に表示する
複数回表示することが推奨されるが、ユーザーに不快感を与えないようにするべき

Note

GoogleとAppleは、高評価を促すためのインセンティブを提供することを禁止しており、特にGoogleはインセンティブに関する言及を禁止しています。

Hiveレビューのポップアップの機能は次のとおりです。

ユーザーが閉じる (X)ボタンをクリックすると、レビューのポップアップは同じデバイスで再表示されません。
ユーザーが後でリマインドボタンをクリックすると、レビューのポップアップは同じデバイスで再表示される可能性があります。
アプリのバージョンが変更されると、すでに参加または辞退したユーザーに再表示されます。
レビューのポップアップを表示する条件と表示回数は、Hive の条件に従ってゲーム内で直接実装する必要があります。

Hive レビューポップアップ表示¶

Hive のレビューポップアップスクリーンショット

Hiveレビューのポップアップを表示するには、PromotionクラスのshowReview()メソッドを呼び出します。コンソールのPromotion > App Settingsで設定された内容に応じて、デフォルトスタイルまたはカスタムスタイルのレビューのポップアップが表示されます。（開発者サイトのOperation > Promotion > App Settingsを参照してください）

UnityアンリアルエンジンC++コトリンJavaスウィフトObjective-C

APIリファレンス: Promotion .showReview

using hive;    
    Promotion.showReview((ResultAPI result, PromotionEventType viewEventType) => {    
    if (result.isSuccess()) {    
    // call successful    
    }    
});

#include "HivePromotion.h"

FHivePromotion::ShowReview(FHivePromotionViewDelegate::CreateLambda([this](const FHiveResultAPI& Result, const EHivePromotionEventType& PromotionEventType) {
        if (Result.IsSuccess()) {
                // API call succeeded
        }
}));

APIリファレンス: Promotion ::showReview

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    Promotion::showReview([=](ResultAPI const & result, PromotionEventType viewEventType) {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

APIリファレンス: Promotion.showReview

import com.hive.Promotion    
    import com.hive.ResultAPI    
    Promotion.showReview(object : Promotion.PromotionViewListener {    
         override fun onPromotionView(result: ResultAPI, promotionEventType: Promotion.PromotionViewResultType) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

APIリファレンス: Promotion .INSTANCE.showReview

import com.hive.Promotion;    
    import com.hive.ResultAPI;    
    Promotion.INSTANCE.showReview((result, promotionEventType) -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

APIリファレンス: PromotionInterface .showReview

import HIVEService    
    PromotionInterface.showReview() { result, viewResultType in    
    if result.isSuccess() {    
    // call successful    
    }    
}

APIリファレンス: HIVEPromotion showReview

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEPromotion showReview: ^(ResultAPI *result, HIVEPromotionViewResultType viewResultType) {    
         if ([result isSuccess]) {    
             // API call successful    
         }    
}];

これは、ユーザーがアプリマーケットに移動することなく、アプリ内で瞬時に評価やレビューを残すことを可能にするポップアップです。

Hive SDKは、Android環境でゲームを使用しているユーザーがゲームをプレイ中にレビューを残すことを可能にする機能を提供します。既存のレビューポップアップとは異なり、マーケットに移動することなく満足度評価を行うことができ、レビューリクエストに応じると、直接執筆ページに移動します。Androidネイティブレビューのポップアップは、Googleが提供するポリシーに従って以下のように表示されます。

Warning

プロモーションクラスのshowNativeReview()メソッドは、Google Playストアを使用する際に適用できます。

レビューのポップアップの表示はGoogleの内部ポリシーによって決定されており、恣意的に変更することはできません。
アプリIDがGoogleマーケットにリンクされている場合、Google PlayストアがインストールされたAndroidデバイスに表示できます。
ユーザーのプライバシー保護を強化し、APIの悪用を防ぐために、Google Play In-App Review APIガイドに従ってAPIを呼び出すことをお勧めします。
表示は、開発中のビルドに対するGoogleの内部ポリシーによっても決定されます。常に表示を設定するには、Googleが提供するIn-App Review Testingガイドを参照してください。

Androidネイティブレビューのポップアップを表示¶

Androidネイティブレビューポップアップスクリーンショット

Hive SDKは、iOS環境でゲームを使用しているユーザーがゲームを実行中にレビューを残すことを可能にする機能を提供します。既存のレビューポップアップとは異なり、マーケットに移動することなく満足度評価を行うことができ、レビューリクエストに応じると、直接執筆ページに移動します。iOSネイティブレビューポップアップを使用するための条件は以下の通りです。

Hiveで一般的に提供されるレビューポップアップを使用しても、iOSネイティブレビューポップアップと同時に使用することができます。
ゲーム内で開発されたカスタムレビューポップアップを使用する場合、iOSネイティブレビューポップアップと同時に使用することはできません。

Appleが提供するポリシーに従って、iOSのネイティブレビューのポップアップが表示されます。

表示順序、テキスト、UIなどは恣意的に変更できません
ポップアップは各アプリでデバイスごとに年に3回のみ表示され、表示はAppleの内部ポリシーに従うため、恣意的な変更は許可されていません
ユーザーがデバイス設定でアプリ内評価とレビューオプションを無効（OFF）にすると、表示されません
開発中のビルドでは、露出回数に関係なく常に表示されますが、評価はマーケットに提出できません
TestFlightを使用して配布されたアプリは表示されません

iOSネイティブレビューポップアップの表示¶

iOSネイティブレビューポップアップのスクリーンショット

ネイティブレビューのポップアップを表示するには、PromotionクラスのshowNativeReview()メソッドを呼び出します。

UnityC++アンリアルエンジンKotlinJavaスウィフトObjective-C

APIリファレンス: Promotion .showNativeReview

using hive;    

Promotion.showNativeReview();

APIリファレンス: Promotion ::showNativeReview

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    

Promotion::showNativeReview(NULL);

#include "HivePromotion.h"

FHivePromotion::ShowReview(FHivePromotionViewDelegate::CreateLambda([this](const FHiveResultAPI& Result, const EHivePromotionEventType& PromotionEventType) {
        // ネイティブレビューコールバックはもはやサポートされていません
}));

APIリファレンス: Promotion.showNativeReview

import com.hive.Promotion    
    import com.hive.ResultAPI    

Promotion.showNativeReview()

API リファレンス: Promotion .INSTANCE.showNativeReview

import com.hive.Promotion;    
    import com.hive.ResultAPI;    

Promotion.INSTANCE.showNativeReview()

APIリファレンス: PromotionInterface.showNativeReview

import HIVEService    

PromotionInterface.showNativeReview()

APIリファレンス: HIVEPromotion showNativeReivew

#import <HIVEService/HIVEService-Swift.h>    

[HIVEPromotion showNativeReivew];

終了ポップアップは、ユーザーにゲームを終了するかどうかを尋ねるポップアップであり、Hiveを装備したゲームの推奨リストを受け取るかどうかの確認も求めます。

Note

iOSデバイスではポリシー上の理由からゲーム終了ポップアップは提供されておらず、Androidデバイスでのみ利用可能です。

Note

直接終了ポップアップを実装し、もっとゲームボタンを通じてm.withhive.comのゲームページに接続する場合、カスタムビューを使用することはできません。デバイスにインストールされたブラウザを通じてURLに移動する必要があります。

終了ポップアップ条件¶

Androidアプリ開発ガイドラインによると、ユーザーがゲームプレイ中にデバイスの戻るボタンに触れた場合、現在のページの前のページにナビゲートするように実装する必要があります。それに応じて、ユーザーがゲームプレイ中にデバイスの戻るボタンに触れた場合、ゲームは一時停止し、ユーザーにゲームを続けるか終了するかを尋ねる必要があります。戻るべき前のページがない場合は、終了ポップアップを表示します。通常、ユーザーがゲームロビーにいるときは、戻るべき前のページはありません。

終了ポップアップの表示

¶

ポップアップのスクリーンショットの終了

退出ポップアップを表示するには、PromotionクラスのshowExit()メソッドを呼び出します。退出ポップアップが表示された後、ユーザーが退出ボタンをクリックすると、promotionEventTypeにはPromotionEventType.EXITが割り当てられます。退出ポップアップを表示するための例のコードはこちらです。Appleのポリシーにより、iOSデバイスには退出ポップアップが提供されていないため、iOSの例のコードはありません。

UnityアンリアルエンジンC++KotlinJava

APIリファレンス: hive.Promotion.showExit

using hive;    

    hive.Promotion.showExit(ResultAPI result, PromotionEventType viewEventType) => {    
         if (!result.isSuccess()) {    
             return;    
         }    

         // 呼び出し成功    
         if (viewEventType == PromotionEventType.EXIT) {    
             //TODO:    
             // アプリ終了機能を実装    
             Application.Quit();    
         }    
});

#include "HivePromotion.h"

FHivePromotion::ShowExit(FHivePromotionViewDelegate::CreateLambda([this](const FHiveResultAPI& Result, const EHivePromotionEventType& PromotionEventType) {
        if (!Result.IsSuccess()) {
                return;
        }

        if (PromotionEventType == EHivePromotionEventType::EXIT) {
                // TODO: アプリ終了機能を実装する
                // 例えば) UKismetSystemLibrary::QuitGame(GetWorld(), nullptr, EQuitPreference::Quit, false);
        }
}));

APIリファレンス: Promotion::showExit

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    

    Promotion::showExit([=](ResultAPI result, PromotionEventType viewEventType) {    
         if (!result.isSuccess()) {    
             return;    
         }    

         // 呼び出し成功    
         if (viewEventType == PromotionEventType::EXIT) {    
             //TODO:    
             // アプリ終了機能を実装    
             // Cocos2d-xエンジンユーザー    
             exit(0);    
             // Unreal Engineユーザー    
             UKismetSystemLibrary::QuitGame(GetWorld(), nullptr, EQuitPreference::Quit, false);    
         }    
});

APIリファレンス: com.hive.Promotion.showExit

import com.hive.Promotion    
    import com.hive.ResultAPI    

    Promotion.showExit(object: Promotion.PromotionViewListener {    
         override fun onPromotionView(result: ResultAPI, promotionEventType: Promotion.PromotionViewResultType) {    
             if (!result.isSuccess) {    
                 return    
             }    

             // 呼び出し成功    
             if (promotionEventType == Promotion.PromotionViewResultType.NEED_TO_EXIT) {    
                 //TODO:    
                 // アプリ終了機能を実装    
                 exitProcess(0)    
             }    
         }    
})

APIリファレンス: Promotion.INSTANCE.showExit

import com.hive.Promotion;    
    import com.hive.ResultAPI;    

    Promotion.INSTANCE.showExit((result, promotionEventType) -> {    
         if (!result.isSuccess()) {    
             return;    
         }    

         // 呼び出し成功    
         if (promotionEventType == Promotion.PromotionViewResultType.NEED_TO_EXIT) {    
             //TODO:    
             // アプリ終了機能を実装    
             System.exit(0);    
         }    
});

レビュー/終了ポップアップ

Hive レビュー ポップアップ¶

Hive レビュー ポップアップ 条件¶

Hive レビュー ポップアップ表示¶

ネイティブレビューポップアップ¶

Androidネイティブレビューのポップアップ条件¶

Androidネイティブレビューのポップアップを表示¶

iOSネイティブレビューのポップアップ条件¶

iOSネイティブレビューポップアップの表示¶

ポップアップを終了¶

終了ポップアップ条件¶

終了ポップアップの表示

Hive レビューポップアップ¶

Hive レビューポップアップ条件¶

Hive レビューポップアップ表示¶