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

Result API Promotion

Book Mark

showPromotion showCustomContents getOfferwallState showOfferwall showReview
showNativeReview showExit getViewInfo getBadgeInfo getAppInvitationData
setAdditionalInfo setEngagementReady setEngagementListener showUAShare

Promotion.showPromotion

PromotionType promotionType = PromotionType.BANNER;
Boolean isForce = true;
Promotion.showPromotion (promotionType, isForce, (ResultAPI result, PromotionEventType promotionEventType) => {
    switch(result.code) {
        case ResultAPI.Code.PromotionNetworkError:
        // Check the network connection status of the device. If this error occurs despite the network connection status being normal, please contact HIVE with the error message.
        break;
        case ResultAPI.Code.PromotionInvalidResponseData:
        // Please contact HIVE with the received message.
        break;
        case ResultAPI.Code.PromotionServerResponseError:
        // Please contact HIVE with the received message.
        break;
        case ResultAPI.Code.PromotionStartPlayback:
        // Minimize the game volume or mute it when starting video playback.
        break;
        case ResultAPI.Code.PromotionFinishPlayback:
        // Restore the game volume after the video playback ends.
        break;
        case ResultAPI.Code.PromotionCancelPlayback:
        // Restore the game volume after the video playback ends.
        break;
        case ResultAPI.Code.PromotionYTPlayerError:
        // Inform the user that an error occurred during video playback on YouTube and guide them to stop the video playback.
        break;
    }
});
PromotionType promotionType = PromotionType::BANNER;
bool isForce = true;

Promotion::showPromotion(promotionType, isForce,[](ResultAPI const & result, PromotionEventType promotionEventType){
    switch(result.code) {
    case ResultAPI::Code::PromotionNetworkError:
    // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
    break;
    case ResultAPI::Code::PromotionInvalidResponseData:
    // Contact HIVE with the received message.
    break;
    case ResultAPI::Code::PromotionServerResponseError:
    // Contact HIVE with the received message.
    break;
    case ResultAPI::Code::PromotionStartPlayback:
    // Minimize or mute the game volume when video playback starts.
    break;
    case ResultAPI::Code::PromotionFinishPlayback:
    // Restore the game volume after video playback ends.
    break;
    case ResultAPI::Code::PromotionCancelPlayback:
    // Restore the game volume after video playback ends.
    break;
    case ResultAPI::Code::PromotionYTPlayerError:
    // Notify the user that an error occurred while playing the video on YouTube and guide them to end video playback.
    break;
}
});
PromotionViewType promotionType = PromotionViewType.BANNER;
Boolean isForce = true;

Promotion.showPromotion(promotionType, isForce, new Promotion.PromotionViewListener() {
    @Override
    public void onPromotionView(ResultAPI result, Promotion.PromotionViewResultType promotionEventType) {
        switch(result.code) {
            case PromotionNetworkError:
                // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
            case PromotionInvalidResponseData:
                // Contact HIVE with the received message.
                break;
            case PromotionServerResponseError:
                // Contact HIVE with the received message.
                break;
            case PromotionStartPlayback:
                // Minimize or mute the game volume when video playback starts.
                break;
            case PromotionFinishPlayback:
                // Restore the game volume after video playback ends.
                break;
            case PromotionCancelPlayback:
                // Restore the game volume after video playback ends.
                break;
            case PromotionYTPlayerError:
                // Notify the user that an error occurred while playing the video on YouTube and guide them to end video playback.
                break;
        }

    }
});
HIVEPromotionViewType promotionViewType = kHIVEPromotionViewTypeBANNER;
BOOL isForce = YES;

[HIVEPromotion showPromotion:promotionViewType isForced:isForce handler:^(HIVEResultAPI  *result, HIVEPromotionViewResultType promotionResultType) {

    switch (result.code) {
        case kPromotionNetworkError:
            // Please check the network connection status of the device. If this error occurs despite the network connection being normal, please contact HIVE with the error message.
            break;
        case kPromotionInvalidResponseData:
            // Please contact HIVE with the received message.
            break;
        case kPromotionServerResponseError:
            // Please contact HIVE with the received message.
            break;
        case kPromotionStartPlayback:
            // Minimize or mute the game volume when starting video playback.
            break;
        case kPromotionFinishPlayback:
            // Restore the game volume after the video playback ends.
            break;
        case kPromotionCancelPlayback:
            // Restore the game volume after the video playback ends.
            break;
        case kPromotionYTPlayerError:
            // Inform the user that an error occurred during video playback on YouTube and guide them to stop the video playback.
            break;
        default:
            break;
    }
}];
Code Message How to solve
(Required implementation) PromotionNetworkError Failed to communicate with the server. Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
(Required implementation) PromotionInvalidResponseData Data that does not comply with the HIVE server communication protocol was delivered. Contact HIVE with the received message.
(Required implementation) PromotionServerResponseError The HIVE server communication response value is invalid. Contact HIVE with the received message.
(Required implementation) PromotionStartPlayback Video playback starts. Minimize or mute the game volume when video playback starts.
(Required implementation) PromotionFinishPlayback Video playback has ended. Restore the game volume after video playback ends.
(Required implementation) PromotionCancelPlayback The user pressed the close button during video playback, and video playback ended. Restore the game volume after video playback ends.
(Required implementation) PromotionYTPlayerError An unknown error occurred during YouTube video playback. Notify the user that an error occurred while playing the video on YouTube and guide them to end video playback.
PromotionNotInitialized The HIVE SDK has not been initialized. Call the AuthV4.setup API to initialize the HIVE SDK. View API
PromotionAlreadyShowing A Promotion feature is already in progress. If the showPromotion API, showCustomContents API, or showOfferwall API is already running, duplicate API calls are not allowed. End the previous feature before calling it.

Promotion.showCustomContents

PromotionCustomType customType = PromotionCustomType.VIEW;
String contentsKey = "100000";

Promotion.showCustomContents (customType, contentsKey, (ResultAPI result, PromotionEventType promotionEventType) => {
    switch(result.code) {
        case ResultAPI.Code.PromotionNetworkError:
        // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
        break;
        case ResultAPI.Code.PromotionInvalidResponseData:
        // Contact HIVE with the received message.
        break;
        case ResultAPI.Code.PromotionServerResponseError:
        // Contact HIVE with the received message.
        break;
        case ResultAPI.Code.PromotionStartPlayback:
        // Minimize or mute the game volume when video playback starts.
        break;
        case ResultAPI.Code.PromotionFinishPlayback:
        // Restore the game volume after video playback ends.
        break;
        case ResultAPI.Code.PromotionCancelPlayback:
        // Restore the game volume after video playback ends.
        break;
        case ResultAPI.Code.PromotionYTPlayerError:
        // Notify the user that an error occurred while playing the video on YouTube and guide them to end video playback.
        break;
    }
});
PromotionType customType = PromotionType::BANNER;
std::string contentsKey = "1000000";


Promotion::showCustomContents(customType, contentsKey,[](ResultAPI const & result, PromotionEventType promotionEventType){
    switch(result.code) {
        case ResultAPI::Code::PromotionNetworkError:
        // Please check the network connection status of the device. If this error occurs even when the network connection status of the device is normal, please contact HIVE with the error message.
        break;
        case ResultAPI::Code::PromotionInvalidResponseData:
        // Please contact HIVE with the message received.
        break;
        case ResultAPI::Code::PromotionServerResponseError:
        // Please contact HIVE with the message received.
        break;
        case ResultAPI::Code::PromotionStartPlayback:
        // Minimize or mute the game volume when starting video playback.
        break;
        case ResultAPI::Code::PromotionFinishPlayback:
        // Restore the game volume after the video playback ends.
        break;
        case ResultAPI::Code::PromotionCancelPlayback:
        // Restore the game volume after the video playback ends.
        break;
        case ResultAPI::Code::PromotionYTPlayerError:
        // Inform the user that an error occurred during video playback on YouTube and guide them to stop the video playback.
        break;
    }
});
PromotionCustomType customType = PromotionCustomType.VIEW;
String contentsKey = "100000";

Promotion.showCustomContents(customType, content_key, new Promotion.PromotionViewListener() {
    @Override
    public void onPromotionView(ResultAPI result, Promotion.PromotionViewResultType promotionEventType) {
        switch(result.code) {
            case PromotionNetworkError:
                // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
                break;
            case PromotionInvalidResponseData:
                // Contact HIVE with the received message.
                break;
            case PromotionServerResponseError:
                // Contact HIVE with the received message.
                break;
            case PromotionStartPlayback:
                // Minimize or mute the game volume when video playback starts.
                break;
            case PromotionFinishPlayback:
                // Restore the game volume after video playback ends.
                break;
            case PromotionCancelPlayback:
                // Restore the game volume after video playback ends.
                break;
            case PromotionYTPlayerError:
                // Notify the user that an error occurred while playing the video on YouTube and guide them to end video playback.
                break;
        }

    }
});
HIVEPromotionCustomType customType = kHIVEPromotionCustomTypeVIEW;
NSString *contentsKey = [NSString stringWithFormat:@"100000"];

[HIVEPromotion showCustomContents:customType contents:contentsKey handler:^(HIVEResultAPI *result, HIVEPromotionViewResultType promotionResultType){

    switch (result.code) {
        case kPromotionNetworkError:
            // Check the network connection status of the device. If this error occurs despite the network connection status being normal, please contact HIVE with the error message.
            break;
        case kPromotionInvalidResponseData:
            // Please contact HIVE with the received message.
            break;
        case kPromotionServerResponseError:
            // Please contact HIVE with the received message.
            break;
        case kPromotionStartPlayback:
            // Minimize the game volume or mute it when starting video playback.
            break;
        case kPromotionFinishPlayback:
            // Restore the game volume after the video playback ends.
            break;
        case kPromotionCancelPlayback:
            // Restore the game volume after the video playback ends.
            break;
        case kPromotionYTPlayerError:
            // Inform the user that an error occurred during video playback on YouTube and guide them to stop the video playback.
            break;
        default:
            break;
    }
}];
Code Message How to solve
(Required implementation) PromotionNetworkError Failed to communicate with the HIVE server. Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
(Required implementation) PromotionInvalidResponseData Data that does not comply with the HIVE server communication protocol was delivered. Contact HIVE with the received message.
(Required implementation) PromotionServerResponseError The HIVE server communication response value is invalid. Contact HIVE with the received message.
(Required implementation) PromotionStartPlayback Video playback starts. Minimize or mute the game volume when video playback starts.
(Required implementation) PromotionFinishPlayback Video playback has ended. Restore the game volume after video playback ends.
(Required implementation) PromotionCancelPlayback The user pressed the close button during video playback, and video playback ended. Restore the game volume after video playback ends.
(Required implementation) PromotionYTPlayerError An unknown error occurred during YouTube video playback. Notify the user that an error occurred while playing the video on YouTube and guide them to end video playback.
PromotionNotInitialized The HIVE SDK has not been initialized. Call the AuthV4.setup API to initialize the HIVE SDK. View API
PromotionAlreadyShowing A Promotion feature is already in progress. If the showPromotion API, showCustomContents API, or showOfferwall API is already running, duplicate API calls are not allowed. End the previous feature before calling it.

Promotion.getOfferwallState

Code Message How to solve
No Result API

Promotion.showOfferwall

Promotion.showOfferwall ((ResultAPI result, PromotionEventType promotionEventType) => {
    switch(result.code) {
        case ResultAPI.Code.PromotionNetworkError:
        // Check the network connection status of the device. If this error occurs despite the device's network connection being normal, please contact HIVE with the error message.
        break;
        case ResultAPI.Code.PromotionInvalidResponseData:
        // Please contact HIVE with the message received.
        break;
        case ResultAPI.Code.PromotionServerResponseError:
        // Please contact HIVE with the message received.
        break;
        case ResultAPI.Code.PromotionStartPlayback:
        // Minimize the game volume or mute it when starting video playback.
        break;
        case ResultAPI.Code.PromotionFinishPlayback:
        // Restore the game volume after the video playback ends.
        break;
        case ResultAPI.Code.PromotionCancelPlayback:
        // Restore the game volume after the video playback ends.
        break;
        case ResultAPI.Code.PromotionYTPlayerError:
        // Inform the user that an error occurred during video playback on YouTube and guide them to stop the video playback.
        break;
    }
});
Promotion::showOfferwall([](ResultAPI const & result, PromotionEventType promotionEventType){
    switch(result.code) {
        case ResultAPI::Code::PromotionNetworkError:
        // Please check the network connection status of the device. If this error occurs despite the network connection status being normal, please contact HIVE with the error message.
        break;
        case ResultAPI::Code::PromotionInvalidResponseData:
        // Please contact HIVE with the message received.
        break;
        case ResultAPI::Code::PromotionServerResponseError:
        // Please contact HIVE with the message received.
        break;
        case ResultAPI::Code::PromotionStartPlayback:
        // Minimize or mute the game volume when starting video playback.
        break;
        case ResultAPI::Code::PromotionFinishPlayback:
        // Restore the game volume after video playback ends.
        break;
        case ResultAPI::Code::PromotionCancelPlayback:
        // Restore the game volume after video playback ends.
        break;
        case ResultAPI::Code::PromotionYTPlayerError:
        // Inform the user that an error occurred during video playback on YouTube and guide them to end the video playback.
        break;
    }
});
Promotion.showOfferwall(new Promotion.PromotionViewListener() {
    @Override
    public void onPromotionView(ResultAPI result, Promotion.PromotionViewResultType promotionEventType) {
        switch(result.code) {
            case PromotionNetworkError:
                // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
                break;
            case PromotionInvalidResponseData:
                // Contact HIVE with the received message.
                break;
            case PromotionServerResponseError:
                // Contact HIVE with the received message.
                break;
            case PromotionStartPlayback:
                // Minimize or mute the game volume when video playback starts.
                break;
            case PromotionFinishPlayback:
                // Restore the game volume after video playback ends.
                break;
            case PromotionCancelPlayback:
                // Restore the game volume after video playback ends.
                break;
            case PromotionYTPlayerError:
                // Notify the user that an error occurred while playing the video on YouTube and guide them to end video playback.
                break;
        }

    }
});
[HIVEPromotion showOfferwall:^(HIVEResultAPI *result, HIVEPromotionViewResultType promotionResultType){
    switch (result.code) {
        case kPromotionNetworkError:
            // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
            break;
        case kPromotionInvalidResponseData:
            // Contact HIVE with the received message.
            break;
        case kPromotionServerResponseError:
            // Contact HIVE with the received message.
            break;
        case kPromotionStartPlayback:
            // Minimize or mute the game volume when video playback starts.
            break;
        case kPromotionFinishPlayback:
            // Restore the game volume after video playback ends.
            break;
        case kPromotionCancelPlayback:
            // Restore the game volume after video playback ends.
            break;
        case kPromotionYTPlayerError:
            // Notify the user that an error occurred while playing the video on YouTube and guide them to end video playback.
            break;
        default:
            break;
    }
}];
Code Message How to solve
(Required implementation) PromotionNetworkError Failed to communicate with the HIVE server. Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
(Required implementation) PromotionInvalidResponseData Data that does not comply with the HIVE server communication protocol was delivered. Contact HIVE with the received message.
(Required implementation) PromotionServerResponseError The HIVE server communication response value is invalid. Contact HIVE with the received message.
(Required implementation) PromotionStartPlayback Video playback starts. Minimize or mute the game volume when video playback starts.
(Required implementation) PromotionFinishPlayback Video playback has ended. Restore the game volume after video playback ends.
(Required implementation) PromotionCancelPlayback The user pressed the close button during video playback, and video playback ended. Restore the game volume after video playback ends.
(Required implementation) PromotionYTPlayerError An unknown error occurred during YouTube video playback. Notify the user that an error occurred while playing the video on YouTube and guide them to end video playback.
PromotionNotInitialized The HIVE SDK has not been initialized. Call the AuthV4.setup API to initialize the HIVE SDK. View API
PromotionAlreadyShowing A Promotion feature is already in progress. If the showPromotion API, showCustomContents API, or showOfferwall API is already running, duplicate API calls are not allowed. End the previous feature before calling it.

Promotion.showReview

Promotion.showReview ((ResultAPI result, PromotionEventType promotionEventType) => {
    switch(result.code) {
        case ResultAPI.Code.PromotionNetworkError:
        // Please check the network connection status of the device. If this error occurs despite the device's network connection being normal, please contact HIVE with the error message.
        break;
        case ResultAPI.Code.PromotionInvalidResponseData:
        // Please contact HIVE with the message received.
        break;
        case ResultAPI.Code.PromotionServerResponseError:
        // Please contact HIVE with the message received.
        break;
    }
});
Promotion::showReview([](ResultAPI const & result, PromotionEventType promotionEventType){
    switch(result.code) {
        case ResultAPI::Code::PromotionNetworkError:
        // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
        break;
        case ResultAPI::Code::PromotionInvalidResponseData:
        // Contact HIVE with the received message.
        break;
        case ResultAPI::Code::PromotionServerResponseError:
        // Contact HIVE with the received message.
        break;
    }
});
Promotion.showReview(new Promotion.PromotionViewListener() {
    @Override
    public void onPromotionView(ResultAPI result, Promotion.PromotionViewResultType promotionEventType) {
        switch(result.code) {
            case PromotionNetworkError:
                // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
                break;
            case PromotionInvalidResponseData:
                // Contact HIVE with the received message.
                break;
            case PromotionServerResponseError:
                // Contact HIVE with the received message.
                break;
        }
    }
});
[HIVEPromotion showReview:^(HIVEResultAPI *result, HIVEPromotionViewResultType promotionResultType) {
    switch (result.code) {
        case kPromotionNetworkError:
            // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
            break;
        case kPromotionInvalidResponseData:
            // Contact HIVE with the received message.
            break;
        case kPromotionServerResponseError:
            // Contact HIVE with the received message.
            break;
        default:
            break;
    }
}];
Code Message How to solve
(Required implementation) PromotionNetworkError Failed to communicate with the HIVE server. Removed in HIVE SDK v4.11.4 Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
(Required implementation) PromotionServerResponseError The HIVE server communication response value is invalid. Removed in HIVE SDK v4.11.4 Contact HIVE with the received message.
(Required implementation) PromotionInvalidResponseData Data that does not comply with the HIVE server communication protocol was delivered. Removed in HIVE SDK v4.11.4 Contact HIVE with the received message.
PromotionNotInitialized The HIVE SDK has not been initialized. Removed in HIVE SDK v4.11.4 Call the AuthV4.setup API to initialize the HIVE SDK. View API
PromotionAlreadyShowing A Promotion feature is already in progress. Removed in HIVE SDK v4.11.4 If the showPromotion API, showCustomContents API, or showOfferwall API is already running, duplicate API calls are not allowed. End the previous feature before calling it.

Promotion.showNativeReview

Code Message Resolution
No Result API

Promotion.showExit

(Android only)

Promotion.showExit ((ResultAPI result, PromotionEventType promotionEventType) => {
    switch(result.code) {
        case ResultAPI.Code.PromotionNetworkError:
        // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
        break;
    }
});
Promotion::showExit([](ResultAPI const & result, PromotionEventType promotionEventType){
    switch(result.code) {
        case ResultAPI::Code::PromotionNetworkError:
        // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
        break;
    }
});
Promotion.showExit(new Promotion.PromotionViewListener() {
    @Override
    public void onPromotionView(ResultAPI result, Promotion.PromotionViewResultType promotionEventType) {
        switch(result.code) {
            case PromotionNetworkError:
                // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
                break;
        }

    }
});

Code Message How to solve
(Required implementation) PromotionNetworkError Failed to communicate with the HIVE server. Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
PromotionAlreadyShowing A Promotion feature is already in progress. If the Promotion.showExit API is already running, duplicate API calls are not allowed. End the previous feature before calling it.

Promotion.getViewInfo

PromotionCustomType customType = PromotionCustomType.VIEW;
String contentsKey = "100000";

Promotion.getViewInfo (customType, contentsKey, (ResultAPI result, List<PromotionViewInfo> promotionViewInfoList) => {
    switch(result.code) {
        case ResultAPI.Code.PromotionNetworkError:
        // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
        break;
        case ResultAPI.Code.PromotionServerResponseError:
        // Contact HIVE with the received message.
        break;
    }
});
PromotionCustomType customType = PromotionCustomType::VIEW;
std::string contentsKey = "100000";

Promotion::getViewInfo(customType, contentsKey, [](ResultAPI const & result, std::vector<PromotionViewInfo> const & promotionViewInfo){
    switch(result.code) {
        case ResultAPI::Code::PromotionNetworkError:
        // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
        break;
        case ResultAPI::Code::PromotionServerResponseError:
        // Contact HIVE with the received message.
        break;
    }
});
PromotionCustomType customType = PromotionCustomType.VIEW;
String contentsKey = "100000";

Promotion.getViewInfo(customType, contentsKey, new PromotionViewInfoListener() {
    @Override
    public void onReceiveInfo(ResultAPI result, ArrayList<PromotionViewInfo> viewInfo) {
        switch(result.code) {
            case PromotionNetworkError:
                // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
                break;
            case PromotionServerResponseError:
                // Contact HIVE with the received message.
                break;
        }
    }
});
HIVEPromotionCustomType customType = kHIVEPromotionCustomTypeVIEW;
NSString* contentsKey = [NSString stringWithFormat:@"100000"];

[HIVEPromotion getViewInfo:customType contents:contentsKey handler:^(HIVEResultAPI *result, NSArray<HIVEPromotionViewInfo *> *viewInfos) {
    switch (result.code) {
        case kPromotionNetworkError:
            // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
            break;
        case kPromotionServerResponseError:
            // Contact HIVE with the received message.
            break;
        default:
            break;
    }
}];
Code Message How to solve
(Required implementation) PromotionNetworkError Failed to communicate with the HIVE server. Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
(Required implementation) PromotionServerResponseError The HIVE server communication response value is invalid. Contact HIVE with the received message.
PromotionNotInitialized The HIVE SDK has not been initialized. Call the AuthV4.setup API to initialize the HIVE SDK. View API

Promotion.getBadgeInfo

Promotion.getBadgeInfo ((ResultAPI result, List<PromotionBadgeInfo> badgeInfoList) => {
    switch(result.code) {
        case ResultAPI.Code.PromotionNetworkError:
        // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
        break;
        case ResultAPI.Code.PromotionServerResponseError:
        // Contact HIVE with the received message.
        break;
    }
});
Promotion::showOfferwall([](ResultAPI const & result, std::vector<PromotionBadgeInfo> const & badgeInfoList){
    switch(result.code) {
        case ResultAPI::Code::PromotionNetworkError:
        // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
        break;
        case ResultAPI::Code::PromotionServerResponseError:
        // Contact HIVE with the received message.
        break;
    }
});
Promotion.getBadgeInfo(new PromotionBadgeInfoListener() {
    @Override
    public void onReceiveInfo(ResultAPI result, ArrayList<PromotionBadge> badgeInfoList) {
        switch(result.code) {
            case PromotionNetworkError:
                // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
                break;
            case PromotionServerResponseError:
                // Contact HIVE with the received message.
                break;
        }

    }
});
[HIVEPromotion getBadgeInfo:^(HIVEResultAPI *result, NSArray<HIVEPromotionBadge *> *badgeInfos) {
    switch (result.code) {
        case kPromotionNetworkError:
            // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
            break;
        case kPromotionServerResponseError:
            // Contact HIVE with the received message.
            break;
        default:
            break;
    }
}];
Code Message How to solve
(Required implementation) PromotionNetworkError Failed to communicate with the HIVE server. Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
(Required implementation) PromotionServerResponseError The HIVE server communication response value is invalid. Contact HIVE with the received message.
PromotionNotInitialized The HIVE SDK has not been initialized. Call the AuthV4.setup API to initialize the HIVE SDK. View API

Promotion.getAppInvitationData

Promotion.getAppInvitationData ((ResultAPI result, AppInvitationData appInvitationData) => {
    switch(result.code) {
        case ResultAPI.Code.PromotionNetworkError:
        // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
        break;
        case ResultAPI.Code.PromotionInvalidResponseData:
        // Contact HIVE with the received message.
        break;
        case ResultAPI.Code.PromotionServerResponseError:
        // Contact HIVE with the received message.
        break;
    }
});
Promotion::getAppInvitationData([](ResultAPI const & result, AppInvitationData const & appInvitationData){
    switch(result.code) {
        case ResultAPI::Code::PromotionNetworkError:
        // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
        break;
        case ResultAPI::Code::PromotionInvalidResponseData:
        // Contact HIVE with the received message.
        break;
        case ResultAPI::Code::PromotionServerResponseError:
        // Contact HIVE with the received message.
        break;
    }
});
Promotion.getAppInvitationData(new AppInvitationDataListener() {
    @Override
    public void onAppInvitationData(ResultAPI result, AppInvitationData appInvitationData) {
        switch(result.code) {
            case PromotionNetworkError:
                // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
                break;
            case PromotionInvalidResponseData:
                // Contact HIVE with the received message.
                break;
            case PromotionServerResponseError:
                // Contact HIVE with the received message.
                break;
        }

    }
});
[HIVEPromotion getAppInvitationData:^(HIVEResultAPI *result, HIVEAppInvitationData *invitationData) {
    switch (result.code) {
        case kPromotionNetworkError:
            // Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
            break;
        case kPromotionInvalidResponseData:
            // Contact HIVE with the received message.
            break;
        case kPromotionServerResponseError:
            // Contact HIVE with the received message.
            break;
        default:
            break;
    }
}];
Code Message How to solve
(Required implementation) PromotionNetworkError Failed to communicate with the HIVE server. Check the device's network connection status. If this error occurs even when the device network connection is normal, contact HIVE with the error message.
(Required implementation) PromotionServerResponseError The HIVE server communication response value is invalid. Contact HIVE with the received message.
(Required implementation) PromotionInvalidResponseData Data that does not comply with the HIVE server communication protocol was delivered. Contact HIVE with the received message.
PromotionNotInitialized The HIVE SDK has not been initialized. Call the AuthV4.setup API to initialize the HIVE SDK. View API

Promotion.setAdditionalInfo

Code Message How to solve
No Result API

Promotion.setEngagementReady

Code Message Resolution
No Result API

Promotion.setEngagementListener

Code Message How to solve
UserEngagementEmptyMarketPid When the Scheme api value is iappurchase, the received Scheme has no item information. (Delivered only when engagementEventType is EngagementEventType.END.) Check the format of the Scheme being delivered. Scheme URL notation
UserEngagementEmptyMarketPid When the Scheme api value is iappromote, the received Scheme has no item information. (Delivered only when engagementEventType is EngagementEventType.END.) Check the format of the Scheme being delivered. Scheme URL notation
UserEngagementEmptyCouponId When the Scheme api value is promotioncoupon, the received Scheme has no coupon information. (Delivered only when engagementEventType is EngagementEventType.END.) Check the format of the Scheme being delivered. Scheme URL notation
Delivers the same response value as the IAPV4.purchase API response. When the Scheme api value is iappurchase, an error occurred while processing the received Scheme. (Delivered only when engagementEventType is EngagementEventType.END.) Check the IAPV4.purchase ResultAPI code.
Delivers the same response value as the Promotion.showOfferwall API response. When the Scheme api value is offerwallshow, an error occurred while processing the received Scheme. (Delivered only when engagementEventType is EngagementEventType.END.) Check the Promotion.showOfferwall ResultAPI code.
Delivers the same response value as the Promotion.showCustomContents API response. When the Scheme api value is promotionshow, an error occurred while processing the received Scheme. (Delivered only when engagementEventType is EngagementEventType.END.) Check the Promotion.showCustomContents ResultAPI code.
Delivers the same response value as the HIVEAuthV4.showCafe API response. When the Scheme api value is socialcafe, an error occurred while processing the received Scheme. (Delivered only when engagementEventType is EngagementEventType.END.) Check the HIVEAuthV4.showCafe ResultAPI code.
Delivers the same response value as the HIVEAuthV4.showInquiry API response. When the Scheme api value is socialinquiry, an error occurred while processing the received Scheme. (Delivered only when engagementEventType is EngagementEventType.END.) Check the HIVEAuthV4.showInquiry ResultAPI code.

Promotion.showUAShare

Promotion.showUAShare ("Invite Message", "https:// invite.link", (ResultAPI result) => {
    switch(result.code) {
        ...
    }
});
Promotion::showUAShare("Invite Message", "https:// invite.link",  [=](ResultAPI const & result){
    switch(result.code) {
        ...
    }
});
Promotion.showUAShare("Invite Message", "https:// invite.link",  new com.hive.Promotion.PromotionShareListener() {
    @Override
    public void onPromotionShare(ResultAPI result) {
        switch(result.code) {
            ...
        }

    }
});
[HIVEPromotion showUAShare:"Invite Message" inviteLink:"https:// invite.link" handler:^(HIVEResultAPI *result) {
    switch (result.code) {
        ...
    }
}];
Code Message How to solve
PromotionShareFailed The SNS could not process the data normally. If an error code is received from the shared SNS, the corresponding error pop-up is displayed, and you must contact the SNS for each error cause.
PromotionShareFailed The entered message and share link are invalid. Check whether the entered message and share link are valid.