Apple App Clip 연동 가이드

개발자가 앱용 App Clip을 생성하는 방법에 대한 전체 가이드는 개발자용 Apple App Clip 가이드를 참조하십시오.

App Clip의 사용법과 전체 앱과의 연동을 보여주는 간단한 샘플 앱을 보려면, 앱스플라이어 App Clip 가이드를 참조하십시오.

• 클릭, 인스톨, 인앱 이벤트, App Clip-투-전체 앱 설치의 앱스플라이어 어트리뷰션을 위해서는 SDK가 필요합니다.
• 원링크는 SDK 연동과는 별개로 유저를 리디렉션합니다.

SDK를 설치하고 전체 앱 SDK를 구성하려면: 

iOS 개발자에게 다음 링크를 보내고 관련 가이드를 따르도록 안내하시기 바랍니다:

• App Clip에 SDK 연동
• App Clip-투-전체 앱 인스톨 어트리뷰션 구성
• [선택 사항] 전체 앱에 대해 아직 인앱 이벤트를 측정하고 있지 않거나 App Clip에 다른 인앱 이벤트를 사용하려는 경우, 인앱 이벤트를 설정하십시오.

선행 조건:

• iOS 유니버설 링크가 설정된 전체 앱용 원링크 템플릿
• 원링크 링크
• 권장 사항: 여기서 사용되는 템플릿과 링크는 전체 앱이 없는 유저를 App Clip으로 보냅니다. 따라서 이러한 유저를 App Clip 대신 앱스토어로 보내려는 경우에는 별도의 템플릿과 사용자 지정 링크를 사용하는 것이 좋습니다.

App Clip용 원링크 템플릿을 구성하려면:

1. 앱스플라이어 대시보드에서 인게이지 > 원링크 관리로 이동합니다.
2. 유저를 전체 앱으로 디렉션하는 데 사용되는 원링크 템플릿을 선택하세요. 
3. 원링크 템플릿에 유니버설 링크가 구성되어 있는지 확인하세요. (유니버설 링크를 추가하려면 여기를 참조하세요.)
4. 저장을 클릭합니다.
   App Clip을 지원하도록 AASA 파일이 업데이트됩니다.
5. 앱스플라이어 대시보드에서 인게이지 > 원링크 관리로 이동합니다.
6. 1~4단계에서 구성한 템플릿을 기반으로 유저를 App Clip으로 안내하는 데 사용하는 원링크 커스텀 링크를 선택합니다.
7. 미디어 소스(pid)를 지정했는지 확인하세요.
   미디어 소스는 URL (예: pid=chartboost_int)에 지정되거나 링크 내에 포함되어야 합니다.

앱스플라이어 원링크에서 App Clip이 활성화되었는지 확인하려면:

1. URL을 생성하여 연결된 파일을 가져오세요. URL은 원링크 템플릿에서 가져온 도메인을 추가하여 생성됩니다. /.well-known/apple-app-site-association 
   예: coffee.onelink.me/.well-known/apple-app-site-association.
2. 연결된 파일의 URL로 이동합니다.
   apple-app-site-association 파일이 자동으로 다운로드됩니다.
3. 텍스트 편집기(예: 메모장)를 사용하여 apple-app-site-association 파일을 엽니다.
4. 파일에 “appclips”라는 단어가 포함되어 있고 번들 ID가 “.Clip”으로 끝나는지 확인하십시오. 예시:
   

   "appclips": {
       "apps": [
         "ABCD1234.id.your.app.Clip",
         ...
       ]
   ...
   }

   위의 사항이 모두 확인됐다면, 앱스플라이어에서 App Clip을 성공적으로 설정했다는 뜻이며, 동일한 서브 도메인이 설정된 모든 원링크 템플릿 App Clip이 구현된 것입니다.

선행 조건: App Clip을 위한 원링크 템플릿 구성 완료

원링크와 연동되도록 App Clip을 구성하려면: 

1. App Store Connect 내 귀하의 앱 페이지에서 Build > Domain Status로 이동합니다.
2. 원링크 도메인이 Build Domains에 표시되고 Cache Status와 Debug Status가 모두 “검증”되었는지 확인하십시오.
3. 앱스플라이어 대시보드에서 인게이지 > 원링크 관리로 이동합니다.
4. 사용하려는 링크의 조치 아이콘 위에 마우스를 놓고 URL 가져오기를 클릭합니다. 
5. 짧은 URL을 기록합니다. (또는 긴 URL의 prefix를 기록합니다.) 
6. App Store Connect의 앱 페이지에서 App Clip > Edit Advanced Experiences > +Add > Next로 이동합니다.
7. App Clip Experience URL에 5단계에서 기록한 원링크 사용자 지정 URL을 붙여넣습니다.
   참고: 기본 맞춤 URL 뒤에 쿼리 파라미터를 추가할 수 있지만 경로를 변경할 수는 없습니다.
8. 다음을 클릭합니다.
   이제 App Clip이 원링크와 함께 작동하도록 구성되었습니다. App Store Connect 설정에 관한 추가 지침은 Apple Developer에서 확인할 수 있습니다.

선행 조건: 전체 앱이 설치되지 않은 iOS 14 버전의 등록된 테스트 디바이스

원링크/App Clip 연동을 테스트하려면:

1. 앱스플라이어 대시보드에서 인게이지 > 원링크 관리로 이동합니다.
2. 테스트하고자 하는 링크의 액션 아이콘을 클릭하고 URL 가져오기를 클릭합니다. 
3. 디바이스로 QR 코드를 스캔합니다.
   App Clip 카드가 디바이스에 표시되면, 원 링크/App Clip 연동이 제대로 설정되었음을 나타냅니다.