Testowanie akcji pozwala użytkownikom poznać jej opinie i naprawić błędy techniczne oraz problemy z wrażeniami użytkownika, zanim ją opublikujesz.
Konsola Actions obsługuje środowiska wersji, dzięki czemu możesz przyznać wybranym użytkownikom dostęp do nowego działania lub przetestowania jego nowej wersji przed opublikowaniem.
Cykl życia wersji
Ten diagram przedstawia potencjalne ścieżki, jakie może przebywać działanie:
Konsola Actions obsługuje 2 rodzaje środowisk wersji przedprodukcyjnej:
Alfa: tego kanału możesz używać do szybkiego testowania wczesnych wersji akcji.
- Pozwala udostępnić akcję niewielkiej grupie użytkowników bez przeprowadzania pełnej weryfikacji przez Google.
- Użytkownicy otrzymują ostrzeżenia, że akcja nie została sprawdzona przez Google pod kątem zgodności z zasadami.
- To idealne rozwiązanie do testów wewnętrznych.
Beta: ten kanał pozwala udostępnić akcję tylko ograniczonej grupie użytkowników po pełnym przeanalizowaniu jej przez Google.
- Użyj tego kanału, aby dać użytkownikom spoza organizacji dostęp do wczesnych wersji akcji.
- Użytkownicy zostaną poinformowani, że akcja jest wersją testową.
- Ponieważ wersja beta została sprawdzona przez Google, w każdej chwili możesz ją opublikować bez konieczności ponownego sprawdzania przez Google.
Porównanie środowiska wersji
W tabeli poniżej znajdziesz różnice między kanałami wdrożenia.
| Symulator | Alfa | Wersja beta | Produkcja | |
|---|---|---|---|---|
| Docelowi odbiorcy | Tylko deweloper | Wczesni testerzy w zespole, znajomych i rodzinie | Testerzy spoza zespołu | Wszyscy użytkownicy Asystenta Google |
| Wymaga sprawdzenia przez Google | Nie | Nie | Tak | Tak |
| Kto ma dostęp | Tylko deweloper | Lista użytkowników zdefiniowana przez dewelopera. Użytkownicy muszą wyrazić zgodę. | Lista użytkowników zdefiniowana przez dewelopera. Użytkownicy muszą wyrazić zgodę. | Dostępne publicznie dla wszystkich użytkowników Asystenta Google |
| Maksymalna liczba użytkowników | 1 | 20 | 200 | Nie dotyczy |
| Gdzie jest dostępny Asystent Wi-Fi | Symulator i wszystkie urządzenia z Asystentem | Wszystkie urządzenia z Asystentem | Wszystkie urządzenia z Asystentem | Wszystkie urządzenia z Asystentem |
| Kreator działań | Obsługiwana | Obsługiwana | Obsługiwana | Tak |
| Actions SDK | Obsługiwana | Obsługiwana | Obsługiwana | Tak |
| Dialogflow | Obsługiwana | Obsługiwana | Obsługiwana | Tak |
| Inteligentny dom | Obsługiwane (wymaga połączenia kont) | Brak obsługi | Brak obsługi | Tak |
| Szablony | Obsługiwana | Brak obsługi | Brak obsługi | Tak |
| Jednoznaczne wywołanie | Obsługiwana | Obsługiwana | Obsługiwana | Tak |
| wywołanie pośrednie | Obsługiwana | Obsługiwana | Obsługiwana | Tak |
| Łączenie kont | Obsługiwana | Obsługiwana | Obsługiwana | Tak |
Zarządzanie testami wersji alfa i beta
Aby skonfigurować testy wersji alfa lub beta, wykonaj te czynności:
- Kliknij Zarządzaj testerami wersji alfa lub Zarządzaj testerami wersji beta.
Wpisz adresy e-mail testerów, rozdzielając je przecinkami. Możesz określić maksymalnie 20 testerów (w przypadku testów alfa) lub maksymalnie 200 (testy beta).
Skopiuj link do wyrażenia zgody, aby udostępnić go testerom.
Kliknij Zapisz.
Do testerów wyślij e-maila z zaproszeniem i linkiem do wersji alfa lub beta akcji (link umożliwiający wyrażenie zgody). Więcej informacji znajdziesz w artykule Opinie.
Link przystąpienia do testów
Link wyrażający zgodę dotyczy strony Katalog działań i nigdy się nie zmienia. Link prowadzi testerów do strony katalogu i wyświetla kartę akceptacji dla odpowiedniego środowiska. W przypadku tych samych testerów wersji alfa i beta mogą oni korzystać z obu wersji beta i karnetu na wersję alfa.
Implementacja w wersji alfa lub beta
Informacje o kanale wersji nie są uwzględniane w żądaniu HTTP od Asystenta do realizacji zamówień. Aby obsługiwać kanały wersji w realizacji, musisz podać różne adresy URL realizacji (na przykład jeden adres dla realizacji wersji beta, a drugi dla wersji produkcyjnej akcji).
Zbieraj opinie
Gdy opublikujesz akcję w wersji alfa lub beta, zaproś testerów, udostępniając im link umożliwiający wyrażenie zgody (tak samo jak w informacjach o katalogu Asystenta).
Upewnij się, że testerzy muszą:
- Pobierz aplikację Asystent Google na urządzenia mobilne, aby przeprowadzić testy alfa lub beta.
- Zaloguj się w aplikacji Asystent Google na to samo konto, którego używasz jako testera wersji alfa lub beta.
Po wdrożeniu działania wszyscy nowi testerzy muszą odczekać co najmniej 3 godziny, zanim uzyskają dostęp do działania za pomocą linku akceptacji.
Gdy użytkownik kliknie ten link, zostanie przekierowany na stronę katalogu odpowiedniego działania. Powinien po raz pierwszy kliknąć przycisk Zgadzam się u dołu strony w katalogu działań.
Gdy aktywator wyrazi na to zgodę na telefonie, akcja będzie natychmiast dostępna na wszystkich urządzeniach. Testerzy zobaczą Twoje działanie w sekcji Moje aplikacje w aplikacji Asystent Google z jednym z tych trybów: Alfa, Beta lub Brak testów. Opcja Brak testów spowoduje udostępnienie użytkownikom wersji produkcyjnej akcji (jeśli jest dostępna). Jeśli nie ma wersji produkcyjnej, użytkownicy nie zobaczą niczego.
Sprawdzone metody
- Sprawdź, czy użytkownicy mogą dołączać do testów Aby dołączyć do testu, testerzy muszą mieć konto Google (@gmail.com) lub G Suite.
- Wybierz odpowiedni typ testu. Grupa testowa alfa powinna być niewielka i przetestować najmniej stabilne, eksperymentalne wersje Actions (np. w firmie lub zespole). Użyj testów beta z większą grupą, aby przetestować stabilne wersje akcji w pobliżu danej wersji.
- Udostępnij kanał testerom, aby mogli przesyłać Ci opinie. Kanały alfa i beta są dostępne tylko dla Twoich testerów. Udostępnij im możliwość przesłania opinii e-mailem, przez stronę internetową, forum lub w inny odpowiedni sposób.
- Przeprowadzaj równoczesne testy tej samej czynności. Możesz przeprowadzać testy alfa i beta jednocześnie.
Znane problemy
- Katalogu Asystenta Google w internecie nie można włączyć dla wersji alfa lub beta. Upewnij się, że testerzy korzystają z linków na urządzeniach mobilnych (z Androidem lub iOS).
- Opublikowanie przesłanych zmian może potrwać kilka godzin. Zanim udostępnisz link do wyrażania zgody, odczekaj jakiś czas.
Tworzenie nowej wersji alfa lub beta
Aby wdrożyć akcję w wersji alfa lub beta, wykonaj te czynności:
- W konsoli Actions kliknij Deploy >Release (Wdróż > Opublikuj).
Kliknij Rozpocznij nową wersję.
Wybierz Alfa lub Beta i kliknij Prześlij.
Jeśli pojawi się taka prośba, poinformuj o wykonaniu wymaganych czynności na liście kontrolnej wymagań dotyczących podjęcia działania.
Wybierz języki wersji, która ma zastosowanie w projekcie.
Kliknij Prześlij.
Przesłana wersja alfa lub beta pojawi się w sekcji Zarządzaj wersjami.
Uaktualnianie istniejącej wersji z wersji alfa lub beta do wersji produkcyjnej
Wersje produkcyjne mogą obejmować pełne wdrażanie dla wszystkich użytkowników Asystenta Google albo etapowe wdrażanie do określonych regionów lub odsetka użytkowników. Wdrażanie etapowe pomaga testować stabilność projektu akcji. Najlepiej udostępnić ją niewielkiej grupie użytkowników i stopniowo zwiększać ich liczbę, aż dotrzesz do 100% użytkowników. Umożliwia to usunięcie błędów przed udostępnieniem ich wszystkim użytkownikom.
Wdrażanie etapowe
Wdrażanie etapowe pozwala deweloperom zarządzać wersjami produkcyjnymi, wprowadzając je na podzbiór użytkowników i stopniowo udostępniając ich wszystkim użytkownikom. Stopniowo możesz zwiększać regiony lub odsetek użytkowników we wdrożeniu.
Aby wdrożyć akcję w ramach wdrażania etapowego, wykonaj te czynności:
- W sekcji Zarządzaj wersjami wybierz wersję, którą chcesz uaktualnić do wdrożenia produkcyjnego.
- Kliknij Zarządzaj wdrożeniami.
- Wybierz Wdróż w środowisku produkcyjnym.
- Wybierz Wdrażanie etapowe.
- Kliknij Wybierz typ wdrożenia.
Wybierz Określone lokalizacje lub Procent użytkowników. Więcej informacji o tym wyborze znajdziesz w artykułach Wdrażanie przez określone lokalizacje i Wdrażanie według odsetka użytkowników.
Kliknij Prześlij.
Aby poznać etap wdrażania, zobacz Przejście na kolejny etap.
Pełne wdrożenie
Wybranie tej opcji spowoduje udostępnienie projektu działania wszystkim użytkownikom we wszystkich krajach docelowych.
Aby wdrożyć akcję w pełnym wdrożeniu, wykonaj te czynności:
- W sekcji Zarządzaj wersjami wybierz wersję, którą chcesz uaktualnić do wdrożenia produkcyjnego.
Kliknij Zarządzaj wdrożeniami.
Wybierz Wdróż w środowisku produkcyjnym.
Wybierz Pełne wdrożenie.
Kliknij Prześlij.
Utwórz nową wersję produkcyjną bez testów alfa lub beta
Wersje produkcyjne mogą obejmować pełne wdrażanie dla wszystkich użytkowników Asystenta Google albo etapowe wdrażanie do określonych regionów lub odsetka użytkowników. Wdrażanie etapowe pomaga testować stabilność projektu akcji. Najlepiej udostępnić ją niewielkiej grupie użytkowników i stopniowo zwiększać ich liczbę, aż dotrzesz do 100% użytkowników. Umożliwia to usunięcie błędów przed udostępnieniem ich wszystkim użytkownikom.
Wdrażanie etapowe
Wdrażanie etapowe pozwala deweloperom zarządzać wersjami produkcyjnymi, wprowadzając je na podzbiór użytkowników i stopniowo udostępniając ich wszystkim użytkownikom. Stopniowo możesz zwiększać regiony lub odsetek użytkowników we wdrożeniu.
Aby wdrożyć akcję w ramach wdrażania etapowego, wykonaj te czynności:
- W konsoli Actions kliknij Deploy >Release (Wdróż > Opublikuj).
Kliknij Rozpocznij nową wersję.
Kliknij Produkcyjna.
Jeśli pojawi się taka prośba, poinformuj o wykonaniu wymaganych czynności na liście kontrolnej wymagań dotyczących podjęcia działania.
Wybierz języki wersji, która ma zastosowanie w projekcie.
Wybierz Wdrażanie etapowe.
Kliknij Wybierz typ wdrożenia.
Wybierz Określone lokalizacje lub Procent użytkowników. Więcej informacji o tym wyborze znajdziesz w artykułach Wdrażanie przez określone lokalizacje i Wdrażanie według odsetka użytkowników.
Kliknij Prześlij.
Wdrożenie według określonych lokalizacji
Wybranie tej opcji spowoduje udostępnienie projektu akcji w wybranych przez Ciebie krajach lub regionach.
Aby wdrożyć akcję według lokalizacji, wykonaj te czynności:
- Kliknij Wybierz kraje lub regiony i zaznacz pola obok regionów, na które chcesz kierować aplikację.
Kliknij Prześlij.
Wdrożenie według odsetka użytkowników
Ta opcja powoduje wykonanie akcji wśród wybranego losowo użytkownika.
Aby zastosować akcję do odsetka użytkowników, wykonaj te czynności:
- Kliknij Procent użytkowników.
Wybierz odsetek użytkowników, którym chcesz udostępnić działanie.
Kliknij Prześlij.
Pełne wdrożenie
Wybranie tej opcji spowoduje udostępnienie projektu działania wszystkim użytkownikom we wszystkich krajach docelowych.
Aby wdrożyć akcję w pełnym wdrożeniu, wykonaj te czynności:
- W konsoli Actions kliknij Deploy >Release (Wdróż > Opublikuj).
Kliknij Rozpocznij nową wersję.
Kliknij Produkcyjna.
Jeśli pojawi się taka prośba, poinformuj o wykonaniu wymaganych czynności na liście kontrolnej wymagań dotyczących podjęcia działania.
Wybierz języki wersji, która ma zastosowanie w projekcie.
Wybierz Pełne wdrożenie.
Kliknij Prześlij.
Przesłana wersja produkcyjna pojawi się w sekcji Zarządzaj wersjami.
Edytowanie wersji lub wycofywanie wdrożenia
Po przesłaniu akcji do kanału wersji nadal możesz wprowadzać zmiany. Możesz przetestować bieżącą wersję, wycofać ją z weryfikacji, wyświetlić szczegóły jej wersji, zarządzać wdrożeniami, wycofać je i przejść na wyższe etapy wdrażania. Znajdziesz tu też szczegóły poprzednich wersji.
Wyświetlanie i edytowanie wersji
Aby wyświetlić szczegółowe informacje o wersji lub wprowadzić zmiany w wersji akcji:
- W sekcji Zarządzaj wersjami w sekcji Nazwa wersji wybierz wersję.
- Kliknij Edytuj wdrożenie, Zarządzaj wdrażaniem lub Zobacz więcej.
Przejście do etapu wdrażania wersji
Aby przyspieszyć etap wdrażania akcji, wykonaj te czynności:
- W sekcji Zarządzaj wersjami wybierz wersję, którą chcesz uaktualnić.
- Kliknij przycisk Edytuj wdrożenie.
- Wprowadź zmiany we wdrożeniu. Możesz np. zwiększyć liczbę użytkowników z 5% do 20%.
- Kliknij Prześlij.
Wycofaj wdrożenie z wersji produkcyjnej
- Jeśli chcesz włączyć wdrażanie etapowe w trybie offline, kliknij Edytuj wdrożenie w sekcji Zarządzaj wersjami. Możesz wyczyścić wszystkie regiony lub wybrać 0% w zależności od tego, czy wdrożenie jest podzielone według lokalizacji czy odsetka użytkowników.
- Aby wycofać wdrożenie, które jest w pełni wdrożone (dla 100% bazy użytkowników), kliknij przycisk Zarządzaj wdrożeniami w sekcji Zarządzaj wersjami i wybierz Wycofaj wdrożenie ze środowiska produkcyjnego.