รีวิว/ป๊อปอัพออก

โปรโมชั่นนี้มีการแสดงป๊อปอัพรีวิวเกมและป๊อปอัพออกจากเกมสำหรับใช้ในเกม

ป๊อปอัปการรีวิวเป็นฟีเจอร์ที่กระตุ้นให้ผู้ใช้ให้คะแนนและรีวิวแอปในตลาดแอป (เช่น Google Play Store) SDK ของ Hive มีป๊อปอัปการรีวิวสองประเภทดังต่อไปนี้

ประเภทป๊อปอัป	คำอธิบาย
Hive ป๊อปอัปรีวิว	ป๊อปอัปที่กระตุ้นให้ผู้ใช้ให้คะแนนและรีวิวเกมในตลาดที่ดาวน์โหลดแอปเกมมา
ป๊อปอัปรีวิวพื้นเมือง (Android/iOS)	ป๊อปอัปที่กระตุ้นให้ผู้ใช้ให้คะแนนและรีวิวทันทีภายในเกมโดยไม่ต้องย้ายไปที่ตลาด

ด้านล่างนี้คือแผนภาพกระบวนการแสดงการดำเนินการป๊อปอัพการตรวจสอบสองประเภท

นี่คือป๊อปอัพที่แนะนำผู้ใช้ไปยังตลาดโดยใช้ Hive UI ซึ่งกระตุ้นให้พวกเขาให้คะแนนและรีวิว ป๊อปอัพรีวิว Hive สามารถใช้ป๊อปอัพเริ่มต้นที่ให้ไว้หรือปรับแต่งด้วย UI ที่แตกต่างกัน

ประเภทการตั้งค่า	คำอธิบาย
การตั้งค่าเริ่มต้น	ป๊อปอัพที่จัดเตรียมไว้เริ่มต้น
การตั้งค่าแบบกำหนดเอง	ป๊อปอัพ UI แบบกำหนดเอง

Note

เมื่อกำหนดค่าป๊อปอัพการรีวิว Hive คุณต้องแทรกลิงก์ URL ของตลาดแอป (ลิงก์ไปยังสถานที่ที่คุณสามารถให้คะแนนและเขียนรีวิวในตลาดแอป) ลงในป๊อปอัพ

เงื่อนไขที่แนะนำสำหรับป๊อปอัปการตรวจสอบใน Hive SDK มีดังนี้

แสดงคำขอรีวิวภายใน 5 นาทีหลังจากที่ผู้ใช้เปิดเกมเป็นครั้งแรกหลังจากการติดตั้ง
แสดงเมื่อผู้ใช้มีประสบการณ์ที่ดีในเกม (เช่น การเคลียร์ด่าน, การได้รับรางวัล)
แนะนำให้แสดงหลายครั้ง แต่ไม่ควรก่อให้เกิดความไม่สะดวกสบายแก่ผู้ใช้

Note

Google และ Apple ห้ามการให้แรงจูงใจเพื่อกระตุ้นให้มีการให้คะแนนสูง และโดยเฉพาะอย่างยิ่ง Google ห้ามการกล่าวถึงแรงจูงใจใดๆ

คุณสมบัติของป๊อปอัพรีวิว Hive มีดังนี้

หากผู้ใช้คลิกที่ปุ่ม ปิด (X) หน้าต่างป๊อปอัปการรีวิวจะไม่แสดงอีกในอุปกรณ์เดียวกัน.
หากผู้ใช้คลิกที่ปุ่ม เตือนฉันทีหลัง หน้าต่างป๊อปอัปการรีวิวอาจแสดงอีกครั้งในอุปกรณ์เดียวกัน.
หากเวอร์ชันแอปเปลี่ยน จะมีการแสดงอีกครั้งต่อผู้ใช้ที่เคยเข้าร่วม หรือปฏิเสธไปแล้ว.
เงื่อนไขในการแสดงหน้าต่างป๊อปอัปการรีวิวและจำนวนการแสดงต้องถูกนำไปใช้โดยตรงในเกมตามเงื่อนไขของ Hive.

Hive รีวิวป๊อปอัพการแสดง¶

Hive รีวิวป๊อปอัพภาพหน้าจอ

เพื่อแสดงป๊อปอัพรีวิว Hive ให้เรียกใช้เมธอด showReview() ของคลาส Promotion ขึ้นอยู่กับการตั้งค่าที่กำหนดในคอนโซลภายใต้ Promotion > App Settings จะมีการแสดงป๊อปอัพรีวิวในรูปแบบเริ่มต้นหรือรูปแบบที่กำหนดเอง (ดูที่ Operation > Promotion > App Settings บนเว็บไซต์นักพัฒนา)

UnityUnreal EngineC++KotlinJavaSwiftObjective-C

API Reference: 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 Reference: 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 Reference: 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 Reference: 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 Reference: 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 Store.

การแสดงผลของป๊อปอัปรีวิวจะถูกกำหนดโดยนโยบายภายในของ Google และไม่สามารถเปลี่ยนแปลงได้ตามอำเภอใจ
หาก ID แอปเชื่อมโยงกับตลาดของ Google จะสามารถแสดงผลบนอุปกรณ์ Android ที่ติดตั้ง Google Play Store
เพื่อเพิ่มการปกป้องความเป็นส่วนตัวของผู้ใช้และป้องกันการใช้ API อย่างไม่เหมาะสม แนะนำให้เรียก API ตามคำแนะนำของ Google Play In-App Review API
แม้ในเวอร์ชันที่อยู่ระหว่างการพัฒนา การแสดงผลจะถูกกำหนดโดยนโยบายภายในของ Google สำหรับการตั้งค่าการแสดงผลอย่างต่อเนื่อง ให้ดูที่ In-App Review Testing ที่ Google จัดเตรียมไว้

แสดงป๊อปอัพรีวิวเนทีฟของ Android¶

ภาพหน้าจอป๊อปอัปการตรวจสอบ Android Native

Hive SDK มีฟีเจอร์ที่อนุญาตให้ผู้ใช้ที่เล่นเกมในสภาพแวดล้อม iOS สามารถเขียนรีวิวระหว่างการเล่นเกมได้ แตกต่างจากป๊อปอัพรีวิวที่มีอยู่ในปัจจุบัน การประเมินความพึงพอใจสามารถทำได้โดยไม่ต้องย้ายไปยังตลาด และหากคุณตอบสนองต่อคำขอรีวิว คุณจะถูกนำไปยังหน้าการเขียนโดยตรง เงื่อนไขในการใช้ป๊อปอัพรีวิวพื้นเมืองของ iOS มีดังนี้

แม้ว่าคุณจะใช้ป๊อปอัปการตรวจสอบที่จัดเตรียมไว้ทั่วไปใน Hive ก็สามารถใช้พร้อมกันกับป๊อปอัปการตรวจสอบของ iOS ได้
หากคุณใช้ป๊อปอัปการตรวจสอบที่พัฒนาขึ้นเองในเกม จะไม่สามารถใช้พร้อมกันกับป๊อปอัปการตรวจสอบของ iOS ได้

ตามนโยบายที่ Apple กำหนด จะมีการแสดงป๊อปอัปการตรวจสอบแบบเนทีฟของ iOS

ลำดับการแสดงผล ข้อความ UI ฯลฯ ไม่สามารถเปลี่ยนแปลงได้ตามอำเภอใจ
ป๊อปอัปจะแสดงเพียง 3 ครั้งต่อปีต่ออุปกรณ์ในแต่ละแอป และการแสดงหรือไม่แสดงจะดำเนินการตามนโยบายภายในของ Apple ดังนั้นจึงไม่สามารถเปลี่ยนแปลงได้ตามอำเภอใจ
หากผู้ใช้ปิด (OFF) รายการ การให้คะแนนและรีวิวในแอป ในการตั้งค่าอุปกรณ์ จะไม่แสดง
ในรุ่นที่อยู่ระหว่างการพัฒนา จะมีการแสดงเสมอโดยไม่คำนึงถึงจำนวนการแสดงผล แต่ไม่สามารถส่งคะแนนไปยังตลาดได้
แอปที่แจกจ่ายโดยใช้ TestFlight จะไม่แสดง

การแสดงป๊อปอัปรีวิวแบบเนทีฟของ iOS¶

ภาพหน้าจอป๊อปอัปการตรวจสอบเนทีฟ iOS

ในการแสดงป๊อปอัปรีวิวแบบเนทีฟ ให้เรียกใช้เมธอด Promotion class's showNativeReview()

UnityC++Unreal EngineKotlinJavaSwiftObjective-C

API Reference: Promotion .showNativeReview

using hive;    

Promotion.showNativeReview();

API Reference: 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) {
        // Native review callback is no longer supported
}));

เอกสารอ้างอิง API: Promotion.showNativeReview

import com.hive.Promotion    
    import com.hive.ResultAPI    

Promotion.showNativeReview()

API Reference: Promotion .INSTANCE.showNativeReview

import com.hive.Promotion;    
    import com.hive.ResultAPI;    

Promotion.INSTANCE.showNativeReview()

API Reference: PromotionInterface.showNativeReview

import HIVEService    

PromotionInterface.showNativeReview()

API Reference: HIVEPromotion showNativeReivew

#import <HIVEService/HIVEService-Swift.h>    

[HIVEPromotion showNativeReivew];

ป๊อปอัปการออกคือป๊อปอัปที่ถามผู้ใช้ว่าต้องการออกจากเกมหรือไม่ และยังขอการยืนยันว่าให้รับรายชื่อคำแนะนำเกมที่มี Hive หรือไม่

Note

ป๊อปอัพออกจากเกมจะไม่ถูกจัดเตรียมไว้บนอุปกรณ์ iOS ด้วยเหตุผลทางนโยบาย และจะมีให้ใช้งานเฉพาะบนอุปกรณ์ Android เท่านั้น.

Note

หากคุณดำเนินการป๊อปอัปสุดท้ายโดยตรงและเชื่อมต่อกับหน้าเกมของ m.withhive.com ผ่านปุ่ม เกมเพิ่มเติม คุณจะไม่สามารถใช้มุมมองที่กำหนดเองได้ คุณต้องไปที่ URL ผ่านเบราว์เซอร์ที่ติดตั้งบนอุปกรณ์

เงื่อนไขการแสดงป๊อปอัพออก¶

ตามแนวทางการพัฒนาแอป Android เมื่อผู้ใช้แตะปุ่ม กลับ ของอุปกรณ์ในระหว่างการเล่นเกม ควรมีการดำเนินการเพื่อไปยังหน้าก่อนหน้าของหน้าปัจจุบัน ตามที่กล่าวไว้ เมื่อผู้ใช้แตะปุ่ม กลับ ของอุปกรณ์ในระหว่างการเล่นเกม เกมควรหยุดชั่วคราว และผู้ใช้ควรถูกถามว่าต้องการดำเนินการเล่นเกมต่อหรือออกจากเกม แสดงป๊อปอัปการออกเมื่อไม่มีหน้าก่อนหน้าให้กลับไป ซึ่งมักจะเกิดขึ้นเมื่อผู้ใช้อยู่ในล็อบบี้เกม

แสดงป๊อปอัพออก

¶

สิ้นสุดภาพหน้าจอป๊อปอัพ

ในการแสดงป๊อปอัปออกจากระบบ ให้เรียกใช้เมธอด Promotion class's showExit() หลังจากที่ป๊อปอัปออกจากระบบปรากฏขึ้น หากผู้ใช้คลิกที่ปุ่มออกจากระบบ promotionEventType จะถูกกำหนดเป็น PromotionEventType.EXIT นี่คือตัวอย่างโค้ดในการแสดงป๊อปอัปออกจากระบบ เนื่องจากนโยบายของ Apple จึงไม่มีป๊อปอัปออกจากระบบที่จัดเตรียมไว้สำหรับอุปกรณ์ iOS ดังนั้นจึงไม่มีตัวอย่างโค้ดสำหรับ iOS

UnityUnreal EngineC++KotlinJava

API Reference: hive.Promotion.showExit

using hive;    

    hive.Promotion.showExit(ResultAPI result, PromotionEventType viewEventType) => {    
         if (!result.isSuccess()) {    
             return;    
         }    

         // การเรียกสำเร็จ    
         if (viewEventType == PromotionEventType.EXIT) {    
             //TODO:    
             // Implement app termination functionality    
             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 Reference: 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 Reference: 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 Reference: 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);    
         }    
});

รีวิว/ป๊อปอัพออก