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 introducirde 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
The following sample tracks a Robux purchase of a 1000-coin bundle, using the IAP (in-app purchase) transaction type. Note the item name provided as an optional parameter when compared to the previous sample.
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- How many coins are in the bundle
1020, -- balance after transaction
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- Unique identifier of the coin bundle
)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
The following sample tracks some basic events for each user beginning the process to buy an item from an "armory" shop. Note the funnelSessionId used to distinguish between different sessions of the same user opening the shop.
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- Log when the user opens the store
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Funnel name used to group steps together
funnelSessionId, -- Funnel session id for this unique checkout session
1, -- Step number
"Opened Store" -- Step name
)
-- Log when the user views an item
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Funnel name used to group steps together
funnelSessionId, -- Funnel session id for this unique checkout session
2, -- Step number
"Viewed Item" -- Step name
)
-- Log when the user views adds to cart
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Funnel name used to group steps together
funnelSessionId, -- Funnel session id for this unique checkout session
3, -- Step number
"Added to Cart" -- Step name
)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
The following sample demonstrates how to log two steps of an onboarding funnel. An onboarding funnel typically introduces players to the game's core loop.
local AnalyticsService = game:GetService("AnalyticsService")
-- Log the first step of the FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- Step number
"Joined Game" -- Step name
)
-- Log the second step of the FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- Step number
"Choose Class" -- Step name
)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.