AnalyticsService
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
AnalyticsService es una colección de métodos que permite a los desarrolladores rastrear cómo los usuarios interactúan con sus experiencias, específicamente el progreso del jugador, la economía del mundo de experiencia, las funiones y los eventos personalizados.
Resumo
Métodos
Registra un evento utilizado 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):void
Registra un evento utilizado para rastrear acciones del jugador relacionadas en la experiencia.
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):void
Registra un evento utilizado para rastrear las acciones del usuario que pasan a través de un funnel pre-planned.
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):void
Registra un evento utilizado para rastrear las acciones del usuario que pasan a través de un funnel de onboarding.
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
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):void
Registra un evento por cuando un usuario ha comenzado, completado o fallado un intento de nivel.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Registra un evento para cuando un usuario ha fallado un intento de nivel.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Registra un evento para cuando un usuario ha comenzado un intento de nivel.
Propriedades
Métodos
LogCustomEvent
Registra un evento utilizado para rastrear métricas personalizadas de un usuario en la experiencia. Para obtener información adicional, see Eventos Personalizados .
Parâmetros
El usuario que ha desencadenado el evento.
El nombre del evento personalizado.
El valor del evento que se utilizará en la agregación.
Diccionario opcional de campos personalizados que proporcionarán explicaciones en los gráficos proporcionados por Roblox. Solo se usarán las llaves específicas, proporcionadas por Enum.AnalyticsCustomFieldKeys, para estas explicaciones. Limitado a 8,000 combinaciones únicas de valores en las tres personalizaciones de campos por experiencia.
Devolução
Amostras 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 utilizado para rastrear acciones del jugador relacionadas en la experiencia.
Parâmetros
El usuario que ha desencadenado el evento.
Debe especificar la dirección en la que se está fluciendo la moneda usando Enum.AnalyticsEconomyFlowType .
El nombre de la moneda que se agrega o se elimina, por ejemplo "gold" , "gems" , o "energy" . Limitado a 5 tipos de moneda únicos por experiencia.
La cantidad de moneda que se agrega o se elimina. Este valor siempre debe ser positivo.
El saldo del usuario después de que se haya añadido o eliminado la moneda. Este valor siempre debe ser mayor que o igual a 0.
El tipo de transacción que ocurrió. Mientras estás libre de usar cualquier introducirde transacción, se recomienda usar los tipos proporcionados por Enum.AnalyticsEconomyTransactionType como "IAP" o "ContextualPurchase" para habilitar futuras perspectivas de las herramientas y gráficos de Roblox.
Dado que este tipo de campo es una cadena, tendrás que pasar el valor de Name de este enum. Por ejemplo, Enum.AnalyticsEconomyTransactionType.IAP.Name .
Limitado a 20 tipos únicos por experiencia.
Opcionalmente se añade el SKU del artículo o paquete que se está comprando. Este es un identificador único para el artículo que se está comprando. Limitado a 100 SKU únicos por experiencia.
Diccionario opcional de campos personalizados que proporcionarán explicaciones en los gráficos proporcionados por Roblox. Solo se usarán las llaves específicas, proporcionadas por Enum.AnalyticsCustomFieldKeys, para estas explicaciones. Limitado a 8,000 combinaciones únicas de valores en las tres personalizaciones de campos por experiencia.
Devolução
Amostras 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 utilizado para rastrear las acciones del usuario que pasan a través de un funnel pre-planned. Los análisis de funnel solo considerarán los valores del usuario y del evento del primer paso en una sesión de funnel.
Parâmetros
El usuario que ha desencadenado el evento.
El nombre de la chimenea. Esto debería ser el mismo para todos los pasos en la chimenea. Limitado a 10 únicas chimeneas por experiencia.
Identificador único opcional para la sesión de la función. Esto debería ser el mismo para todos los pasos en la función.
Tenga en cuenta que este campo solo es necesario para los flujos de trabajo de función recurrentes, por ejemplo, un funnel de compra o un funnel de actualización de artículos. Si no tiene un identificador de sesión de función natural, se recomienda utilizar Class.HttpService:GenerateGUID().
El número de paso en el funnel. Esto debería ser único para cada paso en el funnel. Todos los funneles comienzan en el paso 1. Limitado a los pasos 1-100.
Pasos repetidos por el mismo usuario en la misma sesión de funnel, o cuando funnelSessionId es nil se ignorará.
Tenga en cuenta que si se omiten cualquier paso, los pasos intermedios se considerarán completados.
Nombre opcional del paso en el funnel. Este campo solo se usa para propósitos de visualización en los gráficos proporcionados por Roblox.
Diccionario opcional de campos personalizados que proporcionarán explicaciones en los gráficos proporcionados por Roblox. Solo se usarán las llaves específicas, proporcionadas por Enum.AnalyticsCustomFieldKeys, para estas explicaciones. Limitado a 8,000 combinaciones únicas de valores en las tres personalizaciones de campos por experiencia.
Devolução
Amostras 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 utilizado para rastrear las acciones del usuario que pasan a través de un funnel de onboarding. Los destruidos de funnel solo considerarán los valores del usuario y del evento desde el primer paso en una sesión de funnel.
Parâmetros
El usuario que ha desencadenado el evento.
El número de paso en el funnel. Esto debería ser único para cada paso en el funnel. Todos los funneles comienzan en el paso 1. Limitado a los pasos 1-100.
Tenga en cuenta que si se omiten cualquier paso, los pasos intermedios se considerarán completados.
Nombre opcional del paso en el funnel. Este campo solo se usa para propósitos de visualización en los gráficos proporcionados por Roblox.
Diccionario opcional de campos personalizados que proporcionarán explicaciones en los gráficos proporcionados por Roblox. Solo se usarán las llaves específicas, proporcionadas por Enum.AnalyticsCustomFieldKeys, para estas explicaciones. Limitado a 8,000 combinaciones únicas de valores en las tres personalizaciones de campos por experiencia.
Devolução
Amostras 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 ha completado un intento de nivel. Este evento no se muestra actualmente en ninguna tabla proporcionada por Roblox.
Parâmetros
El jugador que desencadenó el evento.
Devolução
LogProgressionEvent
Registra un evento por cuando un usuario ha comenzado, completado o fallado un intento de nivel. Este evento no se muestra actualmente en ninguna tabla proporcionada por Roblox.
Parâmetros
El jugador que desencadenó el evento.
Devolução
LogProgressionFailEvent
Registra un evento por cuando un usuario ha fallado un intento de nivel. Este evento no se muestra actualmente en ninguna tabla proporcionada por Roblox.
Parâmetros
El usuario que ha desencadenado el evento.
Devolução
LogProgressionStartEvent
Registra un evento para cuando un usuario ha comenzado un intento de nivel. Este evento no se muestra actualmente en ninguna tabla proporcionada por Roblox.
Parâmetros
El jugador que desencadenó el evento.