查看/退出弹出窗口

该促销为游戏提供了游戏评测弹窗和游戏退出弹窗。玩家的正面评分和用户评论会影响其他用户对游戏的参与度。众所周知，提供诱导弹窗可以使用户参与度提高5到10倍。您可以使用Hive提供的功能，或直接在游戏中实现这些功能并链接到市场网址。

弹出类型	描述
Hive 评价弹出窗口	一个鼓励用户在下载游戏应用的市场中留下评分和评论的弹出窗口。
原生评价弹出窗口 (Android/iOS)	一个鼓励用户在游戏内立即留下评分和评论而不转到市场的弹出窗口。

下面是一个流程图，展示了两种类型的审查弹出操作的过程。

这是一个弹出窗口，指导用户使用 Hive 界面前往市场，并鼓励他们留下评分和评论。Hive 评论弹出窗口可以使用提供的默认弹出窗口，也可以根据界面使用进行自定义。

设置类型	描述
默认设置	提供的默认弹出窗口
自定义设置	自定义用户界面弹出窗口

Note

在配置Hive评论弹窗时，您需要将应用市场的URL链接（您可以在应用市场中评分和撰写评论的位置的链接）插入到弹窗中。

Hive 评审弹窗条件¶

Hive SDK中审核弹窗的推荐条件如下。

在用户安装后首次启动游戏的5分钟内显示评价提示
当用户在游戏中有积极体验时显示（例如，关卡通关，奖励发放）
建议多次显示，但不应给用户带来不适

Note

谷歌和苹果禁止提供激励措施以鼓励高评分，尤其是谷歌禁止提及任何激励措施。

Hive 评审弹窗的功能如下。

如果用户点击关闭 (X)按钮，则评论弹出窗口将不会在同一设备上再次显示。
如果用户点击稍后提醒我按钮，则评论弹出窗口可能会在同一设备上再次显示。
如果应用版本更改，则将再次向已经参与或拒绝的用户显示。
显示评论弹出窗口的条件和显示次数必须根据Hive的条件直接在游戏中实现。

Hive 评价弹窗显示¶

Hive 评价弹出截图

要显示 Hive 评价弹窗，请调用 Promotion 类的 showReview() 方法。根据在控制台 Promotion > App Settings 中配置的设置，将显示默认样式或自定义样式的评价弹窗。（请参阅开发者网站上的 Operation > Promotion > App Settings）

Unity虚幻引擎C++KotlinJavaSwiftObjective-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 商店时应用。

审核弹窗的可见性由谷歌的内部政策决定，无法随意更改。
如果应用程序 ID 与谷歌市场关联，则可以在安装了 Google Play 商店的 Android 设备上显示。
为了增强用户隐私保护并防止 API 滥用，建议根据Google Play 应用内审核 API指南调用 API。
可见性还由谷歌对开发中构建的内部政策决定。要设置持续可见性，请参考谷歌提供的应用内审核测试指南。

显示 Android 原生评论弹窗¶

安卓原生评论弹窗截图

Hive SDK 提供了一项功能，允许在 iOS 环境中使用游戏的用户在游戏运行时留下评论。与现有的评论弹出窗口不同，它允许在不转到市场的情况下进行满意度评估，如果您响应评论请求，您将直接进入写作页面。使用 iOS 原生评论弹出窗口的条件如下。

即使您使用Hive中常见的评论弹出窗口，它也可以与iOS本机评论弹出窗口同时使用。
如果您使用在游戏中开发的自定义评论弹出窗口，则无法与iOS本机评论弹出窗口同时使用。

根据苹果提供的政策，将显示iOS原生审核弹窗。

曝光顺序、文本、用户界面等不能随意更改
每个设备在每个应用中每年仅显示3次弹出窗口，显示受苹果内部政策的限制，因此不允许随意更改
如果用户在设备设置中禁用（关闭）应用内评分和评论选项，则不会显示
在开发中的构建中，无论曝光次数如何，总是会显示，但评分无法提交到市场
使用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。以下是显示退出弹出窗口的示例代码。由于苹果政策，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);    
             // 虚幻引擎用户    
             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 原生评价弹窗¶

结束弹出¶

退出弹出条件¶

显示退出弹窗