Assistant Play Jeux

Play Games Sidekick est une superposition qui aide les joueurs à rester dans votre jeu en leur proposant du contenu et des offres pertinents.

  • Retenez les joueurs dans votre jeu grâce à des vidéos officielles et de créateurs. Ils pourront ainsi trouver des guides, des soluces et des diffusions en direct sans changer d'application.
  • Monétisation accrue grâce à l'échange de points en temps réel, aux offres financées par Play et aux bons de réduction Pass.
  • Gameplay récompensé avec des séries, des quêtes et des interactions de profil intégrées.
  • Un engagement accru avec vos contenus et vos vidéos
L'Assistant Play Games et ses fonctionnalités disponibles.
Play Games Sidekick (cliquez pour agrandir).

Fonctionnalités

Les fonctionnalités disponibles sur Sidekick varient selon le jeu, en fonction de l'état d'intégration des services Google Play Games et de votre inscription à Play Points. Les joueurs peuvent s'attendre aux fonctionnalités suivantes :

  • Utilitaires de jeu : capture d'écran, enregistrement d'écran, diffusion en direct sur YouTube et mode Ne pas déranger.
  • Succès : nécessite l'implémentation de succès.
  • Sessions de jeu en série : Sessions de jeu en série.
  • Échange de points Play contre du crédit
  • Boosters de points Play et bons de réduction :  disponibles pour les développeurs inscrits au programme Play Points.
  • Avantages et offres Play Pass
  • Quests : les Quests sont disponibles pour les développeurs Quest inscrits.
  • Vidéos officielles et de créateurs : Sidekick affiche les vidéos que vous ajoutez. Pour en savoir plus sur l'ajout de vidéos sur le Play Store et Sidekick, consultez Présenter votre application à l'aide de vidéos YouTube sur Google Play.

Configuration logicielle et matérielle requise

Pour accéder à Sidekick, les joueurs doivent disposer des éléments suivants :

  • Un téléphone mobile équipé d'Android 13 ou version ultérieure.
  • Les joueurs doivent disposer d'un profil de joueur.
  • Le jeu doit être installé depuis le Play Store.

Essayer Sidekick

Pour activer l'Assistant dans votre jeu, procédez comme suit :

Activer Sidekick par défaut pour votre jeu

Créez une version de test interne ou fermé dans la Play Console pour tester les versions préliminaires de votre jeu avec Sidekick et recueillir des commentaires ciblés. Notez que même si les tests dans un canal bêta fermé ne permettent pas de comparer directement les métriques de performances, ils restent une méthode valide pour les tests fonctionnels de base de votre intégration Sidekick.

Une fois que vous avez effectué le test auprès d'un groupe restreint de collaborateurs ou d'utilisateurs de confiance, vous pouvez l'étendre à un canal de test ouvert.

  1. Dans la Play Console, configurez une version de test interne ou fermé.
  2. Pour ajouter Play Games Sidekick à votre app bundle, sélectionnez Sidekick est activé par défaut.
  3. Effectuez vos tests.
  4. Une fois que vous êtes prêt, publiez la compilation en production. Pour en savoir plus, consultez Préparer une version par étapes.

Les joueurs peuvent gérer la visibilité de Sidekick à tout moment dans les paramètres utilisateur du Play Store.

Sidekick est activé par défaut
Ajoutez Play Games Sidekick à votre jeu.

Tester Sidekick en toute sécurité

Lorsque vous intégrez Sidekick, assurez-vous que la superposition s'intègre parfaitement à votre jeu, qu'elle offre une expérience de jeu cohérente et qu'elle n'a pas d'impact négatif sur les métriques clés telles que l'état du jeu (plantages/ANR), l'engagement et les revenus. Pour établir des performances de référence avant un lancement complet, utilisez un déploiement par étapes de 5 %.

Ce playbook de test vous permet d'exécuter une comparaison simultanée dans votre environnement de production, ce qui réduit les risques tout en vérifiant la réussite de votre intégration.

Le playbook de déploiement par étapes à 5 %

En déployant Sidekick auprès d'un petit segment contrôlé de votre audience, vous pouvez isoler son impact en suivant les métriques par rapport à la nouvelle version de votre jeu.

  • Préparez votre release : intégrez le SDK Sidekick à votre jeu et préparez une nouvelle version de release.
  • Lancer un déploiement par étapes : publiez votre nouvelle version sur le canal de production en utilisant un déploiement par étapes de 5 % dans la Google Play Console. Cela expose l'intégration de Sidekick à une petite partie de votre base de joueurs en temps réel.
  • Isoler par version de l'application : assurez-vous que vos outils d'analyse sont configurés pour filtrer les données spécifiquement pour la version de l'application contenant l'intégration Sidekick.

Surveiller les performances et les métriques

Pendant le déploiement par étapes à 5 %, surveillez les performances de votre jeu et assurez-vous que vos métriques principales restent stables en utilisant à la fois la Google Play Console et votre propre configuration d'analyse. Lorsque vous surveillez votre déploiement par étapes, concentrez-vous sur les points suivants :

  • Suivez l'engagement et la stabilité du jeu : utilisez la Google Play Console pour vous assurer que vos métriques Android Vitals (comme les taux de plantage et d'ANR) et d'engagement des joueurs restent stables pour la nouvelle version de l'application.
  • Suivez la régularité de vos revenus : surveillez de près vos revenus et vos métriques d'achats via l'application à l'aide de votre infrastructure d'analyse existante, comme Google Analytics ou vos outils internes de Business Intelligence (BI). Comparez la cohorte de 5 % qui a accès à Sidekick au reste de votre trafic de production pour vous assurer que votre monétisation principale reste stable.

Une fois que vous avez vérifié que Sidekick améliore vos revenus, l'engagement et la stabilité pendant le déploiement par étapes à 5 %, vous pouvez procéder en toute confiance à l'augmentation de votre version à 100 % de vos joueurs.

Gérer la visibilité de Sidekick sur votre appareil pour les tests

Une fois que la version est disponible pour vos testeurs dans la Play Console, suivez ces étapes pour activer les options pour les développeurs du Play Store sur l'appareil :

  1. Ouvrez l'application Google Play Store.
  2. Appuyez sur l'icône de votre profil, puis sur Paramètres.
  3. Appuyez sur le menu À propos.
  4. Appuyez sept fois sur Version du Play Store jusqu'à ce que le message You are now a developer! s'affiche. Les options pour les développeurs sont alors activées sur votre appareil.
  5. Appuyez sur Général, puis sur Options pour les développeurs.
  6. Activez l'Assistant Play Games.
  7. Accédez à votre jeu pour voir l'Assistant apparaître.
Bouton permettant d'activer Play Games Sidekick dans l'application Google Play Store.
Bouton permettant d'activer l'Assistant Play Games dans l'application Google Play Store (cliquez pour agrandir).

Configurer le point d'entrée Sidekick par défaut

Par défaut, le point d'entrée Sidekick est ancré au bord de fin logique (le côté MIDDLE_RIGHT de l'écran) et est centré verticalement (avec un léger décalage par défaut) en mode Portrait et Paysage. Dans le cas d'une navigation à trois boutons, le point d'entrée se déplace du côté opposé à la barre de navigation.

Vous pouvez remplacer la position par défaut du point d'entrée en spécifiant une position préférée dans un fichier de ressources XML référencé dans le fichier AndroidManifest.xml à l'aide des options suivantes :

  • Position exacte : spécifiez la position exacte du point d'entrée sous forme de pourcentage dans le fichier de ressources XML.
  • Position alignée sur les bords : spécifiez la position du point d'entrée aligné sur les bords dans le fichier de ressources XML.

Si un joueur fait glisser et repositionne manuellement le point d'entrée pendant le jeu, la position qu'il a choisie est conservée d'une session de jeu à l'autre et prévaut sur la configuration XML par défaut personnalisée.

Configurer la position exacte du point d'entrée

Pour configurer la position exacte du point d'entrée de l'Assistant dans votre jeu, procédez comme suit :

  1. Dans le fichier AndroidManifest.xml, ajoutez l'élément <meta-data> suivant à l'élément <application> :

    <manifest>
  <application>
   <meta-data
   android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
   android:resource="@xml/XML_RESOURCE_FILE"/>
  </application>
</manifest>

  2. Spécifiez l'emplacement du point d'entrée dans le XML_RESOURCE_FILE.

    Exemple de fichier (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>

La balise <default-entrypoint-position> accepte les attributs suivants :

  • orientation : orientation de l'écran à configurer. Valeurs acceptées :
    • landscape
    • portrait
  • horizontal-position : bord horizontal de l'écran auquel ancrer le point d'entrée. Valeurs acceptées :
    • LEFT
    • RIGHT

  • vertical-position-percent : valeur numérique comprise entre 0 et 100 (par exemple, "25" ou "50") qui spécifie l'emplacement vertical en pourcentage de la hauteur de la fenêtre de jeu à partir du haut. Par exemple, "25" place le point d'entrée à 25 % du bord supérieur, et "50" le centre verticalement. Les valeurs qui ne sont pas comprises entre 0 et 100 sont définies sur la limite la plus proche.

    Le point d'entrée conserve toujours une petite marge par rapport aux bords supérieur et inférieur de l'écran. Il est automatiquement décalé pour éviter de chevaucher une découpe de l'appareil photo ou une encoche de l'écran. Par conséquent, 0 place le point d'entrée près du bord supérieur et 100 le place près du bord inférieur.

Ces valeurs représentent des positions physiques sur l'écran. Par exemple, LEFT ancre le point d'entrée sur le bord gauche de l'écran, même lorsque l'appareil est configuré pour une mise en page de droite à gauche (RTL).

Règles de remplacement et de priorité

Pour configurer une position exacte, spécifiez les attributs orientation, horizontal-position et vertical-position-percent sur la balise <default-entrypoint-position> :

  • Si horizontal-position et vertical-position-percent sont tous deux valides, ils sont prioritaires sur l'attribut value de la même balise.
  • Si les attributs horizontal-position ou vertical-position-percent sont manquants ou non valides, le point d'entrée utilise l'attribut value s'il est présent.
  • Si l'attribut value est également manquant ou non valide, le point d'entrée revient à la position par défaut.

Configurer la position du point d'entrée aligné sur le bord

Pour configurer la position du point d'entrée de l'Assistant aligné sur le bord pour votre jeu, procédez comme suit :

  1. Dans le fichier AndroidManifest.xml, ajoutez l'élément <meta-data> suivant à l'élément <application> :

    <manifest>
 <application>
  <meta-data
  android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
  android:resource="@xml/XML_RESOURCE_FILE"/>
 </application>

</manifest>

  2. Spécifiez l'emplacement du point d'entrée dans le XML_RESOURCE_FILE.

    Exemple de fichier (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>

Valeurs acceptées pour le point d'entrée orientation :

  • landscape
  • portrait

L'attribut value représente les positions physiques sur l'écran. Par exemple, MIDDLE_LEFT ancrera toujours le point d'entrée sur le bord gauche de l'écran, même si l'appareil est configuré pour une mise en page de droite à gauche (RTL). Les valeurs acceptées pour les positions de point d'entrée alignées sur les bords sont les suivantes :

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

Configurer la durée de report du point d'entrée lors de la première utilisation

Par défaut, le point d'entrée de Play Games Sidekick s'affiche immédiatement. Vous pouvez répéter le point d'entrée dans le jeu pendant une durée personnalisée configurée dans XML_RESOURCE_FILE.

Lorsqu'une durée de report est définie, le point d'entrée Sidekick est masqué pendant la première expérience utilisateur (FTUE) pour la durée configurée. Une fois la durée de report écoulée, le point d'entrée s'affiche.

  1. Dans le fichier AndroidManifest.xml, ajoutez l'élément <meta-data> suivant à l'élément <application> :

    <manifest>
 <application>
  <meta-data
  android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
  android:resource="@xml/XML_RESOURCE_FILE"/>
 </application>

</manifest>

  2. Spécifiez la durée de la mise en veille dans XML_RESOURCE_FILE.

    Exemple de fichier (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>

La durée de répétition personnalisée est limitée à 30 minutes. Si vous spécifiez une valeur qui dépasse ce seuil, le système utilise automatiquement la limite de 30 minutes par défaut.

Ajouter automatiquement l'assistant à tous les bundles importés

Lorsque vous créez une version et que vous activez Sidekick par défaut pour votre jeu, Sidekick est ajouté à tous vos futurs app bundles.

Pour modifier l'activation par défaut de Sidekick pour tous les nouveaux app bundles que vous importez, procédez comme suit :

  1. Ouvrez la Play Console.
  2. Sélectionnez un jeu.
  3. Accédez à Tests > Paramètres avancés.
  4. Dans l'onglet Assistant Play Games, sélectionnez l'une des options suivantes :
    • Activer automatiquement Sidekick par défaut pour les nouveaux app bundles que vous importez.
    • Ne pas activer automatiquement Sidekick par défaut pour les nouveaux app bundles que vous importez.
  5. Sélectionnez Enregistrer les modifications.

Si vous ne mettez pas souvent à jour votre application, nous pouvons mettre à jour Sidekick pour vous de manière périodique. Vous pouvez désactiver Sidekick à tout moment dans les paramètres avancés de la Google Play Console.

Promouvoir l'assistant en production

Si vous mettez en production une version intégrant l'Assistant, les joueurs le verront. Les joueurs peuvent gérer la visibilité de Sidekick à tout moment dans les paramètres utilisateur de l'application Play Store.

Les jeux qui font la promotion d'une sortie avec l'Assistant respectent les Consignes Level Up.

Questions fréquentes

Pouvez-vous ajouter Sidekick à votre jeu à l'aide de l'API Publishing ?

Vous pouvez ajouter Sidekick à votre jeu même si vous le publiez à l'aide de l'API Google Play Developer Publishing. Tout d'abord, ajoutez automatiquement Sidekick à tous les app bundles importés, puis poursuivez votre processus de publication normal. Sidekick sera ajouté à votre Android App Bundle.

Mon jeu n'utilise pas le format Android App Bundle (AAB). Que dois-je faire ?

Sidekick est ajouté aux jeux lorsque vous importez un nouvel Android App Bundle.

Si vous utilisez des APK, ajoutez le SDK Sidekick en tant que dépendance.

Mon jeu utilise un produit anti-falsification. L'assistant est-il compatible avec ma solution ?

Nous avons collaboré avec des entreprises de premier plan pour assurer la compatibilité de l'assistant Google Play Games.

Si vous utilisez un produit anti-falsification non compatible, ajoutez le SDK Sidekick en tant que dépendance à votre APK. Si vous avez d'autres questions, demandez de l'aide.

Pourquoi les succès n'apparaissent-ils pas dans Sidekick ?

Si les réussites ne s'affichent pas comme prévu, vérifiez les points suivants :

  • État "Brouillon" : les réussites à l'état "Brouillon" ne sont pas affichées dans Sidekick.
  • Badge de réussite : les succès verrouillés ne sont visibles par tous les joueurs que si le jeu a obtenu un badge de réussite. Pour cela, au moins 100 joueurs uniques doivent avoir effectué des appels à l'API Achievements au cours des 30 derniers jours.
  • Débloqués : si le jeu n'a pas obtenu de badge, les joueurs voient les succès qu'ils ont déjà débloqués.