콘텐츠로 이동

Unreal

Unreal Engine용 SDK에서 프로모션 기능을 사용하기 위한 설정을 안내합니다.

기능 추가

  1. Unreal Editor의 메뉴에서 Edit > Project Settings을 클릭하세요. Project Settings 창이 나타납니다.

  2. Project Settings 창의 좌측 패널에서 SDK 하위의 Dependency – Android / Dependency – iOS를 클릭하세요.

  3. Hive Module에서 Enable HivePromotion을 선택하세요. Unreal Android 환경에서 Google InApp Review를 사용하려면 Enable HivePromotion을 선택해야 합니다.

유니버설 링크 설정하기

유니버설 링크를 사용하면 초대 페이지를 통한 앱 최초 설치와 실행, 초대자 보상을 지원할 수 있습니다.

Note

유니버설 링크 기반의 초대자 링크 생성을 위한 추가 콘솔 설정은 개발자 사이트의 프로모션 운영 가이드를 참고하세요.

iOS에서 유니버설 링크가 동작하려면 앱 entitlements의 Associated Domains 항목에 서비스할 도메인 정보(applinks:)를 포함해야 합니다.

Note

Hive SDK v4 26.4.1 이상에서는 앱 종료 상태에서 유니버설 링크로 앱을 실행하는 경우의 딥링크 처리를 Hive SDK 플러그인이 자동으로 수행합니다. 아래 Associated Domains 설정 외에 별도의 코드 작업은 필요하지 않습니다.

Unreal Engine 5에서는 엔진 수정 없이 PremadeIOSEntitlements 설정으로 entitlements를 적용할 수 있습니다. entitlements 파일의 생성과 적용 방법은 Entitlements 설정 (iOS)을 참고하세요.

entitlements 파일의 com.apple.developer.associated-domains 배열에 게임에서 사용하는 도메인을 추가하세요.

<key>com.apple.developer.associated-domains</key>
<array>
    <!-- 아래 도메인은 SDK 샘플 앱에 사용된 예시입니다. 게임에서 사용하는 도메인을 추가하세요. -->
    <string>applinks:hiveota.withhive.com</string>
    <string>applinks:dev-promotion.qpyou.cn</string>
    <string>applinks:promotion.qpyou.cn</string>
    <string>applinks:sandbox-promotion.qpyou.cn</string>
    <string>applinks:test-promotion.qpyou.cn</string>
    <string>applinks:direct-link.withhive.com</string>
    <string>applinks:sandbox-direct-link.withhive.com</string>
    <string>applinks:test-direct-link.withhive.com</string>
</array>

빌드된 앱에 도메인이 적용되었는지는 아래 명령어로 확인할 수 있습니다.

codesign -d --entitlements :- {빌드된 .app 경로}

IOSExport.cs의 entitlements 생성부에 com.apple.developer.associated-domains 항목과 게임에서 사용하는 도메인을 추가하세요. 수정 위치는 Entitlements 설정 (iOS)을 참고하세요.

// Add
Text.AppendLine( "\t<key>com.apple.developer.associated-domains</key>");
Text.AppendLine( "\t<array>");
// 아래 도메인은 SDK 샘플 앱에 사용된 예시입니다. 게임에서 사용하는 도메인을 추가하세요.
Text.AppendLine("\t\t<string>applinks:hiveota.withhive.com</string>");
Text.AppendLine("\t\t<string>applinks:dev-promotion.qpyou.cn</string>");
Text.AppendLine("\t\t<string>applinks:promotion.qpyou.cn</string>");
Text.AppendLine("\t\t<string>applinks:sandbox-promotion.qpyou.cn</string>");
Text.AppendLine("\t\t<string>applinks:test-promotion.qpyou.cn</string>");
Text.AppendLine("\t\t<string>applinks:direct-link.withhive.com</string>");
Text.AppendLine("\t\t<string>applinks:sandbox-direct-link.withhive.com</string>");
Text.AppendLine("\t\t<string>applinks:test-direct-link.withhive.com</string>");
Text.AppendLine( "\t</array>");
// Add End