SDK Integration

PointPub SDK 설정 및 관련 작업을 진행합니다.

0. 최소 지원 사양

• Unity Editor 2021.3 이상

PointPub-1.2.0.unitypackage 이상 버전부터는 Android API Target 35 이상 및 Java 17 이상 환경에서 실행 가능합니다. API 35 환경에서 안정적인 빌드를 위해 Unity Editor 2021.3.44f1 이상, 2022.3.44f1 이상 또는 6.x 을 권장합니다.

iOS는 PointPub-2.0.0.unitypackage 이상 버전부터 지원됩니다.

• Android

  • MinSdkVersion 21

  • CompileSdkVersion 35

• iOS

  • iOS 15.0 이상

    SDK 설치는 iOS 13.0 이상부터 가능합니다.

  • Xcode 16.0 이상

    2025년 4월 24일부터 앱 스토어 커넥트에 업로드하는 앱은 Xcode 16 이상 버전을 사용하여 빌드해야 합니다. https://developer.apple.com/kr/news/

1. PointPub Unity SDK 추가

1) PointPub Unity SDK를 다운로드 합니다.

2) Assets > Import Package > Custom Package를 선택하여 다운로드한 PointPub-x.x.x.unitypackage 파일을 찾아 추가하거나 PointPub-x.x.x.unitypackage를 더블클릭하여 실행합니다.

새로운 Package로 업데이트 시 PointPubUnityPackage를 import 하기 전에, 아래의 폴더를 삭제하신 후 진행해주시기 바랍니다.

• Assets/PointPub 폴더 제거

3) 모든 파일을 선택하고 import 버튼을 클릭합니다.

4) Unity Play Services Resolver가 이미 포함되어 있으시면 PointPubUnityPackage에서 ExternalDependencyManager를 제외하신 후 import 버튼을 클릭합니다.

2. APP ID 설정

PointPub App ID를 Android/iOS를 구분하여 SetAppId 메소드를 호출하여 설정할 수 있습니다.

C#

#if UNITY_IOS || UNITY_IPHONE
  PointPubSDK.Instance.SetAppId("IOS_POINTPUB_APP_ID");
#elif UNITY_ANDROID
  PointPubSDK.Instance.SetAppId("ANDROID_POINTPUB_APP_ID");
#endif

또는 "Unity Editor > Assets > PointPub Settings" 항목을 클릭하여 PointPub App ID를 설정할 수 있습니다. 각 OS 별 PointPub App ID 값을 입력하고 Save 버튼을 클릭합니다.

두 가지 방법 모두를 사용하여 PointPub APP ID를 설정할 경우, SetAppId 메소드를 통해서 설정한 PointPub APP ID 값을 SDK 내부에서 사용합니다.

3. 유저 추적 메시지 설정 및 획득

유저 추적 메시지 설정

애플에서 ATT(App Tracking Transparency) 도입 이후, 유저 추적 권한 획득이 반드시 요구됩니다. 이 권한을 유저에게 요청하기 위해서 "Unity Editor > Assets > PointPub Settings" 항목을 클릭하여 해당 권한이 필요한 이유를 기술하고 Save 버튼을 클릭합니다.

유저 추적 권한 요청

오퍼월 노출 전 RequestTrackingPermission 메소드를 호출하여 유저로부터 추적 권한을 획득하십시오.

유저 추적 권한 요청 팝업 화면

유저 추적 권한 요청하는 메소드를 직접 호출하거나, 다른 광고 관련 라이브러리 또는 다른 서드파티 라이브러리에서 유저 추적 권한을 요청하는지 먼저 확인하십시오.

유저 추적 권한이 구현되지 않는 경우에만 위의 유저 추적 메시지 설정 및 RequestTrackingPermission 메소드를 호출하여 추적 권한을 획득하는 것이 권장됩니다.

#if UNITY_IOS || UNITY_IPHONE                          
PointPubSDK.Instance.RequestTrackingPermission((hasPermission) => {

});
#endif

4. 광고 목록 노출

오퍼월을 노출할 시점에 StartOfferwall 메소드를 호출하여 주십시오.

• 앱 식별값(App ID)을 필수로 입력합니다.

• 유저 식별값(User ID)을 필수로 입력합니다.

  유저 식별값은 고유한 유저 식별값으로 가변적이면 안되며, 개인정보(이메일, 이름, 전화번호)가 포함되면 안됩니다.

• SetUserId 및 SetAppId 메소드를 통해 각각 App ID와 User ID를 반드시 설정해야 합니다. 설정하지 않을 경우 SDK 기능을 사용할 수 없습니다.

• StartOfferwall 메소드 호출 전, SetAppId 및 SetAppId 메소드가 호출되어야합니다.

• 오퍼월이 노출 되거나, 종료된 경우 이벤트를 받을 수 있습니다.

using PointPubUnityPlugin;
using UnityEngine;

...
if (GUI.Button(new Rect(buttonX, buttonY, buttonWidth, buttonHeight), "Start Offerwall", buttonStyle))
{
    // APP ID 설정
    #if UNITY_IOS || UNITY_IPHONE
       PointPubSDK.Instance.SetAppId("<IOS_POINTPUB_APP_ID>");
    #elif UNITY_ANDROID
       PointPubSDK.Instance.SetAppId("<ANDROID_POINTPUB_APP_ID>");
    #endif

    // User ID 설정
    PointPubSDK.Instance.SetUserId("<USER_ID>")
    
    // 디버깅시 로그 활성화
    PointPubSDK.Instance.EnableLogTrace();

    // 오퍼월 광고 목록 노출 (노출과 닫기의 콜백 수신 가능)
    PointPubSDK.Instance.StartOfferWall(
       onOpened: () => {
           // 오퍼월 화면이 노출 된 경우
           Debug.Log("OfferWall opened");
       },
       onClosed: () => {
           // 오퍼월 화면이 닫힌 경우
           Debug.Log("OfferWall closed");
       }
   );
}

EnableLogTrace() 메소드는 로그를 활성화하는 메소드입니다.
광고 목록이 노출되지 않거나 광고 참여 테스트 중 문제가 생길 때에 로그를 활성화하십시오.

5. 가상화폐

포인트펍을 통해 광고 참여하여 획득한 포인트는 포인트펍 서버에서 관리 또는 매체(개발)사의 서버를 통해 관리 가능합니다. 아래의 내용은 가상화폐(포인트) 조회 및 사용 기능은 포인트펍 서버에서 관리되는 경우에 해당됩니다.

담당자 통해 사전에 승인된 앱에서만 사용 가능합니다.

- 자체적으로 포인트를 관리하는 것을 선호합니다. 
- 그 이유는 매체사에서 유연하게 포인트 관련 기능을 구현할 수 있기 때문입니다.
- 서버가 없어서 자체적으로 포인트를 관리하지 못하는 경우에 사용을 권장합니다.

1) 가상화폐 조회

가상화폐 조회의 경우 아래의 시점에 요청하는 것을 권장드립니다.

• 앱 실행

• 상점 진입

• 오퍼월 닫기(종료) 시점

단, 개인정보 동의가 이루어지지 않은 경우 사용이 불가하여 실패가 발생됩니다.

// 가상화폐 조회
PointPubSDK.Instance.GetVirtualPoint(
    onSuccess: (pointName, remainingPoint) => {

    },
    onFailure: (reason) => { 
    
    }
);

2) 가상화폐 사용

가상화폐 사용은 가상화폐 조회 후 발생된 잔액을 사용하는 것을 권장드립니다.

public void QueryVirtualPoint() {
    // 가상화폐 조회
    PointPubSDK.Instance.GetVirtualPoint(
        onSuccess: (pointName, remainingPoint) => {
            // 가상화폐 사용
            if (remainingPoint > 0) {
                SpendVirtualPoint(remainingPoint)
            }
        },
        onFailure: (reason) => { 
    
        });
}

public void SpendVirtualPoint(long amount) {
    // 가상화폐 사용
    PointPubSDK.Instance.SpendVirtualPoint(
        amount,
        onSuccess: (pointName, remainingPoint) => {
 
        },
        onFailure: (reason) => { 
                
        });
}