Promotional IAP

iOS 11 버전부터 ‘App Store에 노출한 인앱 상품의 인게임 구매 연동’ (이하 Promotional IAP) 기능을 지원합니다. Apple App Store의 상품 페이지 및 검색창에서 게임 내 인앱 상품을 노출할 수 있으며, 최대 20개까지 등록 가능합니다. Promotional IAP로 등록한 상품은 iOS 11 버전 이상에서만 볼 수 있습니다.

Promotional IAP에 대한 자세한 설명은 다음을 참고해주세요.

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

Promotional IAP를 구현하기 위해 Hive SDK에서는 Apple App Store에서 구매 요청이 들어온 마켓 PID 값을 반환해주는 checkPromotePurchase API를 제공합니다. checkPromotePurchase API를 호출하기 전에 게임에서는 다음의 선행 작업을 수행해야 합니다.

• • 유저 인게이지먼트(UE) 전역 콜백 선언 및 등록
  • 유저 인게이지먼트(UE) 이벤트 처리 가능 여부 설정

두 작업이 완료되었다면 IAP v4 초기화 이후 UE 전역 콜백을 통해서 iappromote 이벤트를 받을 수 있으며 이벤트 전달 시, 상품 목록 조회를 호출 후 checkPromotePurchase API를 호출하여 App Store에서 구매 요청이 들어온 마켓 PID 값을 반환받을 수 있습니다. 마켓 PID를 반환받았다면 마켓 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()) {
                // 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    
      }    
}];