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

プロモーションはゲームレビューのポップアップとゲーム終了のポップアップを提供します。

レビューポップアップ: ユーザーがストアでゲームを評価するためのポップアップ
ネイティブレビューポップアップ: ユーザーがゲーム内でゲームを評価するためのポップアップ
- Android用ゲーム内レビューポップアップ
- iOS用ネイティブレビューポップアップ
終了ポップアップ: ユーザーがゲームを終了する前に表示されるポップアップ（Androidのみ）

レビューポップアップは、ユーザーがGoogle PlayストアやApple App Storeなどのストアで評価やレビューを残すことを促します。Hive SDK v1.16.2およびv4.11.0から、Hive SDKを使用すると、ゲームごとにレビューポップアップのフレーズをカスタマイズできます。レビューポップアップのテキストやポップアップUIもカスタマイズでき、レビューポップアップにストアのURLをリンクすることを忘れないでください。

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

Hive SDKは、ゲームレビューのポップアップの条件を以下のように提案します:

ゲームの初回プレイから5分以内にレビューポップアップを表示します。
ユーザーがステージクリアや報酬などの素晴らしい結果を達成したときにレビューポップアップを表示します。
何度もポップアップを表示することが推奨されますが、ユーザーがゲームをプレイするのを妨げてはいけません。

Note

GoogleとAppleは、報酬を提供することでユーザーからの評価やレビューを引き寄せることを禁止されています。また、Googleは特に報酬に言及することを禁止しています。

レビューポップアップは次のように機能します:

ユーザーが閉じる（ボタンX）をクリックすると、レビューポップアップは同じデバイスで再表示されません。
ユーザーが後でボタンをクリックすると、レビューポップアップは同じデバイスで再表示されることができます。
アプリのバージョンがアップグレードされると、すでに評価やレビューを拒否したユーザーに対してレビューポップアップが再表示されます。
ポリシーに従って、ゲームスタジオはレビューポップアップの表示条件とカウントを実装する必要があります。

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

レビューポップアップの例

レビューのポップアップを表示するには、showReview()メソッドをPromotionクラスで呼び出します。基本スタイルまたはカスタムスタイルのアプリ内レビューのポップアップは、HiveコンソールのPromotion > App Settingsの設定に応じて表示されます。（Hive開発者からのOpration > 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 call success
        }
}));

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のバージョンv.4.15.1から、Android環境でゲームを使用するユーザーは、ゲームが実行中にレビューを残す機能を提供します。既存のレビューポップアップとは異なり、マーケットに行くことなく満足度を評価でき、レビューリクエストに応じると、すぐに執筆ページに移動します。Androidの星評価ポップアップは、Googleが提供するポリシーに従って表示されます。

Warning

PromotionクラスのshowNativeReview()メソッドの実装は、現在Google Playストアでのみ利用可能です。Hive SDKは、AndroidマーケットとOneStoreにレビューのポップアップを実装し、後でリリースされる予定です。

レビューのポップアップを表示するかどうかは、Googleの内部ポリシーに従って決定され、手動で表示を変更することはできません。
アプリIDがGoogleマーケットの使用に設定されている場合、Google PlayストアがインストールされたAndroid 5.0（APIレベル21）以上のAndroidデバイスで表示される可能性があります。
ユーザーのプライバシーを強化し、APIの悪用を防ぐために、Googleガイドの内容に従ってAPIを呼び出すことをお勧めします。
開発中のビルドでも、表示はGoogleの内部ポリシーに従って決定され、常に表示を設定するには、対応するGoogleガイドを参照してください。

Android用ゲーム内レビューポップアップを表示¶

Android用のゲーム内レビューポップアップの例

iOS向けのネイティブレビューポップアップは、ユーザーがiOSのゲームで評価やレビューを書くことを促します。このポップアップは、ゲームユーザーがページを切り替えることなく、ゲームの評価を星でクリックしたり、レビューを追加したりできるようにします。ゲームレビューポップアップとは異なり、インゲームレビューポップアップは、ユーザーがレビューを書くボタンをクリックした直後に執筆ページを表示します。Hive SDKは、iOS向けのネイティブレビューポップアップの条件を以下のように提案しています:

Hive が提供するゲームレビューポップアップと、iOS用のネイティブレビューポップアップを同時に使用できます。
各ゲーム用にゲームレビューポップアップがカスタマイズされている場合、iOS用のネイティブレビューポップアップは同時に使用できません。

ゲーム内レビューポップアップは、Appleのポリシーに従って公開されています。Hive SDK v1.16.0以降、またはv4.10.0以降で実行することを確認してください。

表示順序、テキスト、またはUIをカスタマイズすることはできません。
各ゲームは、デバイスごとに年に3回ポップアップを表示します。ポップアップの表示はAppleの内部ポリシーに従うため、カスタマイズすることはできません。
iOS 10.3以降のバージョンで動作します。
ユーザーがデバイス上でアプリの制限を有効にするを無効の状態に設定した場合、ポップアップを表示することはできません。
開発中のビルドはポップアップを表示することが無制限であり、市場に評価を提出することはできません。
TestFlightを使用して配布されたアプリでは利用できません。

このAPIがAndroidまたはiOSで呼び出され、ゲーム内レビューをサポートしていないバージョンの場合、レビューのポップアップは通常通り表示されます。表示の条件はゲームレビューのポップアップと同じです。

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];

このポップアップは、ユーザーがゲームを終了したいかどうか、またゲームの推奨を受けたいかどうかを確認します。

Note

Androidのみポリシーの問題により、終了ポップアップが提供されています。

Note

ゲームページをm.withhive.comにリンクし、終了ポップアップを実装する際に「もっとゲーム」ボタンを使用すると、カスタムビューは使用できず、ユーザーのデバイスのインターネットブラウザを介してURLを使用する必要があります。

退出ポップアップの条件¶

Android用のアプリを構築するためのガイドラインによると、ユーザーがゲームをプレイしている間に戻るボタンをタップすると、ゲームは前のページに戻る必要があります。したがって、ユーザーが戻るボタンをタップした場合、戻るページがなくなるまで前のページに戻り、その後、ゲームを終了するか続行するかのポップアップを表示します。通常、ユーザーがゲームロビーにいるときです。

終了ポップアップを表示¶

Hive ゲームのおすすめでポップアップを閉じる例

退出ポップアップを表示するには、PromotionクラスのshowExit()メソッドを呼び出します。ユーザーが退出ポップアップが表示された後に退出ボタンをクリックすると、promotionEventTypeにPromotionEventType.EXITが割り当てられます。以下は退出ポップアップを表示する例のコードです。

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);    
         }    
});

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

レビュー ポップアップ¶

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

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

Android用ゲーム内レビューポップアップの条件¶

Android用ゲーム内レビューポップアップを表示¶

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

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

終了ポップアップ¶

退出ポップアップの条件¶

終了ポップアップを表示¶

レビューポップアップ¶