Eventos de economía

Eventos de economía te permiten rastrear la economía dentro de tu juego, tales como:

• Principales sumideros — ¿En qué gastan los usuarios los recursos del juego?
• Principales fuentes — ¿Dónde ganan los usuarios recursos?
• Saldo promedio de billetera — ¿Cuántos recursos están reteniendo los usuarios?

Una vez que tu juego comience a rastrear eventos de economía, desbloquearás la página de Economía del panel de análisis en el Creator Hub.

Rastrear eventos de economía

Para desbloquear el panel de Economía, necesitas rastrear algunos eventos de economía en tu juego. Comienza identificando dónde los usuarios fuente (es decir, ganan) y sumidero (es decir, gastan) recursos en tu juego. Estos se representan en el código mediante Enum.AnalyticsEconomyFlowType, que puede ser Source o Sink.

Tipos de transacción

Cada evento de fuente y sumidero requiere un tipo de transacción, codificado con Enum.AnalyticsEconomyTransactionType. Por defecto, las opciones son:

• IAP (fuente) - Compras dentro de la aplicación que intercambian Robux por recursos, por ejemplo, paquete inicial.
• TimedReward (fuente) - Gana recursos en un horario, por ejemplo, bonificación diaria.
• Onboarding (fuente) - Obtén recursos al comenzar, por ejemplo, bonificación de bienvenida.
• Shop (fuente o sumidero) - Intercambia recursos en la tienda, por ejemplo, compra de un artículo.
• Gameplay (fuente o sumidero) - Gana o gasta recursos del juego, por ejemplo, finalización de una misión.
• ContextualPurchase (sumidero) - Gasta recursos en un impulso específico del contexto, por ejemplo, vidas extra.

Estos tipos aparecen en el panel. Es una buena idea comenzar con las categorías predeterminadas, pero si lo necesitas, también puedes proporcionar tus propios nombres de tipo de transacción al registrar un evento.

Rastrear fuentes

El siguiente ejemplo utiliza AnalyticsService.LogEconomyEvent para registrar dos eventos de economía diferentes cuando los usuarios completan el primer y segundo niveles en el juego y ganan algunas monedas.

local AnalyticsService = game:GetService("AnalyticsService")

-- Después de completar el nivel 1
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins", -- Nombre de la moneda
    50, -- Cantidad ganada
    50, -- Saldo actual
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- Tipo de transacción
)

-- Después de completar el nivel 2
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins", -- Nombre de la moneda
    50, -- Cantidad ganada
    100, -- Saldo después de la transacción
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- Tipo de transacción
)

El siguiente ejemplo rastrea una compra de Robux de un paquete de 1000 monedas, utilizando el tipo de transacción IAP (compra dentro de la aplicación), esta vez con un itemSKU, tu identificador único para el artículo. itemSKU es opcional. Si no lo especificas, los paneles de Economía mostrarán N/A en la tabla de fuentes y sumideros.

local AnalyticsService = game:GetService("AnalyticsService")

AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins",
    1000, -- Cuántas monedas hay en el paquete
    1020, -- Saldo después de la transacción
    Enum.AnalyticsEconomyTransactionType.IAP.Name,
    "1000CoinBundle" -- Identificador único SKU del paquete de monedas
)

En este ejemplo, si tienes muchos paquetes de monedas, también podrías querer agregar un campo personalizado para rastrear la categoría del paquete de monedas en comparación con otras categorías.

Rastrear sumideros

El siguiente ejemplo registra un evento cuando los usuarios gastan monedas para comprar un DoubleJumpUpgrade. Nota el tipo de flujo Sink y el tipo de transacción Shop en comparación con los ejemplos de rastreo de fuentes.

Ten en cuenta que la cantidad (costo) siempre debe ser un número positivo, independientemente de si el evento es una fuente o un sumidero. Los gráficos del panel de economía mostrarán automáticamente los sumideros como números negativos.

local AnalyticsService = game:GetService("AnalyticsService")

-- Después de completar el nivel 2
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Sink,
    "Coins", -- Nombre de la moneda
    80, -- Costo
    20, -- Saldo después de la transacción
    Enum.AnalyticsEconomyTransactionType.Shop.Name,
    "DoubleJumpUpgrade" -- SKU del artículo
)

Para información sobre las limitaciones de AnalyticsService, consulta Limitaciones de rastreo de eventos.

Usar campos personalizados

Los eventos de economía también permiten desglosar en campos personalizados para facilitar la comparación entre segmentos. Por ejemplo, puedes proporcionar nombres de misiones a cada evento para ver cuáles son las que más dinero generan para los usuarios, o adjuntar ubicaciones de tiendas para ver si los usuarios prefieren una ubicación sobre otra.

Puedes desglosar por campos personalizados utilizando el selector de desglose.

Para más información, consulta Campos personalizados.

Usar la economía para hacer crecer tu juego

El panel de Economía incluye cinco gráficos para ayudarte a tomar medidas para aumentar tus ingresos. Puedes agregar hasta cinco monedas de recursos, y todos los gráficos se pueden filtrar por varias categorías de usuarios (género, edad, plataforma, etc.) y hasta tres campos personalizados específicos de tu juego.

• Total de fuentes y sumideros por categoría - Usa este gráfico para equilibrar la economía de tu juego. El total de fuentes menos el total de sumideros debería estar cerca de cero. También puedes ver tus principales fuentes y sumideros por categoría. Si tu total neto está creciendo, considera agregar más sumideros.

  

• Saldo promedio de billetera - Usa este gráfico para ver cuántos recursos tienen los usuarios, pagadores y no pagadores en promedio. Si el saldo promedio está creciendo, especialmente para los pagadores, considera agregar nuevos sumideros.

  

• Principales fuentes y sumideros - Usa esto para identificar dónde tus usuarios ganan y gastan sus recursos. Si los usuarios no están obteniendo recursos de compras dentro de la aplicación, considera reducir precios u ofrecer nuevas opciones. Si los usuarios no están gastando suficientes de un recurso dado, considera agregar nuevos sumideros para ese recurso.

  

• Todas las fuentes y sumideros - Usa esto para obtener una vista combinada por categoría para el rango de fechas seleccionado.

  

Para más consejos sobre cómo equilibrar la economía dentro de tu experiencia, consulta Equilibrar economías virtuales.