В Revroute вы можете создавать диплинки, позволяющие перенаправлять пользователей на определённую страницу вашего мобильного приложения.

Например, вы создаёте рекламную кампанию для привлечения трафика на страницу конкретного продукта в вашем мобильном приложении.

Следуя приведённому ниже руководству быстрого старта, вы сможете настроить все ваши короткие ссылки с функциональностью диплинков.

Шаг 1: Настройте домены диплинков в Revroute

Прежде чем создавать диплинки, необходимо настроить домены диплинков в вашем рабочем пространстве Revroute. Для этого нужно добавить пользовательский домен, который будет использоваться для диплинков, и настроить конфигурационные файлы диплинков.

Добавление пользовательского домена

Сначала необходимо добавить пользовательский домен в ваше рабочее пространство Revroute. Перейдите в настройки доменов рабочего пространства  и нажмите Add Domain.

Вы можете использовать домен, которым уже владеете, или воспользоваться нашим предложением бесплатного домена .link для регистрации пользовательского домена, например yourcompany.link, и использовать его как домен диплинков.

Настройка конфигурационных файлов диплинков

После настройки пользовательского домена необходимо загрузить конфигурационные файлы диплинков в Revroute, которые мы будем размещать в директории /.well-known/ вашего домена.

Для этого перейдите в настройки доменов рабочего пространства  и нажмите кнопку редактирования для вашего пользовательского домена:

В открывшемся окне домена нажмите Show advanced settings — появятся поля настройки конфигурации диплинков.

iOS (apple-app-site-association)

Для приложений на iOS загрузите файл Apple App Site Association  — он включает диплинки на iOS:

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "<YOUR_APPLICATION_IDENTIFIER_PREFIX>.<YOUR_APPLICATION_BUNDLE_IDENTIFIER>",
        "paths": []
      }
    ]
  }
}

Android (assetlinks.json)

Для приложений на Android загрузите файл AssetLinks — он включает диплинки на Android:

[
  {
    "target": {
      "namespace": "android_app",
      "package_name": "YOUR_PACKAGE_NAME",
      "sha256_cert_fingerprints": []
    },
    "relation": ["delegate_permission/common.handle_all_urls"]
  }
]

Проверьте конфигурационные файлы

После загрузки конфигурационных файлов откройте их по прямым адресам и убедитесь, что они отдаются:

iOS: yourdomain.link/.well-known/apple-app-site-association (пример) 

Android: yourdomain.link/.well-known/assetlinks.json (пример) 

Разрешите домен диплинков в приложении

Наконец, домен диплинков нужно внести в список разрешённых в самом приложении — иначе оно не сможет открывать нужный экран напрямую.

Для приложений на iOS — разрешите сайтам ссылаться на ваше приложение .

Для приложений на Android — подтвердите ссылки приложения .

Шаг 2: Создайте диплинки в Revroute

Домены настроены — теперь можно создавать диплинки, которые открывают конкретный экран вашего приложения.

Укажите целевой URL

Откройте кабинет Revroute  и нажмите Create Link в верхней панели.

Введите целевой URL в поле «Destination URL». Протокол https:// можно не указывать — Revroute приведёт адрес к корректному виду сам.

Это тот адрес, который открывает конкретный экран или материал в приложении. Например, https://yourapp.com/product/Apple-MacBook открывает карточку товара Apple-MacBook.

Задайте слаг короткой ссылки

В поле Short Link можно:

1. Ввести собственный слаг
2. Сгенерировать случайный слаг
3. Сгенерировать слаг с помощью ИИ

Например, слаг apple-macbook будет открывать карточку товара Apple-MacBook.

Настройте таргетинг по устройствам

Таргетинг по устройствам отправляет пользователя в App Store или Google Play, если приложение не установлено.

Разные целевые адреса для разных платформ задаются прямо в конструкторе ссылок: поле iOS Targeting — для устройств на iOS, Android Targeting — для Android.

Осталось нажать Create link. Полученная ссылка заменяет Firebase Dynamic Link.

Шаг 3: Обработка переходов по диплинкам в приложении

Когда пользователь открывает приложение по диплинку, нужно предусмотреть два сценария.

Сценарий 1: приложение уже установлено

Диплинк открывает приложение напрямую — обработайте переход в коде приложения, как показано ниже.

// App.js
import { useEffect } from "react";
import { Linking } from "react-native";
 
useEffect(() => {
  const handleDeepLink = (url) => {
    try {
      // Call the tracking endpoint with the full deep link URL
      trackDeepLinkClick(url);
    } catch (error) {
      console.error("Error handling deep link URL:", error);
    }
  };
 
  // Handle deep link when app is already running
  const subscription = Linking.addEventListener("url", (event) => {
    handleDeepLink(event.url);
  });
 
  // Handle deep link when app is opened from a deep link
  Linking.getInitialURL().then((url) => {
    if (url) {
      handleDeepLink(url);
    }
  });
 
  return () => {
    subscription?.remove();
  };
}, []);

{
  "deepLink": "https://yourdomain.link/short-link-slug"
}

{
  "clickId": "ASltDhoxBiBqKH00",
  "link": {
    "id": "link_1K9XQTLF7OSH3Z48DKQ5WSRVY",
    "domain": "yourdomain.link",
    "key": "short-link-slug",
    "url": "https://yourapp.com/product/Apple-MacBook"
  }
}

// DeepLinkTracker.js
async function trackDeepLinkClick(deepLink) {
  try {
    const response = await fetch(`https://api.revroute.ru/track/open`, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        deepLink,
      }),
    });
 
    if (response.ok) {
      const data = await response.json();
      const destinationUrl = data.link.url;
 
      // Navigate to the destination URL in your app
      navigateToDestination(destinationUrl);
    }
  } catch (error) {
    console.error("Error tracking deep link:", error);
  }
}

Сценарий 2: приложение не установлено

Если приложения нет, пользователь попадёт в App Store или Google Play — за это отвечает таргетинг по устройствам, настроенный на шаге 2.

После установки и первого запуска в дело вступает отложенный диплинкинг. Приложению нужно:

1. Восстановить короткую ссылку, которая привела пользователя в магазин приложений
2. Отправить событие открытия через эндпоинт /track/open
3. Открыть финальный целевой адрес

Тестирование диплинков

Перед выкаткой в продакшен проверьте диплинки на эмуляторах.

adb shell am start -W -a android.intent.action.VIEW -d "https://yourdomain.link/your-short-link" com.yourpackage.name

xcrun simctl openurl booted "https://yourdomain.link/your-short-link"

Диагностика проблем с диплинками

Если диплинки работают не так, как ожидалось, начните с типовых причин.