Promotional IAP

Promotional IAP is provided for iOS 11. This function allows you to register twenty-in-app products to expose through the Product list or Search box on Apple App Store. On game, utilize Hive SDK v4.4.1 to activate Promotional IAP.

Refer to the followings for details of Promotional IAP.

• Promoting Your In-App Purchases
• Promoting In-App Purchases Programming Guide

To code the Promotional IAP, Hive SDK provides checkPromotePurchase API. The API returns Market PID, which is requested from Apple App Store. Make sure to implement the following works before calling checkPromotePurchase API.

• Define and register UE global callback
• Set to process UE event or not

After initializing IAP v4 and completing the actions above you can receive iappromote event through UE global callback. When sending the event, call Product List Search API and checkPromotePurchase API in sequence to receive Market PIDs of which users requested to purchase from App Store. When Market PID is returned, code for users to purchase the item matched with Market PID.

using hive;    
    IAPV4.checkPromotePurchase((ResultAPI result, String marketPid) => {    
      if (result.isSuccess()) {    
      // TODO: Check marketPid and proceed with product purchase using purchase API    
      }    
});

#include "HiveIAPV4.h"

FHiveIAPV4::CheckPromotePurchase(FHiveIAPV4OnCheckPromotePurchaseDelegate::CreateLambda([=](const FHiveResultAPI& Result, const FString& MarketPid) {
        if (Result.IsSuccess()) {
                // Check marketPid and proceed with product purchase using purchase API
        }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    IAPV4::checkPromotePurchase([=](ResultAPI const & result, string marketPid) {    
      if (result.isSuccess()) {    
      // TODO: Check marketPid and proceed with product purchase using purchase API    
      }    
}

import HIVEService    
    IAPV4Interface.checkPromotePurchase() { result, marketPid in    
      if result.isSuccess() {    
      // TODO: Check marketPid and proceed with product purchase using purchase API    
      }    
}

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEIAPV4 checkPromotePurchase: ^(HIVEResultAPI *result, NSString *marketPid) {    
      if ([result isSuccess]) {    
      // TODO: Check marketPid and proceed with product purchase using purchase API    
      }    
}];