ข้ามไปที่เนื้อหา

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

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

รีวิวป๊อปอัป

ป๊อปอัพการรีวิวกระตุ้นให้ผู้ใช้ให้คะแนนและรีวิวในร้านค้า เช่น Google Play Store และ Apple App Store ตั้งแต่ Hive SDK v1.16.2 และ v4.11.0, Hive SDK ช่วยให้คุณปรับแต่งวลีในป๊อปอัพการรีวิวโดยเกม. คุณยังสามารถปรับแต่งข้อความป๊อปอัพการรีวิวและ UI ของป๊อปอัพ และอย่าลืมเชื่อมโยง URL ของร้านค้ากับป๊อปอัพการรีวิวด้วย

เงื่อนไขของป๊อปอัพการตรวจสอบ

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

  • แสดงป๊อปอัพรีวิวภายในห้านาทีจากการเล่นเกมครั้งแรก
  • แสดงป๊อปอัพรีวิวเมื่อผู้ใช้ทำผลลัพธ์ที่น่าทึ่งในเกม เช่น เคลียร์ด่านและรับรางวัล
  • แนะนำให้แสดงป๊อปอัพซ้ำหลายครั้ง แต่ไม่ควรทำให้ผู้ใช้รำคาญในการเล่นเกม
Note

Google และ Apple ถูกห้ามไม่ให้ดึงดูดคะแนนและรีวิวจากผู้ใช้โดยการเสนอรางวัล และ Google โดยเฉพาะห้ามไม่ให้กล่าวถึงรางวัล

ฟังก์ชันป๊อปอัพรีวิวทำงานดังนี้:

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

แสดงป๊อปอัปรีวิว

  • ตัวอย่างของป๊อปอัพรีวิว

เพื่อแสดงป๊อปอัพรีวิว ให้เรียกใช้วิธีการ showReview() ของคลาส Promotion ป๊อปอัพรีวิวในแอปจะถูกแสดงตามสไตล์พื้นฐานหรือสไตล์ที่กำหนดเอง ขึ้นอยู่กับการตั้งค่าใน Promotion > App Settings ของ Hive Console (ดูคู่มือ Opration > Promotion > App Settings จาก Hive Developers.)

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 success
        }
}));

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 Reference: 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    
         }    
}];

เงื่อนไขของป๊อปอัพการตรวจสอบในเกมสำหรับ Android

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

Warning

การ implement เมธอด showNativeReview() ของคลาส Promotion ขณะนี้มีให้บริการเฉพาะใน Google Play Store เท่านั้น ส่วน Hive SDK ซึ่ง implement ป๊อปอัพรีวิวไปยัง Android Market และ OneStore จะปล่อยออกมาในภายหลัง.

  • การแสดงป๊อปอัพรีวิวหรือไม่นั้นจะถูกกำหนดตามนโยบายภายในของ Google และไม่สามารถเปลี่ยนแปลงการแสดงผลได้ด้วยตนเอง
  • สามารถแสดงบนอุปกรณ์ Android ที่ใช้ Android 5.0 (API level 21) หรือสูงกว่าที่ติดตั้ง Google Play Store หากได้ตั้งค่า appId สำหรับการใช้ Google market
  • เพื่อเพิ่มความเป็นส่วนตัวของผู้ใช้และป้องกันการใช้ API อย่างไม่เหมาะสม แนะนำให้เรียกใช้ API ตามเนื้อหาของ Google Guide
  • แม้ในเวอร์ชันที่กำลังพัฒนา การแสดงผลจะถูกตัดสินตามนโยบายภายในของ Google และเพื่อที่จะตั้งค่าการแสดงผลให้เสมอ ให้ดูที่ Google Guide

แสดงป๊อปอัพรีวิวในเกมสำหรับ Android

  • ตัวอย่างของป๊อปอัพการตรวจสอบในเกมสำหรับ Android

เงื่อนไขของป๊อปอัปการตรวจสอบแบบเนทีฟสำหรับ iOS

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

  • สามารถใช้ Game Review Popup ที่จัดเตรียมโดย Hive และ native Review popup สำหรับ iOS ได้พร้อมกัน
  • หาก Game Review Popup ถูกปรับแต่งสำหรับแต่ละเกม จะไม่สามารถใช้ native review popup สำหรับ iOS ได้พร้อมกัน

ป๊อปอัปการตรวจสอบในเกมถูกเปิดเผยตามนโยบายของ Apple ตรวจสอบให้แน่ใจว่าได้ใช้งานกับ Hive SDK v1.16.0 ขึ้นไป หรือ v4.10.0 ขึ้นไป

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

หาก API นี้ถูกเรียกใช้บน Android หรือ iOS ซึ่งเวอร์ชันที่ไม่รองรับการรีวิวในเกม ป๊อปอัพรีวิวจะถูกเปิดเผยตามปกติ เงื่อนไขในการเปิดเผยจะเหมือนกับป๊อปอัพรีวิวเกม

แสดงป๊อปอัปรีวิวแบบเนทีฟสำหรับ iOS

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

เพื่อแสดงป๊อปอัปการตรวจสอบแบบเนทีฟ ให้เรียกใช้วิธีการ showNativeReview() ของคลาส Promotion。

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 Reference: 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];

ป๊อปอัปออก

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

Note

ป๊อปอัปออกจะมีให้เฉพาะบน Android เท่านั้นเนื่องจากปัญหานโยบาย.

Note

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

เงื่อนไขของป๊อปอัปการออก

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

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

  • ตัวอย่างการปิดป๊อปอัพด้วยคำแนะนำเกม Hive

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

API Reference: 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 app termination functionality
                // Ex) 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:    
             // Implement app termination functionality    
             System.exit(0);    
         }    
});