Panel pomocniczy w Grach Play

panel Sidekick w Grach Play to nakładka, która pomaga graczom pozostać w grze, dostarczając odpowiednie treści i oferty bezpośrednio do graczy.

  • Utrzymanie użytkowników dzięki Gemini Live i wskazówkom, dzięki czemu gracze nie muszą opuszczać gry, aby uzyskać pomoc lub poradę.
  • Zwiększone przychody dzięki wymianie punktów w danym momencie, ofertom finansowanym przez Google Play i kuponom Play Pass.
  • Rozgrywka z nagrodami z zintegrowanymi seriami, zadaniami i interakcjami z profilem.
  • Większe zaangażowanie w treści i filmy.
Panel Sidekick w Grach Play z dostępnymi funkcjami.
Panel Sidekick w Grach Play (kliknij, aby powiększyć).

Funkcje

Dostępne funkcje panelu Sidekick będą się różnić w zależności od gry, stanu integracji z usługami gier Google Play i rejestracji w programie Play Points. Gracze mogą spodziewać się tych funkcji:

  • Narzędzia do gier: zrzut ekranu, nagrywanie ekranu, transmisja na żywo w YouTube i tryb Nie przeszkadzać.
  • Osiągnięcia: wymaga wdrożenia osiągnięć.
  • Serie w grach: serie w grach.
  • Wymiana punktów Play na środki.
  • Mnożniki i kupony Play Points: dostępne dla deweloperów zarejestrowanych w programie Play Points.
  • Korzyści i oferty Play Pass.
  • Kursy: kursy są dostępne dla deweloperów, którzy się na nie zapisali.
  • Filmy oficjalne i filmy twórców: Sidekick wyświetla dodane przez Ciebie filmy. Więcej informacji o dodawaniu filmów w Sklepie Play i Sidekicku znajdziesz w artykule Prezentowanie aplikacji w Google Play za pomocą filmów w YouTube.

Wymagania dotyczące oprogramowania i sprzętu

Aby uzyskać dostęp do panelu Sidekick, gracze muszą mieć:

  • telefon komórkowy z Androidem 13 lub nowszym;
  • Gracze muszą mieć profil gracza.
  • Gra musi być zainstalowana ze Sklepu Play.

Wypróbuj Sidekick

Aby włączyć panel Sidekick w grze, wykonaj następujące czynności:

Ustawienie panelu Sidekick jako domyślnie włączonego w grze

Utwórz w Konsoli Play wersję testową do testów wewnętrznych lub zamkniętych, aby testować wersje przedpremierowe gry za pomocą panelu Sidekick i zbierać ukierunkowane opinie. Pamiętaj, że testowanie na ścieżce testów zamkniętych nie umożliwia bezpośredniego porównania danych o skuteczności, ale nadal jest prawidłową metodą podstawowego testowania funkcjonalności integracji Sidekick.

Gdy ukończysz testy w małej grupie współpracowników lub zaufanych użytkowników, możesz utworzyć wersję otwartą, aby rozszerzyć testy.

  1. W Konsoli Play skonfiguruj wersję testową do testów wewnętrznych lub zamkniętych.
  2. Aby dodać do pakietu aplikacji panel Sidekick w Grach Play, wybierz Panel Sidekick jest domyślnie włączony.
  3. Przeprowadź testy.
  4. Gdy wszystko będzie gotowe, opublikuj wersję produkcyjną. Więcej informacji znajdziesz w artykule Przygotowywanie wersji etapami.

Gracze mogą w każdej chwili zmienić widoczność panelu Sidekick w ustawieniach użytkownika w Sklepie Play.

Panel Sidekick jest domyślnie włączony
Dodaj do swojej gry panel Sidekick w Grach Play.

Bezpieczne testowanie panelu Sidekick

Podczas integrowania panelu Sidekick upewnij się, że nakładka jest płynnie zintegrowana z grą, zapewnia spójne wrażenia gracza i nie wpływa negatywnie na kluczowe wskaźniki, takie jak stan gry (awarie/ANR), zaangażowanie i przychody. Aby przed pełnym wdrożeniem ustalić punkt odniesienia wydajności, użyj 5-procentowego wdrożenia etapowego.

Ten przewodnik po testowaniu umożliwia przeprowadzenie równoczesnego porównania w środowisku produkcyjnym, co minimalizuje ryzyko i pozwala sprawdzić skuteczność integracji.

Poradnik dotyczący wdrażania etapowego na 5% użytkowników

Udostępniając panel Sidekick niewielkiemu, kontrolowanemu segmentowi odbiorców, możesz odizolować jego wpływ, śledząc dane w porównaniu z nową wersją gry.

  • Przygotuj kompilację do publikacji: zintegruj pakiet SDK panelu Sidekick z grą i przygotuj nową kompilację do publikacji.
  • Rozpocznij wdrażanie etapowe: opublikuj nową wersję na ścieżce produkcyjnej, korzystając z 5-procentowego wdrażania etapowego w Konsoli Google Play. Dzięki temu integracja z panelem pomocniczym będzie dostępna w czasie rzeczywistym dla niewielkiej części graczy.
  • Wyodrębnij dane według wersji aplikacji: upewnij się, że narzędzia analityczne są skonfigurowane tak, aby filtrować dane dotyczące konkretnej wersji aplikacji zawierającej integrację z Sidekickiem.

Monitorowanie skuteczności i danych

Podczas 5-procentowego wdrażania etapowego monitoruj wydajność gry i zapewnij stabilność podstawowych danych, korzystając z Konsoli Play i własnej konfiguracji analitycznej. Podczas monitorowania wdrażania etapowego zwróć uwagę na te elementy:

  • Śledź zaangażowanie i stabilność gry: w Konsoli Google Play sprawdzaj, czy wskaźniki Android Vitals (np. częstotliwość awarii i błędów ANR) oraz dane o zaangażowaniu graczy pozostają stabilne w przypadku nowej wersji aplikacji.
  • Śledź spójność przychodów: uważnie monitoruj przychody i dane dotyczące zakupów w aplikacji, korzystając z dotychczasowej infrastruktury analitycznej, np. Google Analytics lub wewnętrznych narzędzi Business Intelligence (BI). Porównaj grupę 5% użytkowników, którzy mają dostęp do Sidekicka, z pozostałą częścią ruchu produkcyjnego, aby upewnić się, że podstawowe źródła przychodów pozostają stabilne.

Gdy podczas wdrażania etapowego na 5% użytkowników potwierdzisz, że panel Sidekick skutecznie zwiększa przychody, zaangażowanie i stabilność, możesz śmiało wdrożyć go w 100% przypadków.

Zarządzanie widocznością panelu Sidekick na urządzeniu na potrzeby testów

Gdy wersja będzie dostępna dla testerów w Konsoli Play, wykonaj te czynności, aby włączyć na urządzeniu opcje deweloperskie w Sklepie Play:

  1. Otwórz aplikację Sklep Google Play.
  2. Kliknij ikonę profilu, a następnie wybierz Ustawienia.
  3. Kliknij menu Informacje.
  4. Kliknij 7 razy Wersja Sklepu Play, aż pojawi się komunikat You are now a developer!. Włączy to opcje programisty na urządzeniu.
  5. Kliknij Ogólne, a potem Opcje programisty.
  6. Włącz panel Sidekick w Grach Play.
  7. Otwórz grę, aby zobaczyć panel Sidekick.
Przełącznik włączania panelu Sidekick w Grach Play w aplikacji Sklep Google Play.
Przełącznik włączania panelu Sidekick w Grach Play w aplikacji Sklep Google Play (kliknij, aby powiększyć).

Konfigurowanie domyślnego punktu wejścia do panelu Sidekick

Domyślnie punkt wejścia do panelu Sidekick jest przykotwiczony do logicznej krawędzi końcowej (środkowej prawej strony ekranu) i wyśrodkowany w pionie (z niewielkim domyślnym przesunięciem) zarówno w orientacji pionowej, jak i poziomej. W przypadku nawigacji przy użyciu 3 przycisków punkt wejścia przenosi się na bok przeciwny do paska nawigacyjnego.

Możesz zastąpić domyślną pozycję punktu wejścia, określając preferowaną pozycję w pliku AndroidManifest.xml.

Aby skonfigurować domyślną pozycję punktu wejścia do panelu Sidekick w swojej grze, wykonaj te czynności:

  1. W pliku AndroidManifest.xml dodaj ten element <meta-data> do elementu <application>:

    <manifest>
     <application>
      <meta-data
      android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
      android:resource="@xml/XML_RESOURCE_FILE"/>
     </application>
    
    </manifest>
  2. Określ lokalizację punktu wejścia w XML_RESOURCE_FILE.

    Przykładowy plik (res/xml/XML_RESOURCE_FILE.xml):

    <?xml version="1.0" encoding="utf-8"?>
    <deku-config>
      <!-- Entrypoint default position overrides -->
      <default-entrypoint-position orientation="landscape" value="MIDDLE_LEFT" />
      <default-entrypoint-position orientation="portrait" value="TOP_RIGHT" />
    
      <!-- Extensible: Add new configuration fields here as needed -->
    </deku-config>

Obsługiwane wartości orientacji punktu wejścia:

  • krajobraz
  • orientacja pionowa

Te wartości odpowiadają fizycznym pozycjom na ekranie. Na przykład MIDDLE_LEFT zawsze będzie przytwierdzać punkt wejścia do lewej krawędzi ekranu, nawet jeśli urządzenie jest ustawione na język zapisywany od prawej do lewej. Obsługiwane wartości pozycji wyrównanych do krawędzi są podane poniżej.

  • MIDDLE_LEFT
  • MIDDLE_RIGHT
  • TOP_LEFT
  • TOP_RIGHT
  • BOTTOM_LEFT
  • BOTTOM_RIGHT

Jeśli gracz ręcznie przeciągnie i zmieni położenie punktu wejścia podczas rozgrywki, wybrana przez niego pozycja będzie utrzymywana w kolejnych sesjach gry i będzie miała pierwszeństwo przed niestandardową domyślną konfiguracją XML.

Konfigurowanie czasu odroczenia punktu wejścia podczas pierwszego kontaktu użytkownika z aplikacją

Domyślnie punkt wejścia do panelu Sidekick w Grach Play wyświetla się od razu. Możesz wstrzymać punkt wejścia w grze na skonfigurowany czas niestandardowy w XML_RESOURCE_FILE.

Gdy ustawisz czas odroczenia, punkt wejścia Sidekick będzie ukryty podczas pierwszego kontaktu użytkownika z aplikacją przez skonfigurowany czas. Po upływie czasu odroczenia pojawi się punkt wejścia.

  1. W pliku AndroidManifest.xml dodaj ten element <meta-data> do elementu <application>:

    <manifest>
     <application>
      <meta-data
      android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
      android:resource="@xml/XML_RESOURCE_FILE"/>
     </application>
    
    </manifest>
  2. Określ czas trwania drzemki w XML_RESOURCE_FILE.

    Przykładowy plik (res/xml/XML_RESOURCE_FILE.xml):

    <?xml version="1.0" encoding="utf-8"?>
    <deku-config>
      <!-- Entrypoint default position overrides -->
      <default-entrypoint-position orientation="landscape" value="MIDDLE_LEFT" />
      <default-entrypoint-position orientation="portrait" value="TOP_RIGHT" />
    
      <!-- Custom Snooze Period -->
      <snooze duration_seconds="300" />
    
      <!-- Extensible: Add new configuration fields here as needed -->
    </deku-config>

Maksymalny czas trwania niestandardowego odroczenia to 30 minut. Jeśli podasz wartość, która przekracza ten próg, system automatycznie ustawi limit 30 minut.

Automatycznie dodawaj panel Sidekick do wszystkich przesyłanych pakietów

Gdy utworzysz wersję i ustawisz panel Sidekick jako domyślnie włączony w swojej grze, zostanie on dodany do wszystkich przyszłych pakietów aplikacji.

Aby zmienić ustawienie domyślnego włączenia panelu Sidekick we wszystkich nowych przesyłanych pakietach aplikacji, wykonaj te czynności:

  1. Otwórz Konsolę Play.
  2. Wybierz grę.
  3. Kliknij Testowanie > Ustawienia zaawansowane.
  4. Na karcie panel Sidekick w Grach Play wybierz jedną z tych opcji:
    • Automatycznie włączaj panel Sidekick w nowych przesyłanych pakietach aplikacji.
    • Nie ustawiaj automatycznie panelu Sidekick jako domyślnie włączonego w nowych przesyłanych pakietach aplikacji.
  5. Kliknij Zapisz zmiany.

Jeśli aktualizacje aplikacji są rzadkie, możemy okresowo aktualizować Sidekicka za Ciebie. W każdej chwili możesz zrezygnować z Sidekick, korzystając z ustawień zaawansowanych w Konsoli Google Play.

Przenoszenie panelu Sidekick do środowiska produkcyjnego

Jeśli awansujesz wersję zawierającą panel Sidekick do wersji produkcyjnej, gracze będą widzieć panel Sidekick. Gracze mogą w każdej chwili zmienić widoczność panelu Sidekick w ustawieniach użytkownika w aplikacji Sklep Play.

Gry, które promują premierę za pomocą panelu Sidekick, spełniają wytyczne programu Level Up.

Prześlij opinię

Jeśli masz jakieś uwagi na temat Sidekicka, skorzystaj z formularza opinii.

Najczęstsze pytania

Czy możesz dodać panel Sidekick do swojej gry za pomocą interfejsu Publishing API?

Panel Sidekick możesz dodać do gry nawet wtedy, gdy publikujesz ją za pomocą interfejsu Google Play Developer Publishing API. Najpierw automatycznie dodaj panel Sidekick do wszystkich przesłanych pakietów, a następnie kontynuuj normalny proces publikacji. Panel Sidekick zostanie dodany do pakietu Android App Bundle.

Moja gra nie korzysta z pakietów Android App Bundle (AAB). Co mam zrobić?

Panel Sidekick jest dodawany do gier, gdy przesyłasz nowy pakiet Android App Bundle.

Jeśli używasz plików APK, dodaj pakiet SDK panelu Sidekick jako zależność.

Moja gra korzysta z produktu zabezpieczającego przed manipulacjami. Czy panel Sidekick jest zgodny z moim rozwiązaniem?

Współpracujemy z czołowymi firmami, aby zapewnić zgodność z Sidekickiem.

Jeśli używasz niezgodnego produktu zapobiegającego manipulacjom, dodaj pakiet SDK panelu Sidekick jako zależność do pliku APK. Jeśli masz inne pytania, poproś o pomoc.

Dlaczego osiągnięcia nie wyświetlają się w panelu Sidekick?

Jeśli osiągnięcia nie wyświetlają się zgodnie z oczekiwaniami, sprawdź:

  • Stan wersji roboczej: osiągnięcia w stanie „Wersja robocza” nie są widoczne w Sidekicku.
  • Plakietka osiągnięcia: zablokowane osiągnięcia są widoczne dla wszystkich graczy tylko wtedy, gdy gra ma plakietkę osiągnięć. Wymaga to co najmniej 100 niepowtarzalnych graczy, którzy w ciągu ostatnich 30 dni wywołali interfejs Achievements API.
  • Odblokowane: jeśli gra nie ma odznaki, gracze widzą osiągnięcia, które już zdobyli.