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

ป้ายโปรโมชั่น

ป้ายส่งเสริมการขายเป็นตัวบ่งชี้ที่เพิ่มเข้าไปในปุ่มหรือไอคอนในเกมเพื่อแจ้งให้ทราบว่ามีการลงทะเบียนโปรโมชั่นใหม่

ป้ายส่งเสริมการขายทำอะไร?

ป้ายส่งเสริมการขายเป็นฟังก์ชันที่แจ้งให้ผู้ใช้ทราบเมื่อมีการลงทะเบียนและเปิดเผยโปรโมชั่นใหม่ โดยการส่งข้อมูลนั้นไปยังไคลเอนต์เกม สามารถนำไปใช้กับฟีเจอร์การส่งเสริมการขาย เช่น แบนเนอร์ระหว่างหน้า, มุมมองที่กำหนดเอง, กระดานที่กำหนดเอง และไอคอนประกาศ

การนำเสนอ UI ป้ายส่งเสริมการขาย

SDK ของ Hive จะส่ง "badge ON" หากรายการส่งเสริมการขายเป็นรายการใหม่ และ "badge OFF" หากไม่ใช่รายการใหม่ไปยังเกมไคลเอนต์ การแสดงผลของ badge จะต้องถูกนำไปใช้ในฝั่งเกมโดยใช้ข้อมูล ON/OFF นี้  

ตัวอย่างหน้าจอของป้ายส่งเสริมการขาย  

รูปแบบข้อมูลแบดจ์

Hive SDK คืนค่าอ็อบเจ็กต์ PromotionBadgeInfo ที่ถือข้อมูลของการแสดงโปรโมชั่นเป็นอาเรย์ หากไม่มีการแสดงโปรโมชั่นที่เป็นเป้าหมายซึ่งป้ายควรจะแสดง จะคืนค่าเป็นอาเรย์ว่าง ตารางต่อไปนี้อธิบายองค์ประกอบของอ็อบเจ็กต์ PromotionBadgeInfo ที่ Hive SDK คืนค่า

ฟิลด์ ประเภท คำอธิบาย
target Enumerator เป้าหมายการโปรโมตที่จะแสดงป้าย PromotionBadgeTarget.NEWS: หน้าข่าว PromotionBadgeTarget.NOTICE: รายการประกาศ PromotionBadgeTarget.CUSTOMVIEW: มุมมองที่กำหนดเอง PromotionBadgeTarget.CUSTOMBOARD: กระดานที่กำหนดเอง
contentsKey String ตัวระบุที่ลงทะเบียนใน Hive Console เมื่อมุมมองการโปรโมตของป้ายเป็นมุมมองเว็บที่กำหนดเองหรือกระดานที่กำหนดเอง หากมุมมองการโปรโมตเป็นรายการข่าวหรือประกาศ จะส่งค่ากลับเป็น null
badgeType String ประเภทของป้ายที่จะปรากฏ * "new": ค่าดีฟอลต์ สามารถเปิดเผยป้ายในรูปแบบที่นำไปใช้ในด้านเกมได้.

ข้อมูลป้ายค้นหา

ในการค้นหาข้อมูลแบดจ์ ให้เรียกใช้วิธี getBadgeInfo() ของคลาส Promotion คุณสามารถรับข้อมูลผ่านฟังก์ชัน callback ที่ส่งมาเป็นพารามิเตอร์ฟังก์ชัน ต่อไปนี้คือตัวอย่างโค้ดในการค้นหาข้อมูลแบดจ์

API Reference: hive.Promotion.getBadgeInfo

using hive;    
    Promotion.getBadgeInfo((ResultAPI result, List<PromotionBadgeInfo> badgeInfoList) => {    
       if (!result.isSuccess()) {    
          return;    
       }    

       // การเรียกสำเร็จ    
       foreach(PromotionBadgeInfo badgeInfo in badgeInfoList) {    
          //TODO:    
          // แสดงเหรียญ    
       }    
});    
#include "HivePromotion.h"

FHivePromotion::GetBadgeInfo(FHivePromotionOnBadgeInfoDelegate::CreateLambda([this](const FHiveResultAPI& Result, const TArray<FHivePromotionBadgeInfo>& PromotionBadgeInfoList) {
        if (!Result.IsSuccess()) {
                return;
        }

        for (const auto& PromotionBadgeInfo : PromotionBadgeInfoList) {
                // TODO: แสดงแบดจ์
        }
}));

API Reference: Promotion::getBadgeInfo

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    Promotion::getBadgeInfo([=](ResultAPI result, vector<PromotionBadgeInfo> badgeInfoList) {    
        if (!result.isSuccess()) {    
          return;    
       }    
       // call successful    
       for_each(badgeInfoList.begin(), badgeInfoList.end(), [=](PromotionBadgeInfo badgeInfo) {    
          //TODO:    
          // Display the badge    
       }    
});

API Reference: Promotion.getBadgeInfo

import com.hive.Promotion    
    import com.hive.ResultAPI    
    Promotion.getBadgeInfo(object : Promotion.PromotionBadgeInfoListener {    
         override fun onReceiveInfo(result: ResultAPI, badgeInfoList: ArrayList<Promotion.PromotionBadge>?) {    
             if (!result.isSuccess) {    
                 return    
             }    
             badgeInfoList?.forEach {    
                 //TODO:    
                 // Display the badge    
             }    
         }    
})

API Reference: Promotion.INSTANCE.getBadgeInfo

import com.hive.Promotion;    
    import com.hive.ResultAPI;    
    Promotion.INSTANCE.getBadgeInfo((result, badgeInfoList) -> {    
         if (!result.isSuccess()) {    
             return;    
         }    
         // call successful    
         for (Promotion.PromotionBadge badgeInfo : badgeInfoList){    
             //TODO:    
             // Display the badge    
         }    
});

API Reference: PromotionInterface.getBadgeInfo

import HIVEService    
    PromotionInterface.getBadgeInfo() { result, badgeInfoList in    
       if !result.isSuccess() {    
       return    
       }    
       // call successful    
       for (badgeInfo in badgeInfoList) {    
          //TODO:    
          // Display the badge    
       }    
}

API Reference: HIVEPromotion:getBadgeInfo

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEPromotion getBadgeInfo: ^(HIVEResultAPI *result, NSArray<HIVEPromotionBadge *> *badgeInfoList) {    
         if (![result isSuccess]) {    
          return;    
       }    
       // call successful    
       for (HIVEPromotionBadge *badgeInfo in badgeInfoList) {    
          //TODO:    
          // Display the badge    
       }    
}];