Panel pomocniczy w Grach Play

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

  • Utrzymuj graczy w grze dzięki oficjalnym filmom i materiałom twórców, aby gracze mogli znaleźć przewodniki, filmy z przejściem gry i transmisje na żywo bez przełączania aplikacji.
  • Zwiększone możliwości zarabiania dzięki wymianie punktów w czasie rzeczywistym, ofertom finansowanym przez Google Play i kuponom Pass.
  • Rozgrywka z nagrodami ze 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 różnią się w zależności od gry, stanu integracji z usługami gier Google Play i rejestracji w programie Play Points. Gracze mogą oczekiwać tych funkcji:

  • Narzędzia do gier: zrzut ekranu, nagrywanie ekranu, transmisja na żywo na 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 w programie Play Points i kupony: dostępne dla deweloperów zarejestrowanych w programie Play Points.
  • Korzyści i oferty Play Pass
  • Zadania: zadania są dostępne dla zarejestrowanych deweloperów Quest.
  • Oficjalne filmy i filmy twórców: Sidekick wyświetla dodane przez Ciebie filmy. Więcej informacji o dodawaniu filmów w Sklepie Play i Sidekick 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ć 1 profil gracza.
  • Gra musi być zainstalowana ze Sklepu Play.

Wypróbuj panel pomocniczy

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

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

Utwórz wersję do testów wewnętrznych lub zamkniętych w Konsoli Play, aby przetestować przedpremierowe wersje gry z panelem pomocniczym i zebrać ukierunkowane opinie. Pamiętaj, że testowanie na ścieżce zamkniętych testów beta nie umożliwia bezpośredniego porównania wskaźników skuteczności, ale pozostaje prawidłową metodą podstawowych testów funkcjonalnych integracji z panelem bocznym.

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ę do testów wewnętrznych lub zamkniętych.
  2. Aby dodać panel Sidekick w Grach Play do pakietu aplikacji, wybierz Panel Sidekick jest domyślnie włączony.
  3. Przeprowadź testy.
  4. Gdy wszystko będzie gotowe, opublikuj kompilację w wersji produkcyjnej. 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 integracji panelu Sidekick upewnij się, że nakładka płynnie integruje się z grą, zapewnia spójne wrażenia gracza i nie wpływa negatywnie na kluczowe dane, takie jak stan gry (awarie/błędy ANR), zaangażowanie i przychody. Aby ustalić podstawowy poziom wydajności przed pełnym wdrożeniem, użyj wdrażania etapowego na poziomie 5%.

Ten scenariusz testowy umożliwia przeprowadzenie jednoczesnego porównania w środowisku produkcyjnym, co minimalizuje ryzyko i pozwala zweryfikować powodzenie integracji.

Przewodnik po wdrażaniu etapowym na poziomie 5%

Udostępniając panel Sidekick niewielkiemu, kontrolowanemu segmentowi odbiorców, możesz wyizolować jego wpływ, śledząc dane dotyczące nowej wersji gry.

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

Monitorowanie skuteczności i danych

Podczas wdrażania etapowego na poziomie 5% monitoruj wydajność gry i upewnij się, że podstawowe dane pozostają stabilne. Możesz to zrobić, korzystając z Konsoli Google Play i własnej konfiguracji analitycznej. Podczas monitorowania wdrażania etapowego zwróć uwagę na te kwestie:

  • Śledź zaangażowanie i stabilność gry: używaj Konsoli Google Play, aby sprawdzać, czy Android Vitals (np. częstotliwość awarii i błędów ANR) oraz wskaźniki zaangażowania 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 do analizy biznesowej. Porównaj kohortę 5% użytkowników, którzy mają dostęp do panelu bocznego, z resztą ruchu produkcyjnego, aby upewnić się, że podstawowe zarobki pozostają stabilne.

Gdy sprawdzisz, że panel pomocniczy skutecznie zwiększa przychody, zaangażowanie i stabilność podczas wdrażania etapowego na poziomie 5%, możesz bez obaw przejść do udostępnienia go wszystkim graczom.

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ć opcje programisty Sklepu Play na urządzeniu:

  1. Otwórz aplikację Sklep Google Play.
  2. Kliknij ikonę profilu, a następnie Ustawienia.
  3. Kliknij menu Informacje.
  4. Kliknij Wersja Sklepu Play 7 razy, aż zobaczysz komunikat You are now a developer!. Spowoduje to włączenie opcji programisty na urządzeniu.
  5. Kliknij Ogólne, a następnie Opcje programisty.
  6. Włącz panel pomocniczy w Grach Play.
  7. Otwórz grę, aby zobaczyć panel Sidekick.
Przełącznik umożliwiający włączenie panelu pomocniczego Gier Play w aplikacji Sklep Google Play.
Przełącznik do włączania panelu pomocniczego w Grach Play w aplikacji Sklep Google Play (kliknij, aby powiększyć).

Konfigurowanie domyślnego punktu wejścia do panelu pomocniczego

Domyślnie punkt wejścia panelu Sidekick jest zakotwiczony na logicznej krawędzi końcowej (MIDDLE_RIGHT ekranu) i jest 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 przesuwa się na stronę przeciwną do paska nawigacyjnego.

Domyślną pozycję punktu wejścia możesz zastąpić, określając preferowaną pozycję w pliku zasobów XML, do którego odwołuje się plik AndroidManifest.xml, za pomocą tych opcji:

  • Dokładna pozycja: określ dokładną pozycję punktu wejścia jako wartość procentową w pliku zasobów XML.
  • Pozycja wyrównana do krawędzi: określ pozycję punktu wejścia wyrównanego do krawędzi w pliku zasobów XML.

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

Konfigurowanie dokładnej pozycji punktu wejścia

Aby skonfigurować dokładną pozycję punktu wejścia panelu Sidekick w grze, wykonaj następujące czynności:

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

    <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 -->
   <!-- Anchored to RIGHT edge, 25% down from top -->
   <default-entrypoint-position orientation="portrait" horizontal-position="RIGHT" vertical-position-percent="25" />

   <!-- Anchored to LEFT edge, vertically centered at 50% -->
   <default-entrypoint-position orientation="landscape" horizontal-position="LEFT" vertical-position-percent="50" />

   <!-- Extensible: Add new configuration fields here as needed -->
</deku-config>

Tag <default-entrypoint-position> obsługuje te atrybuty:

  • orientation: orientacja ekranu do skonfigurowania. Obsługiwane wartości:
    • landscape
    • portrait
  • horizontal-position: pozioma krawędź ekranu, do której ma być zakotwiczony punkt wejścia. Obsługiwane wartości:
    • LEFT
    • RIGHT

  • vertical-position-percent: wartość liczbowa z zakresu od 0 do 100 (np. "25" lub "50"), która określa położenie pionowe jako procent wysokości okna gry od góry. Na przykład "25" umieszcza punkt wejścia na wysokości 25% od górnej krawędzi, a "50" wyśrodkowuje go w pionie. Wartości spoza zakresu 0–100 są ustawiane na najbliższy limit.

    Punkt wejścia zawsze zachowuje niewielki margines od górnej i dolnej krawędzi ekranu i jest automatycznie przesuwany, aby nie nakładał się na wycięcie na aparat lub wcięcie wyświetlacza. W rezultacie 0 umieszcza punkt wejścia w pobliżu górnej krawędzi, a 100 – w pobliżu dolnej krawędzi.

Te wartości reprezentują fizyczne pozycje na ekranie. Na przykład LEFT zakotwicza punkt wejścia przy lewej krawędzi ekranu, nawet jeśli urządzenie jest ustawione na układ od prawej do lewej.

Reguły zastępowania i pierwszeństwa

Aby skonfigurować dokładną pozycję, określ atrybuty orientation, horizontal-position i vertical-position-percent w tagu <default-entrypoint-position>:

  • Jeśli parametry horizontal-position i vertical-position-percent są prawidłowe, mają pierwszeństwo przed atrybutem value w tym samym tagu.
  • Jeśli brakuje atrybutów horizontal-position lub vertical-position-percent albo są one nieprawidłowe, punkt wejścia używa atrybutu value, jeśli jest on obecny.
  • Jeśli brakuje też atrybutu value lub jest on nieprawidłowy, punkt wejścia wraca do domyślnej pozycji.

Konfigurowanie pozycji punktu wejścia wyrównanego do krawędzi

Aby skonfigurować pozycję punktu wejścia panelu Sidekick wyrównanego do krawędzi w grze:

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

    <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 punktu wejścia orientation:

  • krajobraz
  • orientacja pionowa

Atrybut value reprezentuje fizyczne pozycje na ekranie. Na przykład MIDDLE_LEFT zawsze zakotwicza punkt wejścia przy lewej krawędzi ekranu, nawet jeśli urządzenie jest ustawione na układ od prawej do lewej. Obsługiwane wartości pozycji punktu wejścia wyrównanego do krawędzi to:

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

Konfigurowanie czasu odłożenia punktu wejścia podczas pierwszego uruchomienia

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

Gdy ustawiony jest czas odłożenia, punkt wejścia do panelu Sidekick jest ukryty podczas pierwszego korzystania z aplikacji (FTUE) przez skonfigurowany czas. Po zakończeniu okresu uśpienia punkt wejścia pojawi się ponownie.

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

    <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 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>

Niestandardowy czas drzemki jest ograniczony do 30 minut. Jeśli podasz wartość, która przekracza ten próg, system automatycznie zastosuje domyślny 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 Twoich przyszłych pakietów aplikacji.

Aby zmienić ustawienie domyślnego włączania 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:
    • 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ć panel Sidekick za Ciebie. W każdej chwili możesz zrezygnować z panelu Sidekick, korzystając z ustawień zaawansowanych w Konsoli Google Play.

Przenoszenie panelu Sidekick do środowiska produkcyjnego

Jeśli opublikujesz wersję zawierającą panel Sidekick w środowisku produkcyjnym, 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.

Najczęstsze pytania

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

Możesz dodać panel Sidekick do gry, nawet jeśli publikujesz ją za pomocą interfejsu Google Play Developer Publishing API. Najpierw automatycznie dodaj panel Sidekick do wszystkich przesyłanych pakietów, a potem kontynuuj normalny proces publikowania. Panel pomocniczy 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 usługi zapobiegającej nieuprawnionym modyfikacjom. Czy panel Sidekick jest zgodny z moim rozwiązaniem?

Współpracujemy z wiodącymi firmami, aby zapewnić zgodność z Sidekick.

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 pomocniczym?

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

  • Stan wersji roboczej: osiągnięcia w stanie „Wersja robocza” nie są wyświetlane w panelu pomocniczym.
  • Odznaka za osiągnięcia: zablokowane osiągnięcia są widoczne dla wszystkich graczy tylko wtedy, gdy gra zdobyła odznakę za osiągnięcia. Wymaga to co najmniej 100 unikalnych graczy, którzy w ciągu ostatnich 30 dni wywołali interfejs API osiągnięć.
  • Odblokowane: jeśli gra nie zdobyła plakietki, gracze widzą osiągnięcia, które już odblokowali.