Sidekick in Google Play Spiele

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.
Play Games Sidekick mit verfügbaren Funktionen
Play Games Sidekick (zum Vergrößern klicken).

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.

  1. Richten Sie in der Play Console einen Release für einen internen oder geschlossenen Test ein.
  2. Wenn Sie das Play Games Sidekick in Ihr App-Bundle aufnehmen möchten, wählen Sie Sidekick ist standardmäßig aktiviert aus.
  3. Führen Sie Ihre Tests durch.
  4. 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 ist standardmäßig aktiviert
Play Games Sidekick zum Spiel hinzufügen

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:

  1. Öffnen Sie die Google Play Store App.
  2. Tippe auf dein Profilsymbol und dann auf Einstellungen.
  3. Tippen Sie auf das Menü Info.
  4. 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.
  5. Tippen Sie auf Allgemein und dann auf Entwickleroptionen.
  6. Aktivieren Sie Play Games Sidekick.
  7. Rufen Sie Ihr Spiel auf, um das Sidekick zu sehen.
Der Schalter zum Aktivieren von Play Games Sidekick in der Google Play Store App.
Die Ein/Aus-Schaltfläche zum Aktivieren des Play Games Sidekick in der Google Play Store App (zum Vergrößern klicken).

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:

  1. Fügen Sie in der Datei AndroidManifest.xml dem 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>
  2. 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:
    • landscape
    • portrait
  • horizontal-position: Die horizontale Kante des Bildschirms, an der der Einstiegspunkt verankert werden soll. Unterstützte Werte:
    • LEFT
    • RIGHT
  • vertical-position-percent: Ein numerischer Wert im Bereich von 0 bis 100 (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-percent wird 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 mit 0 in der Nähe des oberen Rands und mit 100 in 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.

  1. Fügen Sie in der Datei AndroidManifest.xml dem 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>
  2. 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:

  1. Öffnen Sie die Play Console.
  2. Wählen Sie ein Spiel aus.
  3. Gehen Sie zu Test > Erweiterte Einstellungen.
  4. 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.
  5. 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.