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.

  • Zatrzymaj graczy w swojej grze dzięki oficjalnym filmom i filmom twórców. Gracze mogą znaleźć przewodniki, instrukcje i transmisje na żywo bez przełączania aplikacji.
  • Zwiększanie przychodów dzięki wymianie punktów w momencie zakupu, 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ą oczekiwać 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 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ć 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ę do testów wewnętrznych lub zamkniętych, aby przetestować przedpremierowe wersje gry z panelem Sidekick i zebrać 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 pozostaje 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ć poziom wydajności, użyj 5-procentowego wdrażania etapowego.

Ten przewodnik po testowaniu umożliwia przeprowadzenie równoczesnego porównania w środowisku produkcyjnym, co minimalizuje ryzyko i pozwala sprawdzić, czy integracja przebiegła pomyślnie.

Scenariusz wdrażania etapowego dla 5% użytkowników

Udostępniając panel Sidekick niewielkiemu, kontrolowanemu segmentowi odbiorców, możesz wyodrębnić 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 w Grach Play będzie dostępna w czasie rzeczywistym dla niewielkiej części Twoich graczy.
  • Izoluj według wersji aplikacji: upewnij się, że narzędzia analityczne są skonfigurowane tak, aby filtrować dane konkretnie dla wersji aplikacji zawierającej integrację Sidekick.

Monitorowanie skuteczności i danych

Podczas wdrażania etapowego na 5% użytkowników monitoruj wydajność gry i zapewnij stabilność podstawowych danych, 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 upewnić się, że dane Android Vitals (takie jak 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 zarabianie pozostaje stabilne.

Gdy podczas 5-procentowego wdrażania etapowego potwierdzisz, że panel Sidekick skutecznie zwiększa przychody, zaangażowanie i stabilność, możesz śmiało przejść do udostępnienia go 100% graczy.

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 wersję Sklepu Play, aż pojawi się komunikat You are now a developer!. Włącza 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 panelu Sidekick

Domyślnie punkt wejścia do panelu Sidekick jest przytwierdzony 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 reprezentują fizyczne pozycje 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 w przypadku pozycji wyrównanych do krawędzi są następujące:

  • MIDDLE_LEFT
  • MIDDLE_RIGHT
  • TOP_LEFT
  • TOP_RIGHT
  • LEWY_DOLNY
  • 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 wyższy priorytet niż niestandardowa domyślna konfiguracja 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ć wyświetlanie punktu wejścia w grze na skonfigurowany czas niestandardowy w XML_RESOURCE_FILE.

Gdy ustawisz czas odroczenia, punkt wejścia do panelu 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-minutowy.

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łą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 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 panelu Sidekick, korzystając z ustawień zaawansowanych w Konsoli Google Play.

Przenoszenie panelu Sidekick do wersji produkcyjnej

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 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 przesyłanych pakietów, a potem kontynuuj normalny proces publikowania. 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 aplikacji na Androida.

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 wiodącymi 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 aplikacji Sidekick.
  • Plakietka osiągnięcia: zablokowane osiągnięcia są widoczne dla wszystkich graczy tylko wtedy, gdy gra ma plakietkę osiągnięć. Wymaga to, aby w ciągu ostatnich 30 dni co najmniej 100 unikalnych graczy wywołało interfejs Achievements API.
  • Odblokowane: jeśli gra nie zdobyła odznaki, gracze widzą osiągnięcia, które już odblokowali.