Inicio rápido para configurar una ubicación de anuncios con recompensa de PlayFab en Game Manager, configurar recompensas e integrar anuncios de vídeo en el cliente del juego.
Inicio rápido: Configurar una ubicación de anuncios
Los anuncios con recompensa son una forma de incentivar a tus jugadores a ver anuncios de vídeo a cambio de una recompensa. Cada anuncio con sus recompensas asociadas se considera una ubicación de anuncios. En este inicio rápido configurarás una ubicación de anuncios y sus recompensas.
En la pestaña Rewarded Ads, lo primero que verás es el panel principal de tus anuncios. Aquí encontrarás los KPI básicos de tus anuncios, junto con un gráfico que muestra tus eventos de anuncios recientes (también aparecen en PlayStream). En la parte superior, selecciona Placements.Las ubicaciones de anuncios son la parte más fundamental del sistema. Piensa en una ubicación individual como una “posición de anuncio”: el tipo de anuncio que se mostrará (banner, vídeo, etc.) y en qué momento del juego lo verá el jugador (interstitial entre niveles, como resultado de hacer clic en un botón “muéstrame un anuncio”, etc.).En la esquina superior derecha, selecciona New Ad Placement. Asigna a la ubicación el nombre que quieras e introduce el identificador de aplicación y el tipo de unidad publicitaria de tu proveedor de anuncios. Si no estás seguro de dónde encontrar el identificador de aplicación y el tipo de unidad publicitaria de tu proveedor específico, háznoslo saber y podemos ayudarte a identificarlos.
Ahora tendrás que agregar tus recompensas específicas. Para cada posible recompensa de esta ubicación, selecciona New Reward. Da un nombre a la recompensa e introduce el texto de descripción y la dirección URL del paquete de recursos que quieras que se devuelvan al cliente cuando se otorgue la recompensa específica. A continuación, en Actions, selecciona Add Action. Al igual que con las acciones normales de PlayStream, puedes realizar varias acciones diferentes en este momento: ejecutar un controlador de Cloud Script, otorgar objetos, etc. Normalmente, aquí otorgarás moneda virtual u objetos, pero si quieres usar los otros tipos de acción, todo se procesará de la misma manera que en un desencadenador de acciones de PlayStream normal.Después de definir un par de recompensas, asigna a cada una un peso para configurar la distribución aleatoria. Si has definido segmentos para tu título, también puedes establecer invalidaciones en la herramienta Segment Assignment situada debajo de Rewards. Por ejemplo, si hay un determinado grupo de jugadores que quieres que reciba siempre una recompensa específica, asigna esa recompensa a ese segmento en la lista de asignación. Las asignaciones de segmentos siguen un orden de prioridad, por lo que se usa el primer segmento que coincida con el jugador actual. El siguiente ejemplo define una ubicación de anuncios que proporciona gemas gratis el 0 % de las veces, puntos de experiencia adicionales el 30 % de las veces y un objeto “llave” el 70 % de las veces.En el ejemplo usamos Segment Assignment para proporcionar recompensas en orden de prioridad. Si el jugador pertenece al grupo “High XP Players”, se realiza la selección aleatoria normal. Pero si el jugador está en el segmento “VIP players”, le otorgamos la recompensa de “gemas”.
Considera la posibilidad de crear un segmento para los jugadores que ven un anuncio por primera vez y otorgarles una de tus recompensas más deseables. Esto puede ayudar a incentivar a tus jugadores a seguir interactuando con los anuncios con recompensa y aumentar la tasa de retención general.
Por último, tienes la opción de limitar el número de veces que el jugador puede recibir una recompensa por un anuncio. En nuestro ejemplo, lo limitamos a 4 veces al día por jugador (los restablecimientos diarios de este contador se producen a las 00:00 UTC). Puedes hacer que el límite se restablezca cada día, cada hora o cada dos horas.
Después de definir al menos una ubicación de anuncios, puedes consultar la lista de ubicaciones disponibles mediante Client/GetAdPlacements. Especifica un identificador en la llamada para asegurarte de obtener información solo de la ubicación indicada. Para filtrar por una ubicación específica, puedes usar el nombre que definiste para ella (arriba) o el identificador único generado por PlayFab para la ubicación (que puedes ver en la dirección URL, en el ejemplo anterior). De lo contrario, se devuelven en un objeto AdPlacementDetails todas las ubicaciones disponibles para las que el jugador tiene una recompensa válida, incluida la recompensa para el jugador, el número de visualizaciones restantes y el tiempo hasta el restablecimiento del límite de visualizaciones.
Cuando hayas seleccionado una ubicación de anuncios en el código del cliente, asegúrate de guardar PlacementId y RewardId. Los usarás en las dos etapas siguientes.
Definimos cuatro estados de actividad para un anuncio: “Opened”, “Closed”, “Start” y “End”. Cuando uses los anuncios con recompensa, asegúrate de llamar a Client/ReportAdActivityRequest para actualizar el estado de actividad cada vez que tu SDK de anuncios notifique un cambio de estado.
Cuando tu SDK de anuncios notifique que la visualización del anuncio se ha completado correctamente, llama a Client/RewardAdActivity para desencadenar la recompensa. Esta llamada requiere los valores PlacementId y RewardId devueltos por Client/GetAdPlacements. Primero comprueba que la recompensa sea válida y, a continuación, la procesa para el jugador. Los objetos se otorgan inmediatamente y la llamada devuelve después un conjunto completo de los cambios realizados en el jugador por las acciones Grant Item, Grant Virtual Currency e Increment Player Statistic.Por último, es importante tener en cuenta que el identificador de recompensa no queda vinculado al jugador como parte de la llamada a GetAdPlacements. Según los pesos que hayas proporcionado, llamar a GetAdPlacements varias veces puede hacer que la recompensa cambie. La llamada a RewardAdActivity solo requiere que la recompensa sea válida para el jugador, no que sea la última devuelta por GetAdPlacements.
