Как настроить собственный домен для динамических ссылок

Вы можете лучше контролировать брендинг 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. Для этого:

  1. Если вы не настроили Firebase Hosting для своего проекта, откройте страницу Hosting в консоли Firebase, нажмите Начать и следуйте инструкциям по настройке. Сейчас вам не нужно выполнять указанные действия.

  2. Откройте страницу Dynamic Links в консоли Firebase.

  3. Если вы раньше не пользовались Dynamic Links, нажмите Начать. В противном случае нажмите Добавить префикс URL в раскрывающемся меню.

    Затем завершите настройку, указав домен и префикс пути.

  4. Только для 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, вам нужно настроить собственный домен вручную.

Вот как это сделать:

  1. Если вы ещё этого не сделали, подключите домен к Firebase Hosting.

    При настройке домена с помощью Firebase Hosting в каталоге локального проекта создается файл конфигурации firebase.json.

  2. Обновите Firebase CLI до последней версии (6.5.0 или более поздней).

  3. Настройте сайт 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

  4. Разверните изменения конфигурации Hosting:

    firebase deploy --only hosting

    (Необязательно.) Вы можете проверить развернутый контент firebase.json с помощью Hosting REST API.

  5. Только для 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
    } ]