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

このプロモーションは、ゲーム内で使用するためのゲームレビューのポップアップとゲーム退出のポップアップを提供します。ゲーマーからのポジティブな評価やユーザーレビューは、他のユーザーがゲームを使用する決定に影響を与えます。誘引ポップアップを提供することで、ユーザーエンゲージメントが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++KotlinJavaスウィフト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呼び出しが成功しました
        }
}));

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 のレビューポップアップを表示¶

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