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

このプロモーションは、ゲーム内で使用するためのゲームレビューのポップアップとゲーム退出のポップアップを提供します。ゲーマーからのポジティブな評価やユーザーレビューは、他のユーザーがゲームを使用する決定に影響を与えます。ガイド付きポップアップを提供することで、ユーザーエンゲージメントが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の内部ポリシーに従うため、任意に変更できません
ユーザーがデバイス設定でアプリ内評価とレビューオプションを無効にした場合、表示されません
開発中のビルドでは、露出回数に関係なく常に表示されますが、評価を市場に提出することはできません
TestFlightを使用して配布されたアプリは表示されません

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

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

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

UnityC++アンリアルエンジンKotlinJavaSwiftObjective-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 のレビューポップアップを表示¶