콘텐츠로 이동

iOS

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

프레임워크 추가

프로젝트 디렉토리의 Podfile에 프레임워크를 추가합니다.

pod 'HivePromotion', $HIVE_SDK_VERSION # 프로모션 기능 사용을 위한 프레임워크

위와 같이 프레임워크를 추가한 Podfile을 저장한 후, 아래 명령어를 실행하여 프로젝트에 프레임워크를 설치합니다.

pod install

딥링크 설정하기

딥링크는 이용자를 앱 실행 후 앱 특정 위치로 이동시키는 링크입니다. 프로모션 유저 인게이지먼트에서 딥링크 스킴에 대한 처리를 지원합니다.

  1. Xcode 프로젝트 창의 프로젝트 네비게이터에서 여러분의 프로젝트를 선택하세요.
  2. TARGETS 목록에서 여러분의 앱을 선택하세요.
  3. Info 탭을 클릭하세요.
  4. Info 탭 안의 URL Types 항목을 클릭하세요.
  5. + 아이콘을 클릭하여 Additional url type properties 항목을 생성하세요.
  6. Additional url type properties 항목 아래 Identifier 필드와 URL Schemes 필드에 여러분의 AppID를 입력하세요.


다음의 코드를 이용하여 HTML 페이지를 만들어 게임이 설치된 앱에서 HTML을 띄워 URL Scheme 동작을 테스트 할 수 있습니다. 다만 링크의 주소는 딥링크 설정 시 설정한 URL과 동일한 값이어야 합니다.

<a href="com.com2us.myapp://">TEST</a>

디퍼드 딥링크 설정하기 (Universal Link)

Universal Link를 사용하여 초대 페이지를 통한 앱 최초 설치 및 실행, 초대자 보상이 이루어 집니다. Hive SDK iOS는 URI Scheme 기반 디퍼드 딥링크와 Universal Link 기반 디퍼드 딥링크를 모두 지원합니다.

Universal Link 기반의 초대 링크 실행과 초대자 보상은 UIPasteboard 붙여넣기 시스템 권한을 필요로 합니다. 초대받은 사용자가 초대 링크로 앱을 최초 설치, 실행 시 iOS 16.1 미만에서는 토스트 팝업이, iOS 16.1 이상에서는 시스템 권한 요청 팝업이 노출될 수 있습니다. 시스템 권한 요청 팝업을 노출하지 않으려면 개발자 사이트의 프로모션 운영가이드를 참고하여 디퍼드 딥링크 설정을 미사용으로 설정해주세요.

iOS 16.1 미만

iOS 16.1 이상
Note

Universal Link 기반의 초대자 링크 생성을 위한 추가 콘솔 설정은 개발자 사이트의 프로모션 운영가이드를 참고 하세요.
시스템 권한 요청 팝업의 문구는 개발자가 임의로 수정할 수 없습니다.

Xcode 프로젝트 설정

Xcode 프로젝트의 메인 TARGETS을 선택하고, Signing & Capabilities 탭의 Associated Domains 항목에서 다음과 같이 Domains를 설정하세요.


  • applinks:sandbox-promotion.qpyou.cn: Hive 샌드박스 서버 환경에서 동작하는 Universal Link 도메인
  • applinks:promotion.qpyou.cn: Hive 상용 서버 환경에서 동작하는 Universal Link 도메인

서버 설정하기

주어진 양식으로 나열된 아래 값을 환경에 맞게 변경하여 apple-app-site-association 형태로 저장합니다.

  • TEAM ID: Apple 개발자 콘솔에서 조회한 TEAM ID
  • Bundle Identifier: Universal Link를 사용하려는 앱의 번들 ID
  • URL Path: Universal Link를 지원할 HTTP URL

웹 서버의 루트, 또는 .well-known의 서브 경로에 업로드합니다. apple-app-site-association 파일의 형식은 JSON이나, 확장자를 만들지 않습니다.

{
   "applinks": {
       "apps": [],
       "details": [
           {
               "appID": "--TEAM ID.--Bundle Identifier",
               "paths": ["--URL Path"]
           }
       ]
   }
}

다음은 Apple에서 제공한 예시입니다.

{
   "applinks": {
       "apps": [],
       "details": [
           {
               "appID": "9JA89QQLNQ.com.apple.wwdc",
               "paths": ["/wwdc/news/", "/videos/wwdc/2015/*"]
           }, {
               "appID": "ABCD1234.com.apple.wwdc",
               "paths": ["*"]
           }
       ]
   }
}

iOS 앱 설정하기

Xcode 프로젝트에서 아래 안내를 따릅니다.

  1. Xcode 프로젝트 창의 프로젝트 네비게이터에서 여러분의 프로젝트를 선택하세요.
  2. TARGETS 목록에서 여러분의 앱을 선택하세요.
  3. Signing & Capabilities 탭을 클릭하세요.

  1. Signing & Capabilities 탭 좌측 상단에 있는 + Capability 버튼을 클릭하세요.

  2. 목록에서 Associated Domains를 선택해 추가합니다. applinks:[apple-app-site-association]가 업로드된 도메인(예시: applinks:hive-ota.withhive.com)

    3. Apple 개발자 콘솔에서 앱의 Capabilities에 Associated Domain을 활성화합니다.

hive_config.xml 설정하기

hive_config.xml 파일에 아래의 내용을 추가/수정합니다.

<universalLink>Universal link 주소(Domain/Path) </universalLink>