Ayudante de Google Play Juegos

Play Games Sidekick es una superposición que ayuda a los jugadores a permanecer en tu juego, ya que les ofrece contenido y ofertas pertinentes directamente.

• Mantén a los jugadores en tu juego con videos oficiales y de creadores para que puedan encontrar guías, tutoriales y transmisiones en vivo sin cambiar de app.
• Aumento de la monetización con el intercambio de puntos en el momento, las ofertas financiadas por Play y los cupones de Pass
• Juego recompensado con rachas, misiones e interacciones de perfil integradas
• Mayor interacción con el contenido y los videos

Funciones

Las funciones disponibles en Sidekick variarán según el juego, el estado de integración de los Servicios de Google Play Games y la inscripción en Play Points. Los jugadores pueden esperar las siguientes funciones:

• Utilidades de videojuegos: Captura de pantalla, grabación de pantalla, transmisión en vivo de YouTube y No interrumpir.
• Logros: Requiere la implementación de logros.
• Rachas de juegos: Rachas de juegos.
• Intercambio de crédito de Play Points:
• Potenciadores y cupones de Play Points: Están disponibles para los desarrolladores inscritos en Play Points.
• Beneficios y ofertas de Play Pass.
• Quests: Las Quests están disponibles para los desarrolladores inscritos en Quests.
• Videos oficiales y de creadores: Sidekick muestra los videos que agregas. Para obtener más información sobre cómo agregar videos en Play Store y Sidekick, consulta Muestra tu app con videos de YouTube en Google Play.

Requisitos de software y hardware

Para acceder a Sidekick, los jugadores necesitan lo siguiente:

• Un teléfono celular con Android 13 o versiones posteriores

• Los jugadores deben tener un perfil de gamer.
• El juego debe instalarse desde Play Store.

Prueba Sidekick

Para habilitar el Ayudante en tu juego, sigue estos pasos:

Activa Sidekick de forma predeterminada en tu juego

Crea un lanzamiento de prueba interna o cerrada en Play Console para probar las versiones previas al lanzamiento de tu juego con Sidekick y recopilar comentarios específicos. Ten en cuenta que, si bien las pruebas en un segmento de versión beta cerrada no ofrecen una comparación directa para las métricas de rendimiento, siguen siendo un método válido para realizar pruebas funcionales básicas de tu integración de Sidekick.

Después de realizar las evaluaciones con un grupo reducido de colegas o usuarios de confianza, puedes expandir la prueba a una versión abierta.

1. En Play Console, configura un lanzamiento de pruebas internas o cerradas.
2. Para agregar Play Games Sidekick a tu paquete de aplicación, selecciona Play Games Sidekick está activado de forma predeterminada.
3. Realiza las pruebas.
4. Cuando esté todo listo, lanza la compilación a producción. Para obtener más información, consulta Cómo preparar una versión en fases.

Los jugadores pueden administrar la visibilidad de Sidekick en cualquier momento a través de la configuración de usuario en Play Store.

Cómo probar Sidekick de forma segura

Cuando integres Sidekick, asegúrate de que la superposición se integre sin problemas en tu juego, mantenga una experiencia del jugador coherente y no afecte negativamente las métricas clave, como el estado del juego (fallas/ANR), la interacción y los ingresos. Para establecer una base de referencia del rendimiento antes del lanzamiento completo, usa un lanzamiento en etapas del 5%.

Esta guía de pruebas te permite ejecutar una comparación simultánea en tu entorno de producción, lo que minimiza el riesgo y verifica el éxito de tu integración.

La guía del lanzamiento en etapas del 5%

Si lanzas Sidekick para un segmento pequeño y controlado de tu público, puedes aislar su impacto haciendo un seguimiento de las métricas en comparación con la nueva versión del juego.

• Prepara tu lanzamiento: Integra el SDK de Sidekick en tu juego y prepara una nueva compilación de lanzamiento.
• Inicia un lanzamiento en etapas: Publica tu nueva compilación en el segmento de producción con un lanzamiento en etapas del 5% en Google Play Console. Esto expone la integración de Sidekick a una pequeña fracción de tu base de jugadores en tiempo real.
• Aísla por versión de la app: Asegúrate de que tus herramientas de estadísticas estén configuradas para filtrar los datos específicamente para la versión de la app que contiene la integración de Sidekick.

Supervisa el rendimiento y las métricas

Durante el lanzamiento en etapas del 5%, supervisa el rendimiento de tu juego y asegúrate de que tus métricas principales se mantengan estables. Para ello, usa una combinación de Google Play Console y tu propia configuración de estadísticas. Cuando supervises tu lanzamiento en etapas, enfócate en lo siguiente:

• Haz un seguimiento de la interacción y la estabilidad del juego: Usa Google Play Console para asegurarte de que tus métricas de Android vitals (como las tasas de fallas y los errores de ANR) y las métricas de participación de los jugadores se mantengan estables para la nueva versión de la app.
• Realiza un seguimiento de la coherencia de los ingresos: Supervisa de cerca tus métricas de ingresos y de IAP con tu infraestructura de análisis existente, como Google Analytics o tus herramientas internas de inteligencia empresarial (IE). Compara el cohorte del 5% que tiene acceso a Sidekick con el resto de tu tráfico de producción para asegurarte de que tu monetización principal se mantenga estable.

Una vez que verifiques que Sidekick complementa con éxito tus ingresos, interacción y estabilidad durante el lanzamiento en etapas del 5%, podrás aumentar con confianza el lanzamiento al 100% de tus jugadores.

Administra la visibilidad de Sidekick en tu dispositivo para realizar pruebas

Una vez que la versión esté disponible para los verificadores en Play Console, sigue estos pasos para habilitar las opciones para desarrolladores de Play Store en el dispositivo:

1. Abre la aplicación Google Play Store.
2. Presiona el ícono de tu perfil y, luego, Configuración.
3. Presiona el menú Acerca de.
4. Presiona la versión de Play Store 7 veces hasta que veas el mensaje You are now a developer!. Esto habilita las opciones para desarrolladores en tu dispositivo.
5. Presiona General y, luego, Opciones para desarrolladores.
6. Activa Play Games Sidekick.
7. Ve a tu juego para ver cómo aparece Sidekick.

Configura el punto de entrada predeterminado de Sidekick

De forma predeterminada, el punto de entrada de Sidekick se fija al borde lógico final (el lado derecho de la pantalla) y se centra verticalmente (con un ligero desplazamiento predeterminado) en las orientaciones vertical y horizontal. En el caso de la navegación con 3 botones, el punto de entrada se mueve al lado opuesto de la barra de navegación.

Puedes anular la posición predeterminada del punto de entrada si especificas una posición preferida en el archivo AndroidManifest.xml.

Para configurar la posición predeterminada del punto de entrada de Sidekick en tu juego, sigue estos pasos:

1. En el archivo AndroidManifest.xml, agrega el siguiente elemento <meta-data> al elemento <application>:

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

2. Especifica la ubicación del punto de entrada en XML_RESOURCE_FILE.

   Archivo de ejemplo (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 etiqueta <default-entrypoint-position> admite los siguientes atributos. Los tres atributos (orientation, horizontal-position y vertical-position-percent) son obligatorios para cada etiqueta <default-entrypoint-position>. Si se omite o no es válido horizontal-position o vertical-position-percent, se ignorará la etiqueta y esa orientación volverá a la posición predeterminada del sistema.

• orientation: Es la orientación de la pantalla que se configurará. Valores admitidos:
  • landscape
  • portrait
• horizontal-position: Es el borde horizontal de la pantalla al que se anclará el punto de entrada. Valores admitidos:
  • LEFT
  • RIGHT

• vertical-position-percent: Es un valor numérico en el rango de 0 a 100 (por ejemplo, "25" o "50") que especifica la ubicación vertical como un porcentaje de la altura de pantalla disponible desde la parte superior. Por ejemplo, "25" coloca el punto de entrada un 25% hacia abajo desde el borde superior, y "50" lo centra verticalmente. Los valores que no se encuentran en el rango de 0 a 100 se establecen en el límite más cercano.

  vertical-position-percent se aplica a la altura completa de la ventana del juego. El punto de entrada siempre mantiene un pequeño margen desde los bordes superior e inferior de la pantalla, y se desplaza automáticamente para evitar superponerse con un corte de cámara o una muesca de pantalla. Como resultado, 0 coloca el punto de entrada cerca del borde superior y 100 lo coloca cerca del borde inferior.

Estos valores representan posiciones físicas en la pantalla. Por ejemplo, LEFT fija el punto de entrada al borde izquierdo de la pantalla, incluso cuando el dispositivo está configurado en un diseño de derecha a izquierda (RTL).

Si un jugador arrastra y reposiciona manualmente el punto de entrada durante el juego, la posición que elija persistirá en las sesiones de juego y tendrá prioridad sobre la configuración XML predeterminada personalizada.

Configura la duración de la postergación del punto de entrada durante la FTUE

De forma predeterminada, el punto de entrada de Play Games Sidekick se muestra de inmediato. Puedes posponer el punto de entrada en el juego durante un período personalizado configurado en XML_RESOURCE_FILE.

Cuando se establece una duración de posponer, el punto de entrada de Sidekick se oculta durante la experiencia del usuario por primera vez (FTUE) durante el tiempo configurado. Una vez que finaliza el período de posposición, aparece el punto de entrada.

1. En el archivo AndroidManifest.xml, agrega el siguiente elemento <meta-data> al elemento <application>:

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

2. Especifica la duración del aplazamiento en XML_RESOURCE_FILE.

   Archivo de ejemplo (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>

La duración personalizada de la función Posponer tiene un límite de 30 minutos. Si especificas un valor que supera este umbral, el sistema automáticamente usará el límite de 30 minutos.

Agregar Sidekick automáticamente a todas las cargas de paquetes

Cuando creas una versión y activas Sidekick de forma predeterminada para tu juego, Sidekick se agrega a todos tus futuros paquetes de aplicación.

Para cambiar si Sidekick está activado de forma predeterminada para todos los paquetes de aplicación nuevos que subas, sigue estos pasos:

1. Abre Play Console.
2. Selecciona un juego.
3. Ve a Pruebas > Configuración avanzada.
4. En la pestaña Play Games Sidekick, selecciona una de las siguientes opciones:
   • Sidekick se activa automáticamente de forma predeterminada para los paquetes de aplicación nuevos que subas.
   • No activar Sidekick automáticamente como opción predeterminada para los paquetes de aplicación nuevos que subas
5. Selecciona Guardar cambios.

Si las actualizaciones de tu app son poco frecuentes, es posible que actualicemos Sidekick periódicamente por ti. Puedes inhabilitar Sidekick en cualquier momento a través de la configuración avanzada de Google Play Console.

Promueve Sidekick a producción

Si promueves a producción una versión que contiene Sidekick, los jugadores verán Sidekick. Los jugadores pueden administrar la visibilidad de Sidekick en cualquier momento a través de la configuración de usuario en la app de Play Store.

Los juegos que promocionan un lanzamiento con Sidekick satisfacen los lineamientos de Level Up.

Enviar comentarios

Si tienes comentarios sobre Sidekick, usa el formulario de comentarios.

Preguntas frecuentes