审核/退出弹出窗口

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

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

以下是顯示兩種類型的審查彈出行動過程的流程圖。

這是一個彈出窗口，指導用戶使用 Hive 界面前往市場，鼓勵他們留下評分和評論。Hive 評論彈出窗口可以使用提供的默認彈出窗口，也可以自定義為不同的界面。

設定類型	描述
預設設定	提供的預設彈出窗口
自訂設定	自訂 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 原生评审弹出窗口同时使用。

根據Apple提供的政策，將顯示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: Implement the app exit functionality
                // 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);    
             // 虛幻引擎用戶    
             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 原生評價彈出窗口¶

結束彈出窗口¶

退出彈出條件¶

顯示退出彈出窗口