Jak uzyskać precyzyjne linki do aplikacji od agenta RBM

W aplikacjach mobilnych precyzyjne linki pozwalają użytkownikom przejść bezpośrednio do treści w aplikacji. Bez precyzyjnego linku, jeśli udostępnisz komuś koszulkę znalezioną w aplikacji ze sklepem, odebrany przez niego link przekieruje go do przeglądarki lub do Sklepu Play, gdzie użytkownicy muszą zainstalować lub otworzyć aplikację, a potem wyszukać treść. Żadna z tych sytuacji nie jest korzystna dla użytkowników. Dzięki precyzyjnym linkom Twój link prowadzi znajomego do konkretnej koszulki, którą znajdziesz w aplikacji sklepu.

Z tego artykułu dowiesz się, jak używać precyzyjnych linków, aby tworzyć bogate i atrakcyjne treści dla użytkowników RBM.

Dodawanie użytkownika RBM do aplikacji

Precyzyjny link to tylko link do aplikacji. Agent RBM może otworzyć aplikację zainstalowaną na telefonie użytkownika za pomocą polecenia OpenUrlAction, w którym adres URL to precyzyjny link skonfigurowany dla aplikacji, którą chcesz wywołać. Więcej informacji znajdziesz w artykule Tworzenie precyzyjnych linków do treści aplikacji.

Przeanalizujmy konkretny przykład. Aby otworzyć podcast Google Cloud w aplikacji Podcasty Google, możesz utworzyć identyfikator OpenUrlAction za pomocą identyfikatora URI:

https://www.google.com/podcasts?feed=aHR0cDovL2ZlZWRzLmZlZWRidXJuZXIuY29tL0dvb2dsZUNsb3VkUGxhdGZvcm1Qb2RjYXN0

Wiele usług Google jest skonfigurowanych do obsługi precyzyjnych linków, które działają również jako internetowe adresy URL, w tym YouTube i Mapy Google.

Aby uruchomić agenta z dowolnej z tych aplikacji, musisz podać tę wartość jako adres URL w alercie OpenUrlAction. W przykładowym kodzie JSON poniżej karta informacyjna RBM zawiera 3 otwarte działania URL, z których każde zawiera precyzyjne linki do innej aplikacji.

{
    "contentMessage":{
        "richCard":{
            "standaloneCard":{
                "cardOrientation":"VERTICAL",
                "cardContent":{
                    "title":"Did you know that you can open apps from an RBM agent?",
                    "description":"",
                    "suggestions":[
                        {
                            "action":{
                                "text":"Google Cloud Podcast",
                                "postbackData":"podcast_tap",
                                "openUrlAction":{
                                    "url":"https://www.google.com/podcasts?feed=aHR0cDovL2ZlZWRzLmZlZWRidXJuZXIuY29tL1JvYkNlc3Rlcm5pbm8&nord=0"
                                }
                            }
                        },
                        {
                            "action":{
                                "text":"YouTube Video",
                                "postbackData":"youtube_tap",
                                "openUrlAction":{
                                    "url":"https://www.youtube.com/embed/xSE9Qk9wkig"
                                }
                            }
                        },
                        {
                            "action":{
                                "text":"Google Maps",
                                "postbackData":"maps_tap",
                                "openUrlAction":{
                                    "url":"https://goo.gl/maps/ToMSdr4PYX62"
                                }
                            }
                        }
                    ]
                }
            }
        }
    }
}

Gdy ten ładunek JSON jest renderowany w kliencie RCS użytkownika, ikona sugerowanego działania jest zgodna z aplikacją powiązaną z precyzyjnym linkiem. Kliknięcie któregoś z sugerowanych działań powoduje uruchomienie wybranej aplikacji bezpośrednio w treści zakodowanej w adresie URL.

Sugerowane adresy URL z ikonami aplikacji

Dlaczego warto?

Istnieje kilka powodów, dla których warto stosować precyzyjne linki do aplikacji.

Uwierzytelnianie

Jeśli agent obsługuje informacje potencjalnie poufne, możesz to zrobić za pomocą precyzyjnego linku do aplikacji w celu uwierzytelnienia użytkownika za pomocą odcisku palca, logowania się lub innych metod. Gdy użytkownik się uwierzytelni, możesz śledzić po stronie serwera uwierzytelniania i powrócić do agenta przez uruchomienie nowej wiadomości RBM. Jeśli wysyłasz wszelkie potencjalnie poufne wiadomości, możesz sprawdzić po stronie serwera, aby upewnić się, że użytkownik jest uwierzytelniony. Jeśli nie, możesz odesłać go z powrotem do aplikacji, aby odnowić token uwierzytelniania.

Obsługa złożonych przypadków użycia

Agenty RBM świetnie nadają się do rozmów, ale aplikacje mogą lepiej obsługiwać określone zastosowania. Jeśli na przykład masz firmę meblarską i działasz w środowisku rzeczywistości rozszerzonej, dzięki czemu użytkownicy mogą w swoim domu wypróbować meble (patrz ilustracja poniżej), Twój przypadek użycia może być obsługiwany tylko przez aplikację.

W takich sytuacjach warto skierować użytkowników RBM do aplikacji, żeby zapewnić im dostęp do niektórych funkcji. Aplikacja zawsze może przywrócić użytkownika do rozmowy RBM, aktywując nową wiadomość agenta.

Precyzyjny link do aplikacji Aplikacja z precyzyjnymi linkami

Ułatwianie płatności

Możesz obsługiwać płatności za pomocą aplikacji innej firmy za pomocą precyzyjnych linków.

Załóżmy na przykład, że chcesz obsługiwać przelewy za pomocą fikcyjnej firmy AcmePay. Analizując internet, odkryłeś, że AcmePay obsługuje precyzyjne linki, korzystając z własnej unikalnej struktury identyfikatora URI, która umożliwia przekazywanie wartości dla odbiorców, kwoty i notatki za pomocą parametrów ciągu zapytania.

Dzięki tej wiedzy Twój agent musi po prostu utworzyć obiekt OpenUrlAction z parametrem URI AcmePay określonym dla adresu URL sugerowanego działania.

acmepay://paycharge?recipients=Jane+Smith&amount=10&note=Money+For+You!

Gdy odbiorca wiadomości RBM kliknie sugerowane działanie, aplikacja AcmePay otworzy się bezpośrednio na ekranie transakcji z wypełnionymi wartościami przekazywanymi.

Co się stanie, jeśli aplikacja nie zostanie zainstalowana?

Jeśli aplikacja nie jest zainstalowana na urządzeniu użytkownika, działanie precyzyjnych linków zależy od struktury identyfikatora URI przekazanego do OpenUrlAction. Jeśli co najmniej 1 aplikacja na urządzeniu (np. Chrome rozpoznaje adresy URL rozpoczynające się od „http://”), proponowane działanie wyświetla się w tej aplikacji jak zwykle. Gdy użytkownik wykona czynność, identyfikator URI zostanie otwarty w dowolnej aplikacji, która rozpozna strukturę identyfikatora URI.

Jeśli jesteś deweloperem aplikacji, precyzyjny link z identyfikatorami URI zaczyna się od „http://” i wskazuje domenę, której jesteś właścicielem, ponieważ Chrome może przekierowywać użytkownika na stronę internetową w ramach działania zastępczego. Na stronie możesz wyświetlić użytkownikom prośbę o pobranie aplikacji lub wyświetlić ją w sposób, który najbardziej Ci odpowiada.

Jeśli identyfikator URI ma niestandardową strukturę, która nie jest rozpoznawana przez żadną aplikację na urządzeniu, sugerowane działanie nie będzie widoczne w wiadomości RBM.

Aby zawsze były wyświetlane sugerowane działania, możesz użyć własnego adresu URL, aby strona internetowa próbowała przekierować użytkownika do niestandardowego identyfikatora URI, który uruchamia aplikację. Jeśli aplikacja istnieje na urządzeniu, uruchamia się zgodnie z oczekiwaniami. W przeciwnym razie użytkownik pozostaje na stronie, gdzie można go przekierować zgodnie ze swoimi potrzebami.

Poniżej pokazujemy, jak to zrobić. Skrypt próbuje przekierować użytkownika do aplikacji AcmePay, ale jeśli nie jest ona zainstalowana, skrypt przekierowuje użytkownika do Sklepu Google Play, skąd może ją pobrać.

<!doctype html>
<html>
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <meta name="viewport" content="width=device-width,minimum-scale=1.0, maximum-scale=1.0" />
    <title>Acme Pay</title>

    <script type="text/javascript">
    window.onload = function() {
       // Launch Acme Pay app for existing users
       window.location = 'acmepay://paycharge?recipients=Jane+Smith&amount=10&note=Money+For+You!';

       // Redirect to Acme Pay app download for new users
       setTimeout("window.location = 'https://play.google.com/store/apps/details?id=com.acmepay.android';", 1000);
    }
    </script>
</head>
<body>
    <h1>Redirecting…</h1>
</body>
</html>

Podsumowanie i kierownik zespołu

Za pomocą sugerowanego działania OpenUrlAction możesz tworzyć precyzyjne linki do aplikacji, które należą do Ciebie, lub te, które chcesz uruchomić, aby angażować użytkowników. Korzystając z precyzyjnych linków, użytkownicy mogą w bardziej atrakcyjny i atrakcyjny sposób udostępniać treści o charakterze kontrowersyjnym.

Powodzenia i kodowania!