审核/退出弹出窗口

促銷提供遊戲評論彈出窗口和遊戲退出彈出窗口。

評論彈出窗口：用戶在商店中對遊戲進行評價的彈出窗口
原生評論彈出窗口：用戶在遊戲中對遊戲進行評價的彈出窗口
- Android 的遊戲內評論彈出窗口
- iOS 的原生評論彈出窗口
退出彈出窗口：用戶退出遊戲前顯示的彈出窗口（僅限 Android）

評論彈出窗口鼓勵用戶在商店（如 Google Play 商店和 Apple App Store）留下評分和評論。從 Hive SDK v1.16.2 和 v4.11.0 開始，Hive SDK 讓您可以通過遊戲自定義評論彈出窗口上的短語。您還可以自定義評論彈出窗口的文本和彈出窗口 UI，並且不要忘記將商店 URL 與評論彈出窗口鏈接。

審查彈出窗口的條件¶

Hive SDK 建議的遊戲審查彈出窗口條件如下：

在遊戲首次播放後五分鐘內顯示評論彈出窗口。
當用戶在遊戲中取得顯著成就（例如關卡通過和獎勵）時顯示評論彈出窗口。
建議重複彈出幾次，但不應打擾用戶玩遊戲。

Note

谷歌和苹果被禁止通过提供奖励来吸引用户的评分和评论，而谷歌特别禁止提及奖励。

評價彈出窗口的功能如下：

如果用戶點擊關閉（按鈕X），則評論彈出窗口不會在同一設備上重新顯示。
如果用戶點擊稍後按鈕，則評論彈出窗口可以在同一設備上重新顯示。
如果應用版本升級，則評論彈出窗口將再次顯示給已經拒絕評估或評論遊戲的用戶。
根據政策，遊戲工作室應實施評論彈出窗口的顯示條件和次數。

顯示評論彈出窗口¶

評論彈出視窗的範例

要顯示評論彈出窗口，請調用Promotion類的showReview()方法。根據Hive控制台中Promotion > App Settings的設置，將顯示基本樣式或自定義樣式的應用內評論彈出窗口。（請參閱Hive開發者的Opration > 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 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 Market和OneStore的評價彈出窗口，將於稍後發布。

是否顯示評論彈出窗口是根據Google的內部政策決定的，無法手動更改曝光與否。
如果appId設置為使用Google市場，則可以在運行Android 5.0（API級別21）或更高版本的Android設備上顯示，並且安裝了Google Play商店。
為了增強用戶隱私並防止API濫用，建議根據Google指南中的內容調用API。
即使在開發中的版本中，曝光也是根據Google的內部政策決定的，並且要始終設置曝光，請參考相應的Google指南。

顯示遊戲內評價彈出窗口（Android）¶

Android 的遊戲內評價彈出窗口示例

iOS 的原生評價彈出窗口鼓勵用戶在 iOS 遊戲中評分和撰寫評價。這個彈出窗口允許遊戲用戶點擊星星來為遊戲打分或添加評價，而無需切換到市場頁面。與遊戲評價彈出窗口不同，遊戲內評價彈出窗口在用戶點擊 撰寫評價 按鈕後顯示寫作頁面。Hive SDK 建議 iOS 原生評價彈出窗口的條件如下：

可同時使用由 Hive 提供的遊戲評價彈出窗口和 iOS 的原生評價彈出窗口。
如果遊戲評價彈出窗口為每個遊戲自定義，則無法同時使用 iOS 的原生評價彈出窗口。

遊戲內評價彈出窗口是根據 Apple 政策公開的。請確保使用 Hive SDK v1.16.0 及更高版本，或 v4.10.0 及更高版本運行。

無法自訂顯示順序、文字或使用者介面。
每個遊戲每三個月在每個設備上顯示彈出窗口。彈出窗口的顯示遵循蘋果的內部政策，因此無法自訂。
運行於 iOS 10.3 及更高版本。
當用戶在設備上將 啟用限制 設置為禁用狀態時，無法顯示彈出窗口。
開發中的版本無限制顯示彈出窗口，並且無法向市場提交評分。
在使用 TestFlight 分發的應用程式上無法使用。

如果在不支持游戏内评论的 Android 或 iOS 版本上调用此 API，则评论弹出窗口会照常显示。显示的条件与游戏评论弹出窗口相同。

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

這個彈出窗口檢查用戶是否想退出遊戲以及是否希望獲得遊戲推薦。

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);    
             // 虛幻引擎用戶    
             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 原生評價彈出窗口¶

退出彈出窗口¶

退出彈出窗口的條件¶

顯示退出彈出窗口¶