AnalyticsService

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Não criável
Serviço
Não replicado

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

Propriedades

Métodos

LogCustomEvent

void

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

player: Player

El usuario que ha desencadenado el evento.

eventName: string

El nombre del evento personalizado.

value: number

El valor del evento que se utilizará en la agregación.

Valor Padrão: 1
customFields: Dictionary

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.

Valor Padrão: "nil"

Devolução

void

Amostras de código

Log Custom Event

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

void

Registra un evento utilizado para rastrear acciones del jugador relacionadas en la experiencia.

Parâmetros

player: Player

El usuario que ha desencadenado el evento.

Debe especificar la dirección en la que se está fluciendo la moneda usando Enum.AnalyticsEconomyFlowType .

currencyType: string

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.

amount: number

La cantidad de moneda que se agrega o se elimina. Este valor siempre debe ser positivo.

endingBalance: number

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.

transactionType: string

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.

itemSku: string

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.

Valor Padrão: ""
customFields: Dictionary

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.

Valor Padrão: "nil"

Devolução

void

Amostras de código

Tracking an in-app purchase

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

void

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

player: Player

El usuario que ha desencadenado el evento.

funnelName: string

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.

funnelSessionId: string

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().

Valor Padrão: ""
step: number

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.

Valor Padrão: 1
stepName: string

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.

Valor Padrão: ""
customFields: Dictionary

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.

Valor Padrão: "nil"

Devolução

void

Amostras de código

Tracking Shop steps

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

void

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

player: Player

El usuario que ha desencadenado el evento.

step: number

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.

stepName: string

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.

Valor Padrão: ""
customFields: Dictionary

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.

Valor Padrão: "nil"

Devolução

void

Amostras de código

Tracking onboarding steps

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

void

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

player: Player

El jugador que desencadenó el evento.

progressionPathName: string
level: number
levelName: string
Valor Padrão: ""
customFields: Dictionary
Valor Padrão: "nil"

Devolução

void

LogProgressionEvent

void

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

player: Player

El jugador que desencadenó el evento.

progressionPathName: string
level: number
levelName: string
Valor Padrão: ""
customFields: Dictionary
Valor Padrão: "nil"

Devolução

void

LogProgressionFailEvent

void

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

player: Player

El usuario que ha desencadenado el evento.

progressionPathName: string
level: number
levelName: string
Valor Padrão: ""
customFields: Dictionary
Valor Padrão: "nil"

Devolução

void

LogProgressionStartEvent

void

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

player: Player

El jugador que desencadenó el evento.

progressionPathName: string
level: number
levelName: string
Valor Padrão: ""
customFields: Dictionary
Valor Padrão: "nil"

Devolução

void

Eventos