adjust-icon

딥링크 설정 구성

요구 사항

  • 브랜드 도메인 설정을 위한 Adjust 대시보드에서의 관리자 권한
  • 앱 설정 관리를 위해 Adjust 대시보드에서 편집자 권한 이상이 필요합니다.

앱 생성

Adjust 대시보드에서 앱을 생성합니다.

Adjust 대시보드는 각 앱에 대해 하나의 번들 ID(com.example.app)와 앱 스킴(example://)만 지원합니다. 앱이 릴리스 및 디버그 빌드에 서로 다른 번들 ID 및/또는 앱 스킴을 사용하는 경우 별도의 디버그 앱을 만드세요.

iOS 플랫폼 추가

앱의 플랫폼 설정에 iOS를 추가하세요. 이 단계에서는 번들 ID를 입력해야 합니다. 앱 빌드의 번들 ID가 확실하지 않은 경우 임시 값(com.example.app)을 입력하여 플랫폼 설정을 저장합니다. 이 가이드의 나머지 부분을 따라 모든 필요한 데이터 포인트를 수집한 후, 대시보드의 플랫폼 설정으로 돌아가서 구성을 완료합니다.

브랜드 도메인 설정

Adjust 대시보드에서 Adjust의 go.link 도메인(예: brandname.go.link)을 사용하여 브랜드 도메인을 설정합니다.

iOS 앱과 Android 앱이 Adjust에서 별도의 앱을 사용하는 경우, Adjust 대시보드에서 두 앱에 대해 동일한 브랜드 도메인(brandname.go.link)을 선택해야 합니다.

릴리스 빌드와 디버그 빌드에 별도의 앱을 사용하는 경우, 디버그 앱에 대해 별도의 브랜드 도메인을 생성합니다(brandnamedebug.go.link). Adjust에서 디버그 앱이 iOS와 Android에 대해 별도의 앱을 사용하는 경우, Adjust 대시보드에서 두 디버그 앱에 대해 동일한 브랜드 도메인을 선택해야 합니다.

다음 섹션에서 Xcode에서 구성할 브랜드 도메인을 기록해 두세요.

Xcode에서 설정 구성

  1. Xcode 프로젝트를 엽니다.

  2. 탐색기 창에서 프로젝트 이름을 선택하여 프로젝트 설정에 액세스합니다.

  3. 프로젝트 설정의 Targets 에서 적절한 타겟(일반적으로 앱의 이름)을 선택합니다.

  4. 서명 및 기능 탭을 선택합니다.

  5. 릴리스디버그 하위 탭 모두에 대해 다음 단계를 완료합니다.

    • 번들 식별자 필드에 값을 기록합니다. 이 값은 앱의 번들 ID(각각 ‘Release Bundle ID’ 또는 ‘Debug Bundle ID’)이며, Adjust 대시보드의 iOS 플랫폼 설정에서 구성해야 합니다.

    • Associated Domains 섹션에서 각 브랜드 도메인에 대한 항목을 추가합니다. 예시 도메인 brandname.go.link에 대한 필수 항목은 다음과 같습니다.

      applinks:brandname.go.link

누락되었거나 문제가 있는 Associated Domains 설정 문제 해결

  • Associated Domains 섹션이 표시되지 않으면 먼저 이를 활성화해야 할 수도 있습니다.

    1. 릴리스 또는 디버그 하위 탭(누락된 경우) 옆에 있는 + 기능 을 클릭합니다.
    2. ‘Associated Domains’을 검색하여 선택합니다.
  • Associated Domains를 활성화하려고 할 때 ‘프로비저닝 프로필 {profile_name}이 Associated Domains 기능을 지원하지 않습니다’와 같은 오류 메시지가 표시되면 프로비저닝 프로필을 업데이트해야 할 가능성이 높습니다.

앱 스킴 검색 또는 구성하기

iOS에서 유니버설 링크를 지원하지 않는 특정 사용 사례에는 앱 스킴이 필요합니다. Adjust 딥링킹에 기존 앱 스킴을 재사용할 수 있습니다.

  1. Xcode 탐색기 창에서 프로젝트 이름을 선택하여 프로젝트 설정에 액세스합니다.
  2. 대상에서 적절한 대상(일반적으로 앱 이름)을 선택합니다.
  3. 정보 탭을 선택합니다.
  4. URL Types 섹션을 펼쳐보기 합니다.

앱에 이미 앱 스킴이 있는 경우 URL 유형 항목이 있으며 각 항목에는 URL 스킴 에 대한 단일 값이 있습니다. 아래 표를 사용하여 URL 유형 구성을 기반으로 앱 스킴을 결정하세요. 나중에 Adjust 대시보드에서 구성할 수 있도록 앱 스킴을 기록해 두세요.

URL 스킴 필드앱 스킴
정적 값. 예: exampleexample:// ‘Release App Scheme’
별도의 URL 유형 항목에서 example, exampleDebug 와 같은 정적 값example:// ‘Release App Scheme’
exampleDebug://는 ‘Debug App Scheme’
동적 빌드 설정 변수. 예: $(APP_SCHEME)빌드 설정 탭으로 이동 -> 변수 이름 검색(예: ‘APP_SCHEME’) -> 릴리스 및 디버그의 값은 각각 ‘Release App Scheme’ 및 ‘Debug App Scheme’입니다

앱 스킴을 생성해야 하는 경우 다음 단계를 따르세요.

  • + 버튼을 선택하여 새 URL 유형을 추가합니다.

  • 다음 필드를 입력하세요.

    • 식별자 : $(PRODUCT_BUNDLE_IDENTIFIER)
    • 역할 : 편집자
    • URL 스킴 : 원하는 앱 스킴 값을 입력합니다(example이 아니라 example://을 입력하세요). http, https 또는 예약된 iOS 스킴(예: mailto, tel, sms, facetime)을 사용하지 마세요. 여기에 정적 값을 입력하면 릴리스 및 디버그 빌드 모두에 사용되는 단일 앱 스킴이 생성됩니다.
  • 앱 스킴이 생성되면, 나중에 Adjust 대시보드에서 구성할 수 있도록 앱 스킴을 기록해 두세요.

Apple 개발자 포털 에서 앱 ID 접두사 가져오기

  1. Apple 개발자 포털에 로그인합니다.
  2. Certificates, IDs & Profiles 에서 Identifiers 를 선택합니다.
  3. 해당 앱을 선택합니다.
  4. 페이지 상단에서 다음 섹션의 Adjust 대시보드에서 구성할 앱 ID 접두사 를 기록해 두세요.

iOS 플랫폼 구성 완료

Adjust 대시보드에서 수집한 아래 데이터 포인트를 사용하여 앱의 iOS 플랫폼 설정을 완료합니다.

데이터 포인트예시필수 요건
릴리즈 번들 IDcom.example.app필수
디버그 번들 IDcom.example.debugDebug Bundle ID가 Release Bundle ID와 다른 경우 필수입니다.
Release App Schemeexample://iOS가 유니버설 링크를 지원하지 않는 경우 필수입니다.
Debug App SchemeexampleDebug://Debug App Scheme이 Release App Scheme과 다른 경우 필수입니다.
앱 ID 접두사ABCDE12345필수