이 페이지는 Cloud Translation API를 통해 번역되었습니다.

동적 링크의 커스텀 도메인 설정

Dynamic Links 기기를 더 세부적으로 관리할 수 있습니다. 자체 기술을 사용하여 (page.link 하위 도메인 대신) 커스텀 도메인을 사용하면 Dynamic Links는 다음 예와 같습니다.

https://example.com/link-suffix
https://example.com/links/promos/link-suffix
https://links.example.com/link-suffix
https://ex.amp.le/link-suffix

URL에서 link-suffix 앞에 오는 부분을 URL 접두사라고 합니다. 커스텀 Dynamic Link 도메인과 경로 접두사를 모두 포함합니다. 다음 작업을 수행해야 합니다. Dynamic Links를 만들 때 URL 접두사를 제공합니다.

커스텀 도메인을 설정하려면 Firebase 프로젝트의 편집자 또는 소유자 권한이 필요합니다.

Dynamic Links에 웹 도메인 사용

Dynamic Links 및 웹페이지(범용)에 동일한 도메인을 사용할 수 있습니다. 링크, 앱 링크를 포함할 수 있지만, 이 경우 Dynamic Link URL에 주의해야 합니다. 웹 URL과 충돌하지 않아야 합니다. Dynamic Links를 구성하여 특정 URL 접두사로 시작하는 경우 해당 접두사로 시작하는 모든 URL은 Dynamic Links, 해당 접두사가 포함된 URL을 사용하여 일반 호스팅된 있습니다.

예를 들어 리소스에 대해 Dynamic Link를 만들려는 경우 https://example.com/my-resource (웹페이지, 범용 링크 또는 앱 링크) https://example.com/를 Dynamic Links URL 접두사로 사용할 수 없습니다. https://example.com/my-resource가 Dynamic Link로 취급됩니다. 대신 다른 도메인 또는 다른 경로 프리픽스가 있는 URL 프리픽스를 사용해야 합니다.

따라서 다음과 같은 긴 형식 Dynamic Links (및 상응하는 짧은 링크)는 다음과 같이 작동하지 않습니다. link 매개변수로 지정된 URL이 Dynamic Link URL 접두사, https://example.com/:

 https://example.com/?link=https://example.com/my-resource
 https://example.com/?link=https://example.com/resources/my-resource

그러나 다음과 같은 긴 형식 Dynamic Links (및 상응하는 짧은 링크)는 작동할 수 있습니다. 다음과 같이 URL 접두사가 link URL과 충돌하지 않기 때문입니다.

 https://link.example.com/?link=https://example.com/my-resource
 https://example.com/links/?link=https://example.com/my-resource
 https://ex.amp.le/?link=https://example.com/my-resource

Firebase 콘솔에서 커스텀 도메인 설정

일반적으로 Firebase 콘솔에서 커스텀 도메인을 완전히 설정할 수 있습니다. 다음 안내를 따르세요.

프로젝트에 Firebase Hosting를 설정하지 않았다면 Firebase 콘솔의 Hosting 페이지에서 다음을 클릭합니다. 시작하기를 클릭하고 설정 안내를 클릭합니다. 표시된 단계를 지금 완료하지 않아도 됩니다.
Firebase 콘솔의 Dynamic Links 페이지를 엽니다.
Dynamic Links을 사용한 적이 없다면 시작하기를 클릭합니다. 그렇지 않으면 드롭다운 메뉴에서 URL 접두사 추가를 선택합니다.

그런 다음 메시지가 표시되면 사용할 도메인과 경로 프리픽스를 지정하여 설정 마법사를 완료합니다.

참고: Dynamic Links와 일반에 동일한 URL 접두사를 사용할 수 없습니다. 호스팅합니다. 두 가지에 동일한 브랜딩을 사용하려면 경로 접두어 (예: example.com/links) 또는 하위 도메인 (links.example.com/)을 Dynamic Links URL 프리픽스에 포함합니다.
iOS만 해당: Xcode 프로젝트의 Info.plist 파일에서 FirebaseDynamicLinksCustomDomains하고 앱의 Dynamic Links URL로 설정 접두사로 대체합니다. 예를 들면 다음과 같습니다.
```
<key>FirebaseDynamicLinksCustomDomains</key>
<array>
  <string>https://example.com/link</string>
  <string>https://example.com/promos</string>
</array>
```

수동으로 커스텀 도메인 설정

일부 경우(예: 이미 맞춤 도메인을 설정한 경우) Dynamic Links 다른 도메인을 추가하고 싶거나 이미 도메인을 추가하는 경우 Hosting 사이트에 연결되어 있으면 맞춤 도메인을 수동으로 설정해야 합니다.

방법은 다음과 같습니다.

도메인을 Firebase Hosting에 연결 '확인'을 클릭하세요.

Firebase Hosting로 도메인을 설정하는 작업에는 구성 파일 firebase.json 확인할 수 있습니다
최신 버전의 Firebase CLI로 업데이트 (v6.5.0 이상)
프로젝트의 Dynamic Links에 사용할 Hosting 사이트를 구성합니다. firebase.json 파일 프로젝트에 여러 사이트가 있으면 사용할 도메인에 연결된 사이트를 구성해야 합니다.
- appAssociation을 AUTO로 설정합니다. 이 설정을 사용하면 Hosting assetlinks.json 및 apple-app-site-association를 동적으로 생성 파일 전체가 축소될 수 있습니다.
- 재작성을 설정하여 Dynamic Links에 사용할 경로 프리픽스를 지정합니다. dynamicLinks이(가) true(으)로 설정된 규칙이 있습니다. 이러한 경로에 대한 요청은 Dynamic Links에 프록시 처리됩니다.
  
  경로를 URL에 재작성하는 규칙과 달리 Dynamic Link 재작성 규칙은 경로를 URL에 재작성할 수 없습니다. 정규 표현식 포함
  
  사이트에 여러 재작성 규칙이 있는 경우 Hosting는 요청과 일치하는 첫 번째 재작성 규칙을 실행합니다.
예를 들면 다음과 같습니다.
```
"hosting": {
  // ...
  "appAssociation": "AUTO",
  "rewrites": [
    {
      "source": "/promos/**",
      "dynamicLinks": true
    },
    {
      "source": "/links/share/**",
      "dynamicLinks": true
    }
  ]
}
```
위의 구성을 사용하면 다음과 같은 URL 접두사로 Dynamic Links를 만들 수 있습니다. 다음 예를 참고하세요.
```
https://your-domain/promos/link-suffix
https://your-domain/links/share/link-suffix
```
참고: Dynamic Links와 일반에 동일한 URL 접두사를 사용할 수 없습니다. 호스팅합니다. 두 가지에 동일한 브랜딩을 사용하려면 경로 접두어 (예: example.com/links) 또는 하위 도메인 (links.example.com/)을 Dynamic Links URL 프리픽스에 포함합니다.

이 도메인을 Dynamic Links에만 사용하는 경우 /**의 소스 경로를 사용할 수 있습니다. 경로 프리픽스 없이 Dynamic Links를 만듭니다.
```
{
  "source": "/**",
  "dynamicLinks": true
}
```
위의 규칙을 사용하면 다음 예와 같이 Dynamic Links를 만들 수 있습니다.
```
https://your-domain/link-suffix
```
Hosting 구성 변경사항을 배포합니다.
```
firebase deploy --only hosting
```
(선택사항) 배포된 firebase.json 콘텐츠를 확인할 수 있습니다. Hosting REST API
iOS만 해당: Xcode 프로젝트의 Info.plist 파일에서 FirebaseDynamicLinksCustomDomains하고 앱의 Dynamic Links URL로 설정 접두사로 대체합니다. 예를 들면 다음과 같습니다.
```
<key>FirebaseDynamicLinksCustomDomains</key>
<array>
  <string>https://example.com/promos</string>
  <string>https://example.com/links/share</string>
</array>
```

Dynamic Links 및 Hosting의 우선순위

Dynamic Links의 경우 특히 다음 사항에 유의하세요. 호스팅 우선순위.

Dynamic Links URL 접두사가 더 높은 우선순위와 충돌하지 않는지 확인합니다. 호스팅 구성 (예: 호스팅된 정적 콘텐츠는 항상 사용하면 됩니다.
rewrites 속성 내에서 Hosting 응답은 규칙을 준수합니다. 요청된 경로를 캡처하는 첫 번째 source glob에 의해 지정됩니다.

예를 들어 Dynamic Link your-domain/source-path/link-suffix 정적 콘텐츠도 있는데요, your-domain/source-path/index.html, 정적 콘텐츠가 우선 적용됩니다 최종 사용자에게는 index.html 대신 Dynamic Link 마찬가지로 사이트에 정적 콘텐츠가 있다면 your-domain/source-path/link-suffix, 최종 사용자에게는 Dynamic Link가 아닌 정적 콘텐츠가 표시됩니다.

Dynamic Links과 Hosting에 동일한 브랜딩을 사용하려면 다음을 고려하세요. Dynamic Links URL 프리픽스에 다음 옵션 중 하나를 사용하세요.

경로 프리픽스와 일치하도록 source 속성을 설정합니다. 예를 들어 커스텀 도메인이 example.com이면 재 작성 규칙은 다음과 같습니다.

// Domain is example.com
"rewrites": [ {
  "source": "/links/**",  // Dynamic Links start with "https://example.com/links/"
  "dynamicLinks": true
} ]

Dynamic Links에 사용할 하위 도메인을 설정한 후 source 속성을 해당 하위 도메인과 일치합니다. 예를 들어 links.example.com인 경우 재작성 규칙은 다음과 같을 수 있습니다.
```
// Domain is links.example.com
"rewrites": [ {
  "source": "/**",  // Dynamic Links start with "https://links.example.com/"
  "dynamicLinks": true
} ]
```