Linki aplikacji

Linki aplikacji na Androida to specjalna funkcja precyzyjnych linków w Androidzie 6 i nowszych, która umożliwia natychmiastowe otwieranie odpowiednich treści w aplikacji na Androida po kliknięciu zweryfikowanych adresów URL witryny, bez konieczności wybierania aplikacji przez użytkownika w oknie wyboru aplikacji. Aby to umożliwić, Android używa instrukcji Digital Asset Links hostowanych w Twojej witrynie, aby ustanowić bezpieczne i zweryfikowane powiązanie między witryną a aplikacją. Po zweryfikowaniu powiązania Android może automatycznie przekierowywać precyzyjne linki do witryny bezpośrednio do aplikacji.

Od Androida 15 linki aplikacji są jeszcze bardziej zaawansowane dzięki wprowadzeniu dynamicznych linków aplikacji. Dzięki nowym funkcjom dynamicznym możesz na bieżąco ulepszać działanie precyzyjnych linków w aplikacji, zachowując większą kontrolę i nie musząc publikować nowej wersji aplikacji.

Dlaczego warto używać linków do aplikacji:

  • Łatwa obsługa – kieruj użytkowników bezpośrednio do konkretnych treści w aplikacji z wyników wyszukiwania, witryn, wiadomości i innych aplikacji. Linki aplikacji używają jednego adresu URL do tych samych treści w witrynie i w aplikacji, więc użytkownicy, którzy nie mają zainstalowanej aplikacji, są kierowani do witryny – bez błędów 404 i innych.
  • Zwiększone bezpieczeństwo – linki aplikacji wymagają potwierdzenia własności domeny, co zapobiega przechwytywaniu linków przez inne aplikacje.
  • Konfiguracja dynamiczna (Android 15 lub nowszy) – aktualizuj działanie precyzyjnych linków w aplikacji na bieżąco, co zapewni większą elastyczność i szybsze aktualizacje w przypadku takich elementów jak niestandardowe adresy URL, kampanie sezonowe czy linki dla konkretnych użytkowników.
  • Zaangażowanie – możesz angażować użytkowników za pomocą linków w wynikach wyszukiwania, reklamach, na stronach internetowych, w wiadomościach i nie tylko.

Jak obsługiwać linki aplikacji

  1. Utwórz precyzyjne linki do konkretnych treści w aplikacji: w pliku manifestu aplikacji utwórz filtry intencji dla identyfikatorów URI witryny i skonfiguruj aplikację tak, aby używała danych z intencji do kierowania użytkowników do odpowiednich treści w aplikacji.
  2. Dodaj weryfikację precyzyjnych linków: skonfiguruj aplikację tak, aby prosiła o weryfikację linków do aplikacji. Następnie opublikuj w witrynach plik JSON protokołu Digital Asset Links, aby potwierdzić prawo własności.

Możesz też użyć Asystenta linków do aplikacji na Androida w Android Studio, który przeprowadzi Cię przez wszystkie kroki wymagane do utworzenia i zweryfikowania linków do aplikacji na Androida. Więcej informacji znajdziesz w artykule o narzędziach dla programistów do obsługi linków aplikacji.

  • Dynamiczne linki do aplikacji – Android 15 (poziom interfejsu API 35) lub nowszy na urządzeniach z zainstalowanymi usługami Google.
  • Linki aplikacji – Android 6 (poziom interfejsu API 23) i nowsze wersje na urządzeniach z zainstalowanymi usługami Google.
  • Normalne precyzyjne linkowanie (zarządzane przez użytkownika) – wszystkie wersje Androida na wszystkich urządzeniach.

Jak działają linki do aplikacji

Linki do aplikacji to specjalny rodzaj precyzyjnych linków, który zapewnia pełną kontrolę nad obsługą linków do Twojej witryny. Opierają się na tym samym systemie opartym na intencjach, który jest używany przez inne typy precyzyjnych linków, ale dodają krok weryfikacji linków za pomocą pliku Digital Asset Links w witrynie.

Linki aplikacji tworzą bezpieczne, zaufane powiązanie między aplikacją a witryną, korzystając z danych aplikacji i specjalnego pliku assetlinks.json, który hostujesz w witrynie lub domenie. Plik assetlinks.json deklaruje instrukcje Digital Asset Link, aby zweryfikować powiązanie aplikacji.

Oto schemat koncepcyjny:

  1. Plik manifestu aplikacji deklaruje adresy URL w filtrze intencji z android:autoVerify="true" i wskazuje hosta witryny.
  2. Po zainstalowaniu aplikacji system Android pobiera plik assetlinks.json ze znanej lokalizacji na serwerze WWW.
  3. System sprawdza, czy plik assetlinks.json jest prawidłowy i czy sha256_cert_fingerprints pasuje do certyfikatu podpisywania aplikacji.
  4. Gdy użytkownik kliknie pasujący link, system przekieruje go bezpośrednio do Twojej aplikacji, bez wyświetlania okna uściślania.

Linki aplikacji używają adresów URL HTTP i powiązania z witryną, więc użytkownicy, którzy nie mają zainstalowanej aplikacji, przechodzą bezpośrednio do treści w witrynie. W ten sposób linki aplikacji zapewniają użytkownikom, którzy klikają precyzyjne linki do Twoich usług internetowych, bezpieczne i płynne działanie.

W Androidzie 15 linki aplikacji są jeszcze bardziej zaawansowane dzięki wprowadzeniu dynamicznych linków aplikacji. Dzięki dynamicznym linkom aplikacji możesz aktualizować reguły precyzyjnych linków po stronie serwera w pliku assetlinks.json bez konieczności publikowania nowej wersji aplikacji. Dynamiczne linki aplikacji obsługują pola Digital Asset Links, co pozwala na doprecyzowanie reguł precyzyjnych linków. Urządzenia z Androidem, na których zainstalowane są usługi Google, będą okresowo odświeżać plik i dynamicznie stosować nowe reguły precyzyjnych linków. Nie musisz aktualizować aplikacji.

Wcześniej ten plik był używany głównie do podstawowej weryfikacji. Teraz jest to zaawansowane narzędzie do konfiguracji, które umożliwia określanie ścieżek, parametrów zapytania, fragmentów i wykluczeń, co zapewnia dynamiczne i niezawodne rozwiązanie do precyzyjnych linków:

  • Obsługa wykluczeń: możesz określić pewne ścieżki lub sekcje adresu URL, które nie powinny otwierać Twojej aplikacji, nawet jeśli pasują do konfiguracji linku do aplikacji.
  • Obsługa parametrów zapytania: dzięki nowej funkcji parametrów zapytania możesz zdefiniować konkretne parametry, które, jeśli występują w adresie URL, uniemożliwią otwarcie aplikacji. Otwiera to ekscytujące możliwości dynamicznych wykluczeń, testów A/B i stopniowego włączania linków do aplikacji dla określonych segmentów użytkowników.
  • Aktualizacje dynamiczne: wprowadzaj zmiany w konfiguracji linków aplikacji bez konieczności aktualizowania aplikacji, określając ścieżki adresów URL, które aplikacja obsługuje bezpośrednio w pliku assetlinks.json hostowanym na serwerze.

Dynamiczne linki do aplikacji zapewniają też szczegółową kontrolę nad adresami URL, które mają otwierać aplikację, w tym dopasowywanie ścieżek adresów URL, fragmentów i parametrów zapytania. Możesz też wykluczyć dowolne dopasowania, aby nie mogły otwierać Twojej aplikacji. Więcej informacji znajdziesz w artykule Konfigurowanie reguł dynamicznych.

Oto schemat działania dynamicznych linków aplikacji:

  1. Plik manifestu aplikacji deklaruje adresy URL w filtrze intencji z android:autoVerify="true" i wskazuje hosta witryny.
  2. Po zainstalowaniu aplikacji system Android pobiera plik assetlinks.json ze znanej lokalizacji na serwerze WWW.
  3. System sprawdza, czy plik jest prawidłowy i czy sha256_cert_fingerprints pasuje do certyfikatu podpisywania aplikacji.
  4. System analizuje wszystkie reguły precyzyjnych linków zdefiniowane w polu dynamic_app_link_components w deklaracji Digital Asset Links i łączy je z regułami zadeklarowanymi w pliku manifestu.
    1. Gdy użytkownik kliknie pasujący link, system przekieruje go bezpośrednio do aplikacji, bez wyświetlania okna uściślania.
  5. System okresowo pobiera plik assetlinks.json, aby uzyskać najnowsze reguły, co pozwala aktualizować linki bez aktualizowania aplikacji. Okresowe ponowne pobieranie jest obsługiwane na urządzeniach z Androidem 15 (poziom interfejsu API 35) lub nowszym, na których zainstalowane są usługi Google.

Przykładowe przypadki użycia

  • Sezonowe kampanie marketingowe: aplikacja sprzedawcy może dodać do pliku assetlinks.json regułę „/promo/summer-sale”, aby kierować użytkowników na konkretny ekran wyprzedaży. Po zakończeniu wyprzedaży regułę można usunąć bez konieczności aktualizowania aplikacji przez użytkowników.
  • Skrócone adresy URL dla partnerów: jeśli współpracujesz z influencerem, możesz utworzyć niestandardowy adres URL, np. „/partner/nazwa-influencera”, i dodać do niego regułę. Możesz wtedy dynamicznie śledzić, aktualizować lub usuwać ten adres URL w miarę zmian w partnerstwie.
  • Testy A/B ścieżek adresu URL: deweloper może opublikować nową funkcję pod konkretną ścieżką adresu URL i dodać do niej regułę w pliku assetlinks.json. Dzięki temu mogą przetestować funkcję na podzbiorze użytkowników, a następnie zmodyfikować routing bez konieczności wdrażania całej aplikacji.
  • Krótkotrwałe wydarzenia: aplikacja do sprzedaży biletów lub wydarzeń może dodawać reguły adresów URL dla konkretnych wydarzeń. Po zakończeniu wydarzenia możesz usunąć te reguły z serwera.

Zgodność z implementacjami linków do aplikacji

Rozszerzenia dynamicznych linków aplikacji w Androidzie 15 zostały zaprojektowane tak, aby były w pełni zgodne z dotychczasowymi implementacjami linków aplikacji na urządzeniach z wcześniejszymi wersjami Androida. Niższe wersje aplikacji nie mogą korzystać z funkcji konfiguracji dynamicznej ani funkcji konfiguracji. Będą one korzystać z reguł zadeklarowanych w pliku manifestu. Link do aplikacji może nadal prawidłowo otwierać aplikację lub przekierowywać do internetu w przypadku użytkowników korzystających z poprzednich wersji Androida. W większości przypadków możesz bezpiecznie wdrożyć reguły dynamiczne bez wpływu na wygodę pozostałych użytkowników. Więcej informacji o konfigurowaniu filtrów intencji pod kątem zgodności wstecznej znajdziesz w artykule Zgodność wsteczna dynamicznych linków do aplikacji na Androidzie 14 i starszych wersjach.

Kwestie, które należy wziąć pod uwagę podczas konfigurowania reguł filtrowania dynamicznych linków aplikacji

Jeśli konfigurujesz filtry intencji do użycia z dynamicznymi linkami aplikacji na Androidzie 15 lub nowszym, pamiętaj, że reguły kierowania na poziomie ścieżki zdefiniowane w pliku assetlinks.json po stronie serwera nie mogą rozszerzać zakresu ustawionego statycznie w regułach filtrów intencji w pliku manifestu.

Dlatego zalecamy skonfigurowanie jak najszerszego zakresu w filtrach intencji w pliku manifestu, a następnie użycie reguł assetlinks.json po stronie serwera w celu dalszego doprecyzowania. Dzięki tej idealnej konfiguracji będziesz mieć możliwość dynamicznego dodawania nowych linków aplikacji, które mieszczą się w szerokim zakresie określonym w pliku manifestu.

Poprawka dotycząca niezawodności reguł dynamicznych

We wrześniu 2026 r. rozwiązaliśmy problem w usługach Google Play, który czasami uniemożliwiał niektórym urządzeniom z Androidem 15 (poziom API 35) i nowszym stosowanie reguł dynamicznych w pliku assetlinks.json. Gdy wystąpił problem, urządzenia, których on dotyczył, używały tylko filtrów intencji zadeklarowanych w manifeście aplikacji, więc adresy URL wykluczone przez reguły dynamiczne mogły otwierać aplikację. Nie musisz zmieniać aplikacji ani pliku assetlinks.json. Po wprowadzeniu poprawki większość urządzeń powinna stosować reguły dynamiczne zgodnie z Twoimi ustawieniami.

Planowanie implementacji linków aplikacji

Obsługa linków aplikacji wymaga implementacji w aplikacji, a także pracy po stronie serwera w celu skonfigurowania pliku assetlinks.json. Poniżej znajdziesz ogólne zadania związane z przygotowaniem i wdrożeniem oraz linki do innych materiałów, które zawierają szczegółowe informacje.

  • Planowanie precyzyjnych linków – zacznij od oceny, jakich precyzyjnych linków potrzebujesz, jakich wzorców adresów URL będą używać, jak i kiedy będziesz je aktualizować oraz do jakiej aktywności lub działania ma prowadzić każdy adres URL w aplikacji.
  • Obsługa dynamicznych linków aplikacji – zapewnij użytkownikom najnowszych urządzeń z Androidem jak najlepsze wrażenia. Korzystaj z dynamicznych linków aplikacji w przypadku użytkowników Androida 15 lub nowszego.
  • Zaplanuj reguły filtrów dynamicznych – jeśli używasz dynamicznych linków do aplikacji, zaplanuj, jak reguły po stronie serwera będą działać z regułami zdefiniowanymi statycznie w manifeście aplikacji. Pamiętaj, że reguły filtrowania w pliku assetlinks.json nie mogą rozszerzać zakresu filtrów manifestu aplikacji. Zaplanuj filtry pliku manifestu tak, aby deklarowały jak najszerszy zakres, a następnie w razie potrzeby doprecyzuj te reguły po stronie serwera. Więcej informacji znajdziesz w artykule Konfigurowanie reguł dynamicznych.
  • Tworzenie i testowanie filtrów intencji dla linków – zadeklaruj precyzyjne linki w filtrach intencji i przetestuj dopasowywanie wzorców adresów URL oraz obsługę przychodzących intencji. Aby obsługiwać dynamiczne linki aplikacji, być może musisz przenieść niektóre szczegółowe ścieżki do pliku JSON po stronie serwera.
  • Odczytywanie danych z przychodzących intencji linków aplikacji – prawidłowo obsługuj przychodzące intencje precyzyjnych linków i rozwiązuj je do odpowiedniej aktywności. Implementacja linków do aplikacji jest taka sama jak w przypadku zwykłych precyzyjnych linków, co opisano w artykule Odczytywanie danych z przychodzących intencji.
  • Skonfiguruj powiązania witryn i reguły dynamiczne – aby obsługiwać linki aplikacji, musisz skonfigurować plik po stronie serwera, który jest hostowany w Twojej witrynie lub domenie. Urządzenia z Androidem będą pobierać ten plik, aby zweryfikować implementację linków do aplikacji w Twojej aplikacji. Więcej informacji znajdziesz tutaj.
  • Testowanie weryfikacji linków do aplikacji – sprawdź, czy system Android może automatycznie zweryfikować Twoje precyzyjne linki. Użyj debugowania i kompleksowego testowania, aby sprawdzić, czy konfiguracja jest bezpieczna i działa prawidłowo we wszystkich zweryfikowanych ścieżkach linków do aplikacji.
  • Poznaj narzędzia, których możesz używać do konfigurowania linków do aplikacji, w tym Android Studio i Konsolę Play. Więcej informacji znajdziesz tutaj.