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

แสดงแบนเนอร์ระหว่างหน้า

Hive SDK ให้บริการแบนเนอร์แบบเต็มหน้าจอเพื่อ

  • เปิดเผยเหตุการณ์อย่างมีประสิทธิภาพต่อผู้เล่นเกม
  • กระตุ้นผู้ใช้ให้มีส่วนร่วมในเกมมากขึ้น
  • ใช้เป็นการโปรโมตข้ามเพื่อโฆษณาเกมอื่น ๆ และมอบรางวัล

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

การลงทะเบียนแบนเนอร์ระหว่างกลางบน Hive คอนโซล

ออกแบบภาพแบนเนอร์ตามโหมดแนวนอนและแนวตั้งดังต่อไปนี้ และลงทะเบียนใน Hive Console สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการลงทะเบียนแบนเนอร์ โปรดดูที่ คู่มือสำหรับ Hive Console Promotion.

  • ขนาดภาพแบนเนอร์โปรโมชั่น
    • โหมดแนวนอน: 1080x720 px
    • โหมดแนวตั้ง: 720x1080 px
  • หากคุณต้องการแสดงแบนเนอร์ความละเอียดสูงในสภาพแวดล้อม PC กรุณาอัปโหลดภาพขนาด 2160x1440 px.

การแสดงแบนเนอร์ระหว่าง

  • ตัวอย่างของแบนเนอร์ระหว่างหน้า

ในการแสดงแบนเนอร์ระหว่างหน้า ให้เรียกใช้วิธีการ showPromotion() จากคลาส Promotion โดยใช้พารามิเตอร์ PromotionType.BANNER ตั้งแต่ Hive SDK v4.12.1, PromotionType.BANNER จะแสดงแบนเนอร์ประเภทเว็บ และพารามิเตอร์อื่นๆ จะแสดงแบนเนอร์ประเภทภาพ เมื่อคุณเรียกใช้ PromotionType.BANNERLEGACY แบนเนอร์ประเภทเว็บวิวจะแสดงตามปกติ

เมื่อแสดงแบนเนอร์เต็มรูปแบบด้วยประเภท PromotionType.BANNER รูปภาพที่จัดเก็บแบบอะซิงโครนัสในที่เก็บข้อมูลท้องถิ่นของแอปในระหว่างกระบวนการเริ่มต้น SDK ของ Hive จะถูกแสดง หากไม่มีรูปภาพที่เก็บไว้ในแคช รูปภาพจะถูกดาวน์โหลดทันทีเพื่อแสดงผล

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

Note

ประเภท PromotionType.BANNER ไม่รองรับตัวเลือก isForced

ต่อไปนี้คือตัวอย่างโค้ดเพื่อแสดงแบนเนอร์ระหว่างหน้า

API Reference: hive.Promotion.showPromotion

using hive;    

PromotionType promotionViewType = PromotionType.BANNER;    

// isForced จะถูกละเว้นเมื่อ PromotionType.BANNER
Boolean isForced = false;    

// แสดงแบนเนอร์ขนาดใหญ่    
Promotion.showPromotion(promotionViewType, isForced, (ResultAPI result, PromotionEventType viewEventType) => {    
     if (result.isSuccess()) {    
         // เรียกใช้เมื่อสำเร็จ    
     }    
});

#include "HivePromotion.h"

EHivePromotionType PromotionType = EHivePromotionType::BANNER;

// isForced ถูกละเลยเมื่อ EHivePromotionType::BANNER   
bool bIsForced = false;

FHivePromotion::ShowPromotion(PromotionType, bIsForced, FHivePromotionViewDelegate::CreateLambda([this](const FHiveResultAPI& Result, const EHivePromotionEventType& PromotionEventType) {
        if (Result.IsSuccess()) {
                // call successful    
        }
}));

API Reference: Promotion::showPromotion

#include <HIVE_SDK_Plugin/HIVE_CPP.h>   
using namespace std;    
using namespace hive;    

PromotionType promotionViewType = PromotionType::BANNER;    

// isForced จะถูกละเว้นเมื่อ PromotionType::BANNER   
bool isForced = false;    

Promotion::showPromotion(promotionViewType, isForced, [=](ResultAPI result, PromotionEventType viewEventType) {    
    if (result.isSuccess()) {    
        // call successful    
     }    
});

เอกสาร API: Promotion.showPromotion

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

val promotionViewType = Promotion.PromotionViewType.BANNER    

// isForced ถูกละเลยเมื่อ Promotion.PromotionViewType.BANNER   
val isForced = false    
Promotion.showPromotion(promotionViewType, isForced, object : Promotion.PromotionViewListener {    
     override fun onPromotionView(result: ResultAPI, promotionEventType: Promotion.PromotionViewResultType) {    
         if (result.isSuccess) {    
             // เรียกใช้งานสำเร็จ    
         }    
     }    
})

API Reference: com.hive.Promotion.showPromotion

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

Promotion.PromotionViewType promotionViewType = Promotion.PromotionViewType.BANNER;    
// isForced จะถูกละเว้นเมื่อ Promotion.PromotionViewType.BANNER   
boolean isForced = false;    
Promotion.INSTANCE.showPromotion(promotionViewType, isForced, (result, promotionEventType) -> {    
     if (result.isSuccess()) {    
         // เรียกใช้เมื่อสำเร็จ    
     }    
});

API Reference: PromotionInterface.showPromotion

import HIVEService 

let promotion: PromotionViewType = .banner    
// isForced ถูกละเว้นเมื่อ PromotionViewType.banner   
let isForced = false    
PromotionInterface.showPromotion(promotionViewType, isForced: isForced) { result, viewResultType in    
    if result.isSuccess() {    
    // เรียกใช้งานสำเร็จ    
    }    
}

API Reference: HIVEPromotion::showPromotion

#import <HIVEService/HIVEService-Swift.h>    
HIVEPromotionViewType promotionViewType = HIVEPromotionViewTypeBANNER;    

// isForced จะถูกมองข้ามเมื่อ HIVEPromotionViewTypeBANNER   
BOOL isForced = NO;    

[HIVEPromotion showPromotion: promotionViewType isForced: isForced handler: ^(HIVEResultAPI *result, HIVEPromotionViewResultType viewResultType) {    
     if ([result isSuccess]) {    
          // call successful    
     }    
}];

ควบคุมแบนเนอร์ระหว่างหน้าสำหรับการส่งเสริมข้าม

เมื่อคุณเรียกใช้วิธีการ showPromotion() แบนเนอร์ระหว่างหน้าที่ลงทะเบียนไว้ก่อนหน้านี้ทั้งหมดจะแสดงขึ้น ตั้งแต่ Hive SDK v4 24.2.0 เป็นต้นไป คุณสามารถเลือกได้ว่าจะให้แสดงแบนเนอร์ข้ามโปรโมชั่นหรือไม่

หากคุณเรียกใช้ Configuration.setCrossPromotionBannerShowing(false) ก่อนที่จะเรียกใช้เมธอด showPromotion() แบนเนอร์ข้ามโปรโมชั่นจะไม่แสดงเมื่อแอปถูกเปิดใช้งาน หากคุณเรียกใช้ด้วยค่า true แบนเนอร์จะถูกแสดง เมธอดนี้จะยังคงมีผลต่อแอปตราบใดที่มันยังคงทำงาน ดังนั้นจึงจำเป็นต้องเรียกใช้เพียงครั้งเดียวหลังจากที่ Hive SDK ถูกเริ่มต้นและก่อนที่จะเรียกใช้เมธอด showPromotion() คุณสามารถเปลี่ยนการมองเห็นของแบนเนอร์โดยการเรียกใช้เมธอดนี้อีกครั้งด้วยค่าที่แตกต่างกัน (true หรือ false) ขณะที่แอปยังคงทำงานอยู่

Note

เมื่อแสดงโฆษณาข้ามโปรโมชั่นแบบเต็มผ่าน แบนเนอร์จุด โดยใช้วิธีการ showCustomContents() มันจะได้รับผลกระทบจากการเรียกใช้ Configuration.setCrossPromotionBannerShowing()

using hive;

// ตั้งค่าแบนเนอร์ข้ามการโปรโมตให้ไม่แสดง (false)
Configuration.setCrossPromotionBannerShowing(false);

// คืนสถานะของการแสดงแบนเนอร์ข้ามการโปรโมต
Boolean crossPromotionBannerShowing = Configuration.getCrossPromotionBannerShowing();

#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace std;
using namespace hive;

// ตั้งค่าป้ายโฆษณาข้ามเพื่อไม่ให้แสดง (false)
Configuration::setCrossPromotionBannerShowing(false);

// คืนสถานะการแสดงแบนเนอร์ข้ามโปรโมชั่น
bool crossPromotionBannerShowing = Configuration::getCrossPromotionBannerShowing();

import com.hive.Configuration

// ตั้งค่าป้ายโฆษณาข้ามการโปรโมตไม่ให้แสดง (false)
Configuration.setCrossPromotionBannerShowing(false)

// คืนสถานะของการแสดงแบนเนอร์ข้ามโปรโมชัน
val crossPromotionBannerShowing = Configuration.getCrossPromotionBannerShowing()

import com.hive.Configuration;

// ตั้งค่าแบนเนอร์ข้ามการโปรโมตให้ไม่แสดง (false)
Configuration.INSTANCE.setCrossPromotionBannerShowing(false);

// คืนสถานะของการแสดงแบนเนอร์ข้ามโปรโมชัน
boolean crossPromotionBannerShowing = Configuration.INSTANCE.getCrossPromotionBannerShowing();

import HIVEService

// ตั้งค่าป้ายโฆษณาข้ามการโปรโมตให้ไม่แสดง (false)
ConfigurationInterface.setCrossPromotionBannerShowing(false)

// คืนสถานะการแสดงแบนเนอร์ข้ามโปรโมชัน
var crossPromotionBannerShowing: Bool = ConfigurationInterface.getCrossPromotionBannerShowing()

#import <HIVEService/HIVEService-Swift.h>

// ตั้งค่าป้ายโฆษณาข้ามการโปรโมตให้ไม่แสดง (false)
[HIVEConfiguration setCrossPromotionBannerShowing:false];

// คืนสถานะการแสดงแบนเนอร์ข้ามโปรโมชัน
BOOL crossPromotionBannerShowing = [HIVEConfiguration getCrossPromotionBannerShowing];
#import <HIVEService/HIVEService-Swift.h>

// ตั้งค่าป้ายโฆษณาข้ามโปรโมชั่นให้ไม่แสดง (false)
[HIVEConfiguration setCrossPromotionBannerShowing:false];

// คืนสถานะของการแสดงแบนเนอร์ข้ามโปรโมชั่น
BOOL crossPromotionBannerShowing = [HIVEConfiguration getCrossPromotionBannerShowing];