Play Games Sidekick ist ein Overlay, das Spielern relevante Inhalte und Angebote präsentiert, ohne dass sie dafür das Spiel verlassen müssen.
- Spieler in deinem Spiel halten – mit offiziellen Videos und Creator-Videos können Spieler Guides, Walkthroughs und Livestreams finden, ohne die App wechseln zu müssen.
- Höhere Monetarisierung durch sofortigen Punkteumtausch, von Google Play finanzierte Angebote und Play Pass-Gutscheine.
- Gameplay mit Prämien mit integrierten Streaks, Missionen und Profilinteraktionen.
- Mehr Nutzerinteraktion und ‑bindung mit Inhalten und Videos.
Features
Die verfügbaren Funktionen im Sidekick variieren je nach Spiel und hängen vom Integrationsstatus der Google Play Games-Dienste und der Play Points-Registrierung ab. Spieler können sich auf die folgenden Funktionen freuen:
- Gaming-Tools:Screenshot, Bildschirmaufzeichnung, YouTube-Livestream und „Bitte nicht stören“.
- Erfolge:Erfordert die Implementierung von Erfolgen.
- Gaming-Streaks:Gaming-Streaks
- Play Points gegen Guthaben eintauschen
- Play Points-Booster und ‑Gutscheine:Für angemeldete Play Points-Entwickler verfügbar.
- Play Pass-Vorteile und ‑Angebote
- Aufgabenreihen:Aufgabenreihen sind für registrierte Quest-Entwickler verfügbar.
- Offizielle Videos und Creator-Videos:Sidekick zeigt die Videos an, die Sie hinzufügen. Weitere Informationen zum Hinzufügen von Videos im Google Play Store und in Sidekick finden Sie unter App mit YouTube-Videos bei Google Play präsentieren.
Software- und Hardwareanforderungen
Um auf das Sidekick zugreifen zu können, benötigen Spieler Folgendes:
- Ein Smartphone mit Android 13 oder höher.
- Spieler benötigen ein Spielerprofil.
- Das Spiel muss über den Google Play Store installiert werden.
Sidekick ausprobieren
So aktivieren Sie Sidekick für Ihr Spiel:
Sidekick für dein Spiel standardmäßig aktivieren
Erstelle in der Play Console einen Release für einen internen oder geschlossenen Test, um Vorabversionen deines Spiels mit Sidekick zu testen und gezieltes Feedback zu sammeln. Bei Tests in einem Track für geschlossene Betas ist kein direkter Vergleich der Leistungsmesswerte möglich. Es ist aber weiterhin eine gültige Methode für grundlegende Funktionstests Ihrer Sidekick-Integration.
Sobald eine kleinere Gruppe von Kollegen oder vertrauenswürdigen Nutzern diesen Release getestet hat, können Sie Ihre App für einen offenen Test freigeben.
- Richten Sie in der Play Console einen Release für einen internen oder geschlossenen Test ein.
- Wenn Sie das Play Games Sidekick in Ihr App-Bundle aufnehmen möchten, wählen Sie Sidekick ist standardmäßig aktiviert aus.
- Führen Sie Ihre Tests durch.
- Wenn Sie bereit sind, geben Sie den Build für die Produktion frei. Weitere Informationen finden Sie unter Release in Phasen vorbereiten.
Spieler können die Sichtbarkeit des Sidekicks jederzeit in den Nutzereinstellungen des Google Play Stores verwalten.
Sidekick sicher testen
Achte bei der Integration des Sidekicks darauf, dass das Overlay nahtlos in dein Spiel eingebunden wird, die Spielerfreundlichkeit nicht beeinträchtigt wird und sich keine negativen Auswirkungen auf wichtige Messwerte wie die Spielintegrität (Abstürze/ANRs), das Engagement und den Umsatz ergeben. Um vor der vollständigen Einführung eine Leistungs-Baseline festzulegen, sollten Sie einen gestaffelten Roll-out mit 5% durchführen.
Mit diesem Test-Playbook können Sie einen gleichzeitigen Vergleich in Ihrer Produktionsumgebung durchführen. So minimieren Sie das Risiko und können den Erfolg Ihrer Integration überprüfen.
Playbook für gestaffelte Roll-outs mit 5 %
Wenn du Sidekick für ein kleines, kontrolliertes Segment deiner Zielgruppe veröffentlichst, kannst du die Auswirkungen isolieren, indem du Messwerte für deine neue Spielversion erfasst.
- Release vorbereiten:Binden Sie das Sidekick SDK in Ihr Spiel ein und bereiten Sie einen neuen Release-Build vor.
- Gestaffelten Roll-out starten:Veröffentlichen Sie Ihren neuen Build in der Google Play Console im Produktions-Track mit einem gestaffelten Roll-out von 5 %. So wird die Sidekick-Integration in Echtzeit für einen kleinen Teil deiner Spielerbasis verfügbar gemacht.
- Nach App-Version isolieren:Achten Sie darauf, dass Ihre Analysetools so konfiguriert sind, dass Daten speziell für die App-Version mit der Sidekick-Integration gefiltert werden.
Leistung und Messwerte im Blick behalten
Behalten Sie während des stufenweisen Rollouts von 5% die Leistung Ihres Spiels im Blick und sorgen Sie dafür, dass Ihre wichtigsten Messwerte stabil bleiben. Verwenden Sie dazu eine Kombination aus der Google Play Console und Ihrer eigenen Analysekonfiguration. Achten Sie beim Überwachen des stufenweisen Roll-outs auf Folgendes:
- Nutzerinteraktion und ‑bindung und Spielstabilität im Blick behalten:Achten Sie in der Google Play Console darauf, dass Ihre Android Vitals (z. B. Absturzraten und ANR-Fehler) und die Messwerte zur Spielerinteraktion für die neue App-Version stabil bleiben.
- Umsatzkonsistenz im Blick behalten:Behalten Sie Ihre Umsatz- und IAP-Messwerte mithilfe Ihrer vorhandenen Analyseinfrastruktur, z. B. Google Analytics oder Ihren internen Business Intelligence-Tools (BI), im Blick. Vergleichen Sie die 5‑%‑Kohorte, die Zugriff auf Sidekick hat, mit dem restlichen Produktions-Traffic, um sicherzustellen, dass Ihre Kernmonetarisierung stabil bleibt.
Wenn Sie bestätigt haben, dass Sidekick während des gestaffelten Roll-outs von 5% erfolgreich zu Umsatz, Nutzerinteraktion und ‑bindung und Stabilität beiträgt, können Sie die Veröffentlichung auf 100% Ihrer Spieler ausweiten.
Sichtbarkeit des Sidekicks auf Ihrem Gerät für Tests verwalten
Sobald der Release für Ihre Tester in der Play Console verfügbar ist, können Sie die Entwickleroptionen im Google Play Store auf dem Gerät so aktivieren:
- Öffnen Sie die Google Play Store App.
- Tippe auf dein Profilsymbol und dann auf Einstellungen.
- Tippen Sie auf das Menü Info.
- Tippen Sie siebenmal auf die Google Play Store-Version, bis die Meldung
You are now a developer!angezeigt wird. Dadurch werden die Entwickleroptionen auf Ihrem Gerät aktiviert. - Tippen Sie auf Allgemein und dann auf Entwickleroptionen.
- Aktivieren Sie Play Games Sidekick.
- Rufen Sie Ihr Spiel auf, um das Sidekick zu sehen.
Standard-Einstiegspunkt für Sidekick konfigurieren
Standardmäßig ist der Sidekick-Einstiegspunkt am logischen Ende (der rechten Seite des Bildschirms) verankert und sowohl im Hoch- als auch im Querformat vertikal zentriert (mit einem leichten Standard-Offset). Bei der Bedienung über 3 Buttons wird der Einstiegspunkt auf die Seite verschoben, die der Navigationsleiste gegenüberliegt.
Sie können die Standardposition des Einstiegspunkts überschreiben, indem Sie in der Datei AndroidManifest.xml eine bevorzugte Position angeben.
So konfigurierst du die Standardposition des Sidekick-Einstiegspunkts für dein Spiel:
Fügen Sie in der Datei
AndroidManifest.xmldem Element<application>das folgende<meta-data>-Element hinzu:<manifest> <application> <meta-data android:name="com.google.android.finsky.deku.OVERLAY_CONFIG" android:resource="@xml/XML_RESOURCE_FILE"/> </application> </manifest>
Geben Sie den Einstiegspunkt im XML_RESOURCE_FILE an.
Beispieldatei (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>
Das <default-entrypoint-position>-Tag unterstützt die folgenden Attribute.
Alle drei Attribute (orientation, horizontal-position und vertical-position-percent) sind für jedes <default-entrypoint-position>-Tag erforderlich. Wenn entweder horizontal-position oder vertical-position-percent fehlt oder ungültig ist, wird das Tag ignoriert und für diese Ausrichtung wird die Standardposition des Systems verwendet.
orientation: Die zu konfigurierende Bildschirmausrichtung. Unterstützte Werte:landscapeportrait
horizontal-position: Die horizontale Kante des Bildschirms, an der der Einstiegspunkt verankert werden soll. Unterstützte Werte:LEFTRIGHT
vertical-position-percent: Ein numerischer Wert im Bereich von0bis100(z. B."25"oder"50"), der die vertikale Platzierung als Prozentsatz der verfügbaren Bildschirmhöhe von oben angibt. Mit"25"wird der Einstiegspunkt beispielsweise 25% unterhalb des oberen Rands platziert und mit"50"wird er vertikal zentriert. Werte, die nicht im Bereich von 0 bis 100 liegen, werden auf den nächstgelegenen Grenzwert festgelegt.vertical-position-percentwird auf die gesamte Höhe des Spielfensters angewendet. Das Symbol zum Öffnen wird immer mit einem kleinen Abstand zum oberen und unteren Bildschirmrand angezeigt und automatisch verschoben, um eine Überlappung mit einem Kameraausschnitt oder einer Displaykerbe zu vermeiden. Daher wird der Einstiegspunkt mit0in der Nähe des oberen Rands und mit100in der Nähe des unteren Rands platziert.
Diese Werte stellen physische Positionen auf dem Bildschirm dar. Mit LEFT wird der Einstiegspunkt beispielsweise am linken Bildschirmrand verankert, auch wenn das Gerät auf ein RTL-Layout (Right-to-Left, von rechts nach links) eingestellt ist.
Wenn ein Spieler den Einstiegspunkt während des Spiels manuell verschiebt, bleibt die ausgewählte Position für alle Spielsitzungen erhalten und hat Vorrang vor der benutzerdefinierten Standard-XML-Konfiguration.
Schlummerdauer für Einstiegspunkt während der Ersteinrichtung konfigurieren
Der Einstiegspunkt für Play Games Sidekick wird standardmäßig sofort angezeigt. Sie können den In-Game-Einstiegspunkt für eine konfigurierte benutzerdefinierte Dauer in der XML_RESOURCE_FILE pausieren.
Wenn eine Schlummerdauer festgelegt ist, wird der Sidekick-Einstiegspunkt während der ersten Nutzung (First Time User Experience, FTUE) für die konfigurierte Zeit ausgeblendet. Nach Ablauf des Schlummerzeitraums wird der Einstiegspunkt angezeigt.
Fügen Sie in der Datei
AndroidManifest.xmldem Element<application>das folgende<meta-data>-Element hinzu:<manifest> <application> <meta-data android:name="com.google.android.finsky.deku.OVERLAY_CONFIG" android:resource="@xml/XML_RESOURCE_FILE"/> </application> </manifest>
Geben Sie die Schlummerdauer in XML_RESOURCE_FILE an.
Beispieldatei (res/xml/XML_RESOURCE_FILE.xml):
<?xml version="1.0" encoding="utf-8"?> <deku-config> <!-- Entrypoint default position overrides --> <default-entrypoint-position orientation="portrait" horizontal-position="RIGHT" vertical-position-percent="25" /> <default-entrypoint-position orientation="landscape" horizontal-position="LEFT" vertical-position-percent="50" /> <!-- Custom Snooze Period --> <snooze duration_seconds="300" /> <!-- Extensible: Add new configuration fields here as needed --> </deku-config>
Die benutzerdefinierte Schlummerdauer ist auf 30 Minuten begrenzt. Wenn Sie einen Wert angeben, der diesen Grenzwert überschreitet, wird automatisch das 30‑Minuten-Limit verwendet.
Sidekick automatisch zu allen Bundle-Uploads hinzufügen
Wenn du einen Release erstellst und das Sidekick für dein Spiel standardmäßig aktivierst, wird das Sidekick allen zukünftigen App-Bundles hinzugefügt.
So ändern Sie, ob Sidekick standardmäßig für alle neuen App-Bundles aktiviert ist, die Sie hochladen:
- Öffnen Sie die Play Console.
- Wählen Sie ein Spiel aus.
- Gehen Sie zu Test > Erweiterte Einstellungen.
- Wählen Sie auf dem Tab Play Games Sidekick eine der folgenden Optionen aus:
- Sidekick standardmäßig für neue App-Bundles aktivieren, die ich hochlade
- Sidekick nicht standardmäßig für neue App-Bundles aktivieren, die ich hochlade.
- Wählen Sie Änderungen speichern aus.
Wenn Ihre App nur selten aktualisiert wird, aktualisieren wir den Sidekick möglicherweise regelmäßig für Sie. Sie können die Teilnahme an Sidekick jederzeit über die erweiterten Einstellungen in der Google Play Console beenden.
Sidekick in Produktions-Track hochstufen
Wenn du einen Release mit Sidekick in die Produktionsversion überträgst, wird Spielern das Sidekick angezeigt. Spieler können die Sichtbarkeit des Sidekicks jederzeit in den Nutzereinstellungen der Google Play Store App verwalten.
Spiele, für die eine Veröffentlichung mit Sidekick beworben wird, entsprechen den Level Up-Richtlinien.
Feedback geben
Wenn Sie Feedback zu Sidekick haben, verwenden Sie bitte das Feedbackformular.
Häufig gestellte Fragen
Kann ich Sidekick über die Publishing API zu meinem Spiel hinzufügen?
Sie können Sidekick Ihrem Spiel auch dann hinzufügen, wenn Sie die Google Play Developer Publishing API für die Veröffentlichung verwenden. Fügen Sie Sidekick zuerst automatisch allen Bundle-Uploads hinzu und setzen Sie dann den normalen Releaseprozess fort. Sidekick wird Ihrem Android App Bundle hinzugefügt.
Mein Spiel verwendet keine Android App Bundles (AAB). Was soll ich tun?
Sidekick wird Spielen hinzugefügt, wenn Sie ein neues Android App Bundle hochladen.
Wenn du APKs verwendest, füge das Sidekick SDK als Abhängigkeit hinzu.
In meinem Spiel wird ein Produkt zur Manipulationssicherheit verwendet. Ist Sidekick mit meiner Lösung kompatibel?
Wir haben mit führenden Unternehmen zusammengearbeitet, um die Kompatibilität von Sidekick sicherzustellen.
Wenn Sie ein inkompatibles Produkt zum Schutz vor Manipulationen verwenden, fügen Sie das Sidekick SDK als Abhängigkeit zu Ihrem APK hinzu. Wenn Sie weitere Fragen haben, wenden Sie sich an den Support.
Warum werden Erfolge nicht in Sidekick angezeigt?
Wenn Erfolge nicht wie erwartet angezeigt werden, prüfe Folgendes:
- Status „Entwurf“:Erfolge mit dem Status „Entwurf“ werden im Sidekick nicht angezeigt.
- Erfolgssymbol:Gesperrte Erfolge sind nur für alle Spieler sichtbar, wenn das Spiel ein Erfolgssymbol erhalten hat. Dazu müssen in den letzten 30 Tagen mindestens 100 einzelne Spieler die Achievements API aufgerufen haben.
- Freigeschaltet:Wenn das Spiel noch kein Badge erhalten hat, sehen die Spieler Erfolge, die sie bereits freigeschaltet haben.