AnalyticsService
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
AnalyticsService es una colección de métodos que permite a los desarrolladores rastrear cómo interactúan los usuarios con sus experiencias, específicamente el progreso de los jugadores, la economía en la experiencia, los embudos y los eventos personalizados.
Resumen
Métodos
Registra un evento que se utiliza para rastrear métricas personalizadas de un usuario en la experiencia.
- LogEconomyEvent(player : Player,flowType : Enum.AnalyticsEconomyFlowType,currencyType : string,amount : number,endingBalance : number,transactionType : string,itemSku : string,customFields : Dictionary):()
Registra un evento que se utiliza para rastrear las acciones del jugador relacionadas con la experiencia.
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):()
Registra un evento que se utiliza para rastrear las acciones del usuario que pasan por un embudo predeterminado.
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):()
Registra un evento que se utiliza para rastrear las acciones del usuario al pasar por un embudo de capacitación.
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Registra un evento para cuando un usuario haya completado un intento de nivel.
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):()
Registra un evento para cuando un usuario haya comenzado, completado o fallado un intento de nivel.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Registra un evento para cuando un usuario haya fallado en un intento de nivel.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Registra un evento para cuando un usuario haya comenzado un intento de nivel.
Propiedades
Métodos
LogCustomEvent
Registra un evento utilizado para rastrear métricas personalizadas de un usuario en la experiencia. Para obtener información adicional, consulte Eventos personalizados.
Parámetros
El usuario que activó el evento.
El nombre del evento personalizado.
El valor del evento que se usará en la agregación.
Diccionario opcional de campos personalizados que proporcionará desagregaciones en gráficos proporcionados por Roblox.Solo se usarán claves específicas, proporcionadas por Enum.AnalyticsCustomFieldKeys, para estas descomposiciones.Limitado a 8,000 combinaciones únicas de valores en los tres campos personalizados por experiencia.
Devuelve
Muestras de código
This example uses AnalyticsService:LogCustomEvent() to log two custom events: MissionStarted and MissionCompletedDuration.
local AnalyticsService = game:GetService("AnalyticsService")
-- Log when the mission starts
AnalyticsService:LogCustomEvent(
player,
"MissionStarted" -- Custom event name
)
-- Log when the mission is completed with the time it took
AnalyticsService:LogCustomEvent(
player,
"MissionCompletedDuration", -- Custom event name
120 -- Event value used in aggregation
)LogEconomyEvent
Registra un evento que se utiliza para rastrear las acciones del jugador relacionadas con la experiencia.
Parámetros
El usuario que activó el evento.
Debe especificar la dirección en la que fluye la moneda usando Enum.AnalyticsEconomyFlowType .
El nombre de la moneda que se agrega o elimina, por ejemplo "gold" , "gems" , o "energy" .Limitado a 5 tipos de moneda únicos por experiencia.
La cantidad de moneda que se agrega o elimina. Este valor siempre debe ser positivo.
El saldo del usuario después de que se haya agregado o eliminado la moneda. Este valor siempre debe ser mayor o igual a 0.
El tipo de transacción que ocurrió.Aunque usted es libre de usar cualquier tipo de transacción, se recomienda usar los tipos proporcionados de Enum.AnalyticsEconomyTransactionType como "IAP" o "ContextualPurchase" para habilitar futuras inspecciones de herramientas y tablas de Roblox.
Debido a que este tipo de campo es una cadena, necesitarás pasar el valor Name de la enumeración. Por ejemplo, Enum.AnalyticsEconomyTransactionType.IAP.Name.
Limitado a 20 tipos únicos por experiencia.
SKU opcional del artículo o paquete que se está comprando.Este es un identificador único del artículo que se está comprando.Limitado a 100 SKUs únicos por experiencia.
Diccionario opcional de campos personalizados que proporcionará desagregaciones en gráficos proporcionados por Roblox.Solo se usarán claves específicas, proporcionadas por Enum.AnalyticsCustomFieldKeys, para estas descomposiciones.Limitado a 8,000 combinaciones únicas de valores en los tres campos personalizados por experiencia.
Devuelve
Muestras de código
La siguiente muestra rastrea una compra de Robux de un paquete de 1000 monedas, usando el tipo de transacción de compra en la aplicación.Tenga en cuenta el nombre del artículo proporcionado como parámetro opcional en comparación con la muestra anterior.
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- Cuántas monedas hay en el paquete
1020, -- balanza después de la transacción
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- Identificación única del paquete de monedas
)LogFunnelStepEvent
Registra un evento que se utiliza para rastrear las acciones del usuario que pasan por un embudo predeterminado.Las descomposiciones de embudo solo considerarán los valores de usuario y evento del primer paso en una sesión de embudo.
Parámetros
El usuario que activó el evento.
El nombre del embudo. Esto debe ser el mismo para todos los pasos en el embudo. Limitado a 10 embudos únicos por experiencia.
Identificador único opcional para la sesión del embudo. Esto debe ser igual para todos los pasos en el embudo.
Tenga en cuenta que este campo solo es necesario para funnels recurrentes , por ejemplo, un flujo de compra o un flujo de actualización de artículos.Si no tienes un identificador de sesión de embudo natural, se recomienda usar HttpService:GenerateGUID() .
El número de paso en el embudo. Esto debe ser único para cada paso en el embudo. Todos los embudos comienzan en el paso 1. Limitado a pasos 1-100.
Pasos repetidos por el mismo usuario en la misma sesión de embudo, o cuando funnelSessionId no se ignorará cuando nil sea.
Tenga en cuenta que si se omiten algunos pasos, los pasos intermedios se considerarán completados.
Nombre opcional del paso en el embudo. Este campo solo se usa con fines de visualización en las tablas proporcionadas por Roblox.
Diccionario opcional de campos personalizados que proporcionará desagregaciones en gráficos proporcionados por Roblox.Solo se usarán claves específicas, proporcionadas por Enum.AnalyticsCustomFieldKeys, para estas descomposiciones.Limitado a 8,000 combinaciones únicas de valores en los tres campos personalizados por experiencia.
Devuelve
Muestras de código
La siguiente muestra rastrea algunos eventos básicos para cada usuario que comienza el proceso de comprar un artículo de una tienda de "armas".Observe el funnelSessionId utilizado para distinguir entre diferentes sesiones del mismo usuario que abre la tienda.
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- Registrar cuando el usuario abre la tienda
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Nombre del embudo utilizado para agrupar pasos juntos
funnelSessionId, -- ID de sesión de embudo para esta sesión de pago única
1, -- Número de paso
"Opened Store" -- Nombre del paso
)
-- Registrar cuando el usuario ve un artículo
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Nombre del embudo utilizado para agrupar pasos juntos
funnelSessionId, -- ID de sesión de embudo para esta sesión de pago única
2, -- Número de paso
"Viewed Item" -- Nombre del paso
)
-- Registrar cuando el usuario ve añade al carrito
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Nombre del embudo utilizado para agrupar pasos juntos
funnelSessionId, -- ID de sesión de embudo para esta sesión de pago única
3, -- Número de paso
"Added to Cart" -- Nombre del paso
)LogOnboardingFunnelStepEvent
Registra un evento que se utiliza para rastrear las acciones del usuario al pasar por un embudo de capacitación.Las descomposiciones de embudo solo considerarán los valores de usuario y evento del primer paso en una sesión de embudo.
Parámetros
El usuario que activó el evento.
El número de paso en el embudo. Esto debe ser único para cada paso en el embudo. Todos los embudos comienzan en el paso 1. Limitado a pasos 1-100.
Tenga en cuenta que si se omiten algunos pasos, los pasos intermedios se considerarán completados.
Nombre opcional del paso en el embudo. Este campo solo se usa con fines de visualización en las tablas proporcionadas por Roblox.
Diccionario opcional de campos personalizados que proporcionará desagregaciones en gráficos proporcionados por Roblox.Solo se usarán claves específicas, proporcionadas por Enum.AnalyticsCustomFieldKeys, para estas descomposiciones.Limitado a 8,000 combinaciones únicas de valores en los tres campos personalizados por experiencia.
Devuelve
Muestras de código
El siguiente ejemplo muestra cómo registrar dos pasos de un embudo de integración.Un embudo de integración suele presentar a los jugadores al bucle principal del juego.
local AnalyticsService = game:GetService("AnalyticsService")
-- Registre el primer paso del FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- Número de paso
"Joined Game" -- Nombre del paso
)
-- Registre el segundo paso del FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- Número de paso
"Choose Class" -- Nombre del paso
)LogProgressionCompleteEvent
Registra un evento para cuando un usuario haya completado un intento de nivel. Este evento no se muestra actualmente en ningún gráfico proporcionado por Roblox.
Parámetros
El jugador que activó el evento.
Devuelve
LogProgressionEvent
Registra un evento cuando un usuario haya comenzado, completado o fallado un intento de nivel. Este evento no se muestra actualmente en ningún gráfico proporcionado por Roblox.
Parámetros
El jugador que activó el evento.
Devuelve
LogProgressionFailEvent
Registra un evento para cuando un usuario haya fallado en un intento de nivel. Este evento no se muestra actualmente en ningún gráfico proporcionado por Roblox.
Parámetros
El usuario que activó el evento.
Devuelve
LogProgressionStartEvent
Registra un evento para cuando un usuario haya comenzado un intento de nivel. Este evento no se muestra actualmente en ningún gráfico proporcionado por Roblox.
Parámetros
El jugador que activó el evento.