Możesz wygenerować adres URL prowadzący bezpośrednio do konkretnego działania. Użytkownicy, którzy klikną link Asystenta (wcześniej nazywany linkiem do działania) w przeglądarce internetowej lub mobilnej, zostaną przekierowani do Asystenta na urządzeniu, gdzie będą wejść bezpośrednio w interakcję z odpowiednią akcją.
Oto kilka przykładów przydatnych linków do Asystenta:
- Udostępnianie użytkownikom instrukcji głosowych w witrynie z instrukcjami.
- Łączenie użytkowników z obsługą klienta na stronie „uzyskaj pomoc”.
- połączenie użytkowników z zamiarem aktualizacji, tak aby mogli wyrazić zgodę na przyszłe aktualizacje.
Aby wygenerować adres URL działania, wykonaj te czynności:
- W Konsoli Actions kliknij Programowanie > Działania.
- Kliknij działanie, dla którego chcesz wygenerować link.
- W sekcji Linki zaznacz opcję Czy chcesz włączyć adres URL dla tej czynności.
- Wpisz Tytuł linku. Tytuł powinien zawierać czasownik opisujący jej działanie. Jeśli np. akcja zatrzymuje użytkownika w procesie transakcji w celu zakupu biletów na koncert, przydatnym tytułem linku będzie „kup bilety na koncert”.
- Kliknij Zapisz.
Możesz skopiować podany adres URL i odwołać się do niego, gdziekolwiek chcesz skierować użytkowników do tego konkretnego działania.
Parametry linku Asystenta
Linki Asystenta mogą zawierać w adresie URL intencję i parametry. Google obsługuje parametry zgodnie z typem intencji określonym w adresie URL.
Specyfikacja adresu URL linku Asystenta
Ogólna składnia adresu URL linku Asystenta jest taka:
https://assistant.google.com/services/invoke[/$action_id][?intent=$intent¶m.$param=$value][&$utm_param=$utm_value]
Parametry adresu URL, które możesz ustawić, zostały opisane w tej tabeli:
Parametr URL | Opis |
---|---|
$action_id |
Identyfikator numeryczny akcji. |
$intent |
Pełna nazwa intencji wbudowanej lub niestandardowej. |
$param |
Pełna nazwa parametru intencji określonego w pakiecie akcji. |
$value |
Zakodowana w adresie URL wartość typu zadeklarowanego dla atrybutu $param w pakiecie akcji. |
$utm_param |
Lista co najmniej jednego typu parametru UTM. Prawidłowe wartości to utm_source , utm_medium , utm_campaign , utm_term i utm_content . |
$utm_value |
Wartość ciągu znaków parametru UTM. |
Adresy URL linków Asystenta z intencjami wbudowanymi
Jeśli link Asystenta zawiera intencję wbudowaną (zaczyna się ona od actions.intent.*
), Google spróbuje wyodrębnić z adresu URL wszelkie wbudowane parametry intencji i przekazać je do akcji. Wszystkie parametry, których Google nie rozpoznaje, ponieważ parametry wbudowanych intencji są usuwane.
W przypadku akcji konwersacyjnych Google wysyła te parametry do realizacji w ramach wiadomości AppRequest
.
Z przykładu poniżej dowiesz się, jak określić adres URL linku Asystenta, który zawiera intencję wbudowaną z pojedynczym parametrem intencji:
https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.GET_HOROSCOPE¶m.astrologySign=%22cancer%22
Adresy URL linków Asystenta z niestandardowymi intencjami
W przypadku intencji niestandardowych Google wyodrębnia tylko parametry zdefiniowane przez akcję w ramach intencji i odrzuca pozostałe.
Ten przykład pokazuje, jak określić adres URL linku Asystenta zawierającego niestandardową intencję:
https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK¶m.topic=sports
W przypadku powyższego przykładowego adresu URL w obiekcie AppRequest
Google dodaje obiekt JSON w następujący sposób:
argument {
name: ‘topic’,
raw_text: ‘sports’,
text_value: ‘sports’,
}
Adresy URL linków Asystenta bez intencji
Jeśli nie określisz intencji w linku do Asystenta Google, Google będzie domyślnie łączyć ją z intencją MAIN
(actions.intent.MAIN
) akcji w taki sposób:
- Jeśli nie włączysz intencji
MAIN
w linku do Asystenta Google, Google wywoła intencję główną bez żadnych parametrów, podobnie jak w przypadku polecenia „Porozmawiaj z aplikacją app_name”. - Jeśli wyraźnie włączysz intencję
MAIN
, Google przekaże parametry do akcji.
Ten przykład pokazuje, jak można bez intencji określić adres URL linku Asystenta:
https://assistant.google.com/services/invoke/uid/000000d139bbc4d4
Adresy URL linków Asystenta z parametrami UTM
Parametry monitora UTM to ciągi znaków, które Google wysyła do Twojej akcji, gdy użytkownik kliknie link do Asystenta. Te dane możesz później wykorzystać do celów analitycznych.
Parametry monitora UTM wysyłane przez Google do akcji obejmują:
utm_source
utm_medium
utm_campaign
utm_term
utm_content
Z tego przykładu dowiesz się, jak określić adres URL linku Asystenta z parametrami monitora UTM:
https://assistant.google.com/services/invoke/uid/000000d139bbc4d4?utm_source=Google&utm_medium=email&utm_campaign=holiday+sale
W przypadku powyższego przykładowego adresu URL w komunikacie AppRequest
Google dodaje te argumenty:
argument {
name: ‘utm_source’,
raw_text: ‘Google’,
text_value: ‘Google’,
}
argument {
name: ‘utm_medium’,
raw_text: ‘email’,
text_value: ‘email’,
}
argument {
name: ‘utm_campaign’,
raw_text: ‘holiday sale’,
text_value: ‘holiday sale’,
}
Testuj linki Asystenta
Za pomocą symulatora lub urządzenia możesz testować linki Asystenta w przypadku dowolnej intencji (głównej lub niestandardowej, z parametrami lub bez).
Aby przetestować link Asystenta:
- Włącz link do Asystenta w konsoli.
- Zaloguj się w Asystencie za pomocą tego samego konta, które posłużyło Ci do utworzenia projektu w Actions on Google.
- Utwórz wersję linku Asystenta, którą można kliknąć (w e-mailu, na czacie, w dokumencie itp.).
- Na urządzeniu z Asystentem kliknij link utworzony w poprzednim kroku.
Po potwierdzeniu, że funkcja połączenia z Asystentem działa zgodnie z oczekiwaniami, musisz ponownie wdrożyć akcję, aby udostępnić link użytkownikom.
Ograniczenia i sprawdzone metody
Adres URL linku Asystenta można teraz rozpowszechniać i odwoływać się do niego poza katalogiem lub innymi usługami Google. Pamiętaj więc, że obowiązują te ograniczenia i sprawdzone metody:
- Pamiętaj, aby nadal korzystać ze wszystkich linków do Asystenta. Jeśli rozpowszechnisz link do Asystenta, który później ulegnie awarii, Twój projekt Actions może zostać oznaczony jako niesprawny i usunięty.
Opublikowanie linku oznacza, że obsługujesz aktywatory z niezaufanych źródeł. W przypadku połączonych akcji musisz wyraźnie skonsultować się z użytkownikiem przed podjęciem jakichkolwiek „rzeczywistych działań”. Na przykład akcja, która powoduje wyłączenie inteligentnego urządzenia domowego, powinna zapytać użytkownika „Czy na pewno chcesz wyłączyć
$applianceName
?”.W tym kontekście „rzeczywiste działanie” to dowolne działanie mające wpływ na usługi, dane, urządzenia, sieci, komputery lub interfejsy API użytkownika. Dotyczy to na przykład wysyłania e-maili, przeprowadzania transakcji, zmieniania stanu inteligentnego urządzenia domowego, tworzenia subskrypcji lub aktualizowania materiałów.