Вы можете лучше контролировать брендинг 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, веб-страниц, универсальных ссылок и ссылок на приложения. Однако в этом случае необходимо следить за тем, чтобы URL Dynamic Link не конфликтовали с URL веб-страниц. Если вы настроите Dynamic Links так, чтобы использовался определенный префикс URL, все URL, начинающиеся с этого префикса, будут обрабатываться как Dynamic Links. Поэтому вы не сможете использовать URL с таким префиксом для указания на обычный размещенный контент.
Например, если вы хотите создать Dynamic Link для ресурса https://example.com/my-resource (веб-страницы, универсальной ссылки или ссылки на приложение), вы не можете использовать https://example.com/ в качестве префикса URL Dynamic Links, поскольку в этом случае https://example.com/my-resource будет обрабатываться как Dynamic Link.
Вместо этого вы должны использовать префикс URL с другим доменом или другим префиксом пути.
Поэтому следующие длинные ссылки Dynamic Links (и эквивалентные им короткие ссылки) не будут работать должным образом, поскольку URL, указанные в параметре link, начинаются с префикса URL Dynamic Link (https://example.com/):
https://example.com/?link=https://example.com/my-resource https://example.com/?link=https://example.com/resources/my-resource
Однако следующие длинные URL Dynamic Links (и эквивалентные им короткие ссылки) могут работать, поскольку их префиксы не конфликтуют с URL link:
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 для своего проекта, откройте страницу Hosting в консоли Firebase, нажмите Начать и следуйте инструкциям по настройке. Сейчас вам не нужно выполнять указанные действия.
Откройте страницу Dynamic Links в консоли Firebase.
Если вы раньше не пользовались Dynamic Links, нажмите Начать. В противном случае нажмите Добавить префикс URL в раскрывающемся меню.
Затем завершите настройку, указав домен и префикс пути.
Только для iOS. В файле
Info.plistпроекта Xcode создайте ключFirebaseDynamicLinksCustomDomainsи задайте для него префиксы URL Dynamic Links приложения. Пример:<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 до последней версии (6.5.0 или более поздней).
Настройте сайт Hosting для Dynamic Links в файле
firebase.jsonпроекта. Если в вашем проекте несколько сайтов, настройте тот, который подключен к нужному домену.Задайте для параметра
appAssociationзначениеAUTO. При этом Hosting динамически генерирует файлыassetlinks.jsonиapple-app-site-associationпо запросу.Укажите префиксы путей, которые вы хотите использовать для Dynamic Links, задав правила перезаписи, в которых для
dynamicLinksустановлено значениеtrue. Запросы по этим путям перенаправляются на Dynamic Links.В отличие от правил, которые перезаписывают пути к URL, правила перезаписи Dynamic Link не могут содержать регулярные выражения.
Если у вас несколько правил перезаписи, помните, что Hosting выполняет первое правило, соответствующее запросу.
Пример:
"hosting": { // ... "appAssociation": "AUTO", "rewrites": [ { "source": "/promos/**", "dynamicLinks": true }, { "source": "/links/share/**", "dynamicLinks": true } ] }При указанной выше конфигурации вы можете создать Dynamic Links с префиксами URL, как в следующих примерах:
https://your-domain/promos/link-suffix https://your-domain/links/share/link-suffix
Если вы используете этот домен только для 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. В файле
Info.plistпроекта Xcode создайте ключFirebaseDynamicLinksCustomDomainsи задайте для него префиксы URL Dynamic Links приложения. Пример:<key>FirebaseDynamicLinksCustomDomains</key> <array> <string>https://example.com/promos</string> <string>https://example.com/links/share</string> </array>
Приоритет для Dynamic Links и Hosting
Для Dynamic Links особенно важно учитывать приоритет хостинга.
- Убедитесь, что префикс URL Dynamic Links не конфликтует с конфигурациями хостинга, имеющими более высокий приоритет (например, размещенный статический контент всегда имеет приоритет над перезаписью).
- В атрибуте
rewritesответ Hosting будет соответствовать правилу, заданному первым глобальным шаблономsource, который захватывает запрошенный путь.
Например, если вы настроили 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, выберите один из следующих вариантов префикса URL для Dynamic Links:
Задайте атрибут
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 } ]