Ta strona została przetłumaczona przez Cloud Translation API.

Linki Asystenta

Możesz wygenerować adres URL, który będzie prowadził bezpośrednio do konkretnej intencji działania. Użytkownicy, którzy klikną link Asystenta (nazywany wcześniej linkami akcji) w przeglądarce internetowej lub mobilnej, zostaną przekierowani do Asystenta na urządzeniu, gdzie wchodzą w bezpośrednią interakcję z Twoją akcją.

Linki Asystenta różnią się od linków internetowych katalogu, które odsyłają użytkownika do strony działania w katalogu Asystenta.

Linki Asystenta mogą być przydatne w tych sytuacjach:

Dodawanie linków do instrukcji głosowych na stronie internetowej instrukcji.
Zapewnij użytkownikom możliwość kontaktu z obsługą klienta na stronie pomocy.
Połączenie użytkowników z intencją aktualizacji, aby mogli wyrazić zgodę na Twoje przyszłe aktualizacje.

Generowanie linku do Asystenta

Linki Asystenta możesz generować w projekcie w konsoli Actions. Linki Asystenta są dostępne we wszystkich kanałach wdrażania (alfa, beta i produkcyjnych). Jeśli na przykład link do Asystenta jest włączony w wersji alfa akcji, będzie on dostępny dla testerów wersji alfa.

Aby wygenerować adres URL dla działania:

W konsoli Actions kliknij Wdróż > Linki Asystenta.
W sekcji Intent (Intencja) wybierz intencję, dla której chcesz wygenerować link.
Włącz opcję Czy chcesz włączyć łączenie w przypadku intencjiIntent_name?.
(Opcjonalnie) W sekcji Parametry kampanii wpisz w linku dowolne informacje, które chcesz dodatkowo zarejestrować jako parametry adresu URL.
(Opcjonalnie) Wpisz Tytuł linku. Użyj tego tytułu, aby opisać działanie akcji. Jeśli na przykład akcja prowadzi użytkownika do procesu transakcji, na której kupuje bilety na koncert, tytuł linku może brzmieć „Kup bilety na koncert”.

Po wpisaniu informacji możesz wyświetlić i skopiować wygenerowany adres URL lub fragment kodu z linkiem Asystenta. Używaj linku Asystenta, gdziekolwiek chcesz kierować użytkowników do danego działania.

Połączenia z Asystentem

Linki Asystenta możesz testować w dowolnej intencji (głównej, niestandardowej, z parametrami lub bez) za pomocą symulatora lub na urządzeniu.

Aby przetestować połączenie z Asystentem na urządzeniu:

Wygeneruj link do Asystenta w Konsoli Actions.
Wyślij link do Asystenta jako adres URL w e-mailu, wiadomości na czacie lub w innym formacie.
Na urządzeniu z Asystentem zaloguj się w Asystencie na to samo konto, które zostało użyte do utworzenia projektu w Actions.
Na tym samym urządzeniu kliknij link, który wysyłasz do Asystenta.

Gdy potwierdzisz, że połączenie z Asystentem działa zgodnie z oczekiwaniami, musisz ponownie wdrożyć działanie, aby udostępnić link użytkownikom.

Parametry linku Asystenta

Linki Asystenta mogą opcjonalnie zawierać intencję i parametry w adresie URL. W sekcji Parametry kampanii możesz dodawać parametry kampanii.

Gdy link do Asystenta nie zawiera żadnych dodatkowych parametrów, Asystent Google łączy się z intencją MAIN (actions.intent.MAIN) akcji w taki sposób:

Jeśli intencja MAIN nie została włączona w linku Asystenta, Asystent dopasuje intencję główną bez żadnych parametrów, podobnie jak w przypadku polecenia „Talk to app_name”.
Jeśli intencję MAIN zostało jednoznacznie włączona, Asystent przekazuje parametry do akcji.

Oto przykład adresu URL linku Asystenta z intencją MAIN bez dodatkowych parametrów:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4

Specyfikacja adresu URL linku Asystenta

Ogólna składnia adresu URL linku Asystenta wygląda tak:

https://assistant.google.com/services/invoke[/$action_id][?intent=$intent&param.$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 czynności.
`$intent`	Pełna nazwa intencji lub intencji użytkownika.
`$param`	Pełna nazwa parametru intencji określonego w pakiecie Action.
`$value`	Zakodowana adres URL wartość typu `$param` zadeklarowana dla pakietu działań.
`$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 przypisana do parametru UTM.

Adresy URL linków Asystenta z wbudowanymi intencjami

Jeśli link do Asystenta zawiera intencję wbudowaną (intencja zaczyna się od actions.intent.), Asystent Google próbuje wyodrębnić wbudowane parametry intencji w adresie URL i przekazać je do akcji. Wszelkie parametry, których Asystent nie rozpoznaje, ponieważ wbudowane parametry intencji są usuwane.

W przypadku czynności konwersacyjnych Asystent wysyła te parametry do realizacji w ramach wiadomości AppRequest.

Poniższy przykład pokazuje, jak określić adres URL linku Asystenta, który zawiera wbudowaną intencję z jednym parametrem intencji:

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.PLAY_GAME&param.name=%22ExampleGame%22

Adresy URL połączeń z Asystentem dotyczące intencji użytkownika

W przypadku intencji użytkownika Asystent Google wyodrębnia tylko te parametry, które są zdefiniowane w ramach Twojego działania w ramach intencji, i odrzuca pozostałe parametry.

Poniższy przykład pokazuje, jak określić adres URL linku Asystenta, który zawiera intencję użytkownika:

https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK&param.topic=sports

W przykładowym adresie URL w AppRequest Asystent dodaje obiekt JSON w ten sposób:

argument {
  name: 'topic',
  raw_text: 'sports',
  text_value: 'sports',
}

Adresy URL połączeń z Asystentem z parametrami UTM

Parametry monitora UTM to ciągi tekstowe, które Asystent Google wysyła do działania, gdy użytkownik kliknie link. Później możesz używać analiz zawartych w nich informacji do celów analitycznych.

Parametry UTM, które Asystent wysyła do działania, obejmują:

utm_source
utm_medium
utm_campaign
utm_term
utm_content

Poniższy przykład pokazuje, jak określić adres URL linku Asystenta, który zawiera parametry monitora UTM:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4?utm_source=Google&utm_medium=email&utm_campaign=holiday+sale

W przykładowym adresie URL powyżej Asystent dodaje te argumenty w wiadomości AppRequest:

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',
}

Linki do Asystenta z elementami rozszerzonymi

Linki Asystenta z elementami rozszerzonymi umożliwiają korzystanie z asystenta w witrynie, aby zwiększyć wykrywalność akcji w witrynie. Użytkownicy mogą wypróbować działanie, a także połączyć swoje konto Google z usługą, używając funkcji łączenia kont.

Gdy użytkownik odwiedza Twoją witrynę, widzi przycisk „Wypróbuj z Asystentem Google”, który uruchamia procedurę powiązania z Asystentem Google.

Włączenie łączenia kont w akcji pozwala użytkownikom na dostęp do akcji na dowolnym urządzeniu z Asystentem. Ponadto użytkownicy mogą połączyć swoje konto z Twoją usługą ze swoimi kontami Google, aby spersonalizować usługi.

W przypadku łączenia z kontem funkcja Linki do Asystenta Rich Media korzysta z adresu URL autoryzacji, który jest ustawiany w projekcie w konsoli Actions. Więcej informacji znajdziesz w dokumentacji łączenia kont.

Wymagania wstępne

Aby korzystać z linków Asystenta Google, musisz mieć:

Projekt Actions.
Link Asystenta włączony w akcji.
(Opcjonalnie) Połączenie konta z Twoją akcją.

Programowanie lokalne

Aby umieścić w witrynie bogaty link do Asystenta, wykonaj te czynności:

Umieść na stronie tę bibliotekę JavaScript, zastępując <PROJECT_ID> Twoim identyfikatorem projektu w Actions:
```
<script async
src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
</script>
```
Dodaj widoczny poniżej tag HTML do swojej strony. Spowoduje to wczytanie wbudowanego przycisku „Wypróbuj z Asystentem Google”:
```
<google-assistant-link-group>
  
  <google-assistant-link href="{ASSISTANT_LINK_1}">
  </google-assistant-link>
  <google-assistant-link href="{ASSISTANT_LINK_2}">
  </google-assistant-link>
</google-assistant-link-group>
```
Uwaga: jeśli użytkownik nie jest zalogowany, pierwszy link Asystenta aktywuje Asystenta lub przekierowuje go na stronę katalogu Asystenta związaną z działaniem.

Aktywna aktywacja

Jeśli chcesz, by podczas pierwszej wizyty użytkownika na stronie nastąpiło automatyczne wywołanie rozszerzonego linku, użyj tagu <google-assistant-proactive-link>. Gdy zastosujesz ten tag, link zostanie aktywowany bez pierwszej wizyty użytkownika bez konieczności klikania przycisku w tekście.

Dodaj id do tagu grupy połączeń Asystenta:

<google-assistant-link-group id="my-group">
  <!-- One or more <google-assistant-link> tags -->
  <google-assistant-link href="{ASSISTANT_LINK_1}">
  </google-assistant-link>
  <google-assistant-link href="{ASSISTANT_LINK_2}">
  </google-assistant-link>
</google-assistant-link-group>

Umieść tag <google-assistant-proactive-action-link> na swojej stronie i ustaw dla jego atrybutu groupId wartość id:

<google-assistant-link-group id="my-group">
  <!-- One or more <google-assistant-link> tags -->
  <google-assistant-link href="{ASSISTANT_LINK_1}">
  </google-assistant-link>
  <google-assistant-link href="{ASSISTANT_LINK_2}">
  </google-assistant-link>
</google-assistant-link-group>

<google-assistant-proactive-link
groupId="my-group">
</google-assistant-proactive-link>

Wdrożenie

Linki do Asystenta Rich Media działają tylko w Twoich domenach, które są zweryfikowane przez Google. Podczas programowania lokalnego ten wymóg jest pomijany, gdy masz dostęp do projektu w Actions, zalogujesz się na swoje konto Google i ustawisz parametr zapytania dev=true w tagu skryptu.

  <script async
    src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
  </script>

Aby wdrożyć akcję za pomocą rozszerzonych linków Asystenta:

Zarejestruj domenę publiczną w Konsoli Actions, klikając Deploy > Brand Verification > Connect Site (Wdrażanie > Weryfikacja marki > Połącz witrynę).

Usuń ze skryptu parametr zapytania dev=true:

<script async
src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}">
</script>

Ograniczenia i sprawdzone metody

Poniższe ograniczenia i sprawdzone metody są stosowane, aby adres URL linku w Asystencie mógł być rozpowszechniany poza katalogiem i innymi usługami Google:

Kontynuuj obsługę wszystkich linków Asystenta. Jeśli rozpowszechniasz link Asystenta, który później ulega awarii, Twój projekt Actions może zostać oznaczony jako nieprawidłowy i usunięty.
Publikowanie linku umożliwia korzystanie z reguł pochodzących z niezaufanych źródeł. W przypadku powiązanych działań musisz wyraźnie skonsultować z użytkownikiem przed podjęciem działania w świecie rzeczywistym. Na przykład akcja, która wyłącza inteligentny dom, powinna wyświetlić użytkownikowi komunikat „Na pewno chcesz wyłączyć $applianceName?”.

W tym kontekście rzeczywiste działanie to dowolne działanie wpływające na usługi, dane, urządzenia, sieci, komputery lub interfejsy API użytkownika. Dotyczy to na przykład wysyłania e-maili, realizacji transakcji, zmieniania stanu inteligentnego domu, tworzenia subskrypcji czy aktualizowania treści.