How to use promotion¶

Promotion provides a way to effectively expose new game news or events to users. It can also be used to encourage greater engagement within the game.

Promotion¶

Promotion provides the following features;

• WebView displaying Promotion contents. (Promotion View)
• Custom view/Custom board that lets you organize what you want.
• Game review, exit, suggestion popups.
• User Engagement encouraging users to participate event. (UE, Deep link)
• User Acquisition encouraging users to install games. (UA)

Before applying Promotion¶

Followings are required prior to applying Promotion;

• Refer to Guide for Console Promotion to set Promotion details in Console first.
  News, Campaign, Notice, Banner and Offerwall pages receive configured data from Console to display on game client. It means, you should register Promotion details first in Console to show them on games.
• Refer to the Hive server API item guide to implement items.
  To use promotion and deliver game money to users, the Hive server API item integration is required.

Promotion view result callback¶

If you use Promotion API to display the following Promotion Views, Hive SDK returns API result through the callback handler as API parameter.

• Interstitial banner
• News
• Custom view/Custom board
• Offerwall
• Game review
• Exit popups
• Video clips on promotion

The callback functions provided from Hive SDK API should comply with the following interface format if you are willing to use the Promotion View listed above.

• Unity®: onPromotionView() method of Promotion class
• C++: onPromotionView() method of Promotion class
• Android: onPromotionView() method of PromotionViewListener class
• iOS: HIVEPromotionViewHandler interface

Promotion view status¶

When you call the Promotion API to show the Promotion View, it receives the enumeration data named PromotionEventType through the second parameter of the callback function. The value of this parameter explains the status of Promotion View. PromotionEventType defines the followings;