审核/退出弹出窗口

該促銷提供遊戲評論彈出窗口和遊戲退出彈出窗口供遊戲使用。來自玩家的正面評價和用戶評論會影響其他用戶使用該遊戲的決定。已知提供引導彈出窗口可以將用戶參與度提高5到10倍。您可以使用Hive提供的功能，或直接在遊戲中實現它們並鏈接到市場網址。

彈出類型	描述
Hive 評論彈出窗口	一個彈出窗口，鼓勵用戶在下載遊戲應用的市場中留下評分和評論。
原生評論彈出窗口 (Android/iOS)	一個彈出窗口，鼓勵用戶立即在遊戲內留下評分和評論，而無需轉到市場。

以下是顯示兩種審核彈出行為過程的流程圖。

這是一個彈出窗口，通過 Hive UI 引導用戶到市場，鼓勵他們留下評分和評論。Hive 評論彈出窗口可以使用提供的默認彈出窗口，或者使用不同的 UI 進行自定義。

設定類型	描述
預設設定	預設提供的彈出視窗
自訂設定	自訂 UI 彈出視窗

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 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 應用內審查 API 指南來調用 API。
即使在開發中的版本中，可見性也是根據 Google 的內部政策決定的。要設置恆定的可見性，請參考 Google 提供的應用內審查測試指南。

顯示 Android 原生評論彈出窗口¶

Android 原生評價彈出截圖

Hive SDK 提供了一個功能，允許在 iOS 環境中使用遊戲的用戶在遊戲運行時留下評論。與現有的評論彈出窗口不同，滿意度評估可以在不移動到市場的情況下進行，如果您回應評論請求，您將直接進入寫作頁面。使用 iOS 原生評論彈出窗口的條件如下。

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

根據蘋果提供的政策，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。這裡有一個顯示退出彈出窗口的示例代碼。由於蘋果政策，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: Implement the app exit feature
                // e.g.) 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 原生評價彈出窗口¶

結束彈出視窗¶

退出彈出條件¶

顯示退出彈出窗口