Classe de moteur
AnalyticsService
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
Résumé
Méthodes
FireCustomEvent(player: Instance,eventCategory: string,customData: Variant):() |
FireInGameEconomyEvent(player: Instance,itemName: string,economyAction: Enum.AnalyticsEconomyAction,itemCategory: string,amount: number,currency: string,location: Variant,customData: Variant):() |
FireLogEvent(player: Instance,logLevel: Enum.AnalyticsLogLevel,message: string,debugInfo: Variant,customData: Variant):() |
FirePlayerProgressionEvent(player: Instance,category: string,progressionStatus: Enum.AnalyticsProgressionStatus,location: Variant,statistics: Variant,customData: Variant):() |
GetPlayerSegmentsAsync(player: Player):Dictionary |
LogCustomEvent(player: Player,eventName: string,value: number,customFields: Dictionary):() |
LogEconomyEvent(player: Player,flowType: Enum.AnalyticsEconomyFlowType,currencyType: string,amount: number,endingBalance: number,transactionType: string,itemSku: string,customFields: Dictionary):() |
LogFunnelStepEvent(player: Player,funnelName: string,funnelSessionId: string,step: number,stepName: string,customFields: Dictionary):() |
LogOnboardingFunnelStepEvent(player: Player,step: number,stepName: string,customFields: Dictionary):() |
LogProgressionCompleteEvent(player: Player,progressionPathName: string,level: number,levelName: string,customFields: Dictionary):() |
LogProgressionEvent(player: Player,progressionPathName: string,status: Enum.AnalyticsProgressionType,level: number,levelName: string,customFields: Dictionary):() |
LogProgressionFailEvent(player: Player,progressionPathName: string,level: number,levelName: string,customFields: Dictionary):() |
LogProgressionStartEvent(player: Player,progressionPathName: string,level: number,levelName: string,customFields: Dictionary):() |
Référence API
Propriétés
ApiKey
Méthodes
FireCustomEvent
FireEvent
FireInGameEconomyEvent
FireLogEvent
FirePlayerProgressionEvent
GetPlayerSegmentsAsync
Paramètres
Retours
Échantillons de code
Configurer des expériences côté serveur avec des segments de joueurs
local Players = game:GetService("Players")
local AnalyticsService = game:GetService("AnalyticsService")
local function configurePlayerExperience(player)
local segments = AnalyticsService:GetPlayerSegmentsAsync(player)
if not segments.HasData then
return
end
if segments.WhenUserFirstPlayed == Enum.WhenUserFirstPlayed.Days0To30 then
print("Afficher un onboarding supplémentaire pour", player.Name)
end
if segments.ActivePayerStatus == Enum.ActivePayerStatus.Top15Percent then
print("Afficher une offre de haute valeur à", player.Name)
end
end
Players.PlayerAdded:Connect(configurePlayerExperience)LogCustomEvent
AnalyticsService:LogCustomEvent(
):()
Paramètres
| Valeur par défaut : 1 |
| Valeur par défaut : "nil" |
Retours
()
Échantillons de code
Journaliser un Événement Personnalisé
local AnalyticsService = game:GetService("AnalyticsService")
-- Journaliser lorsque la mission commence
AnalyticsService:LogCustomEvent(
player,
"MissionDémarrée" -- Nom de l'événement personnalisé
)
-- Journaliser lorsque la mission est complétée avec le temps pris
AnalyticsService:LogCustomEvent(
player,
"MissionDuréeComplétée", -- Nom de l'événement personnalisé
120 -- Valeur de l'événement utilisée dans l'agrégation
)LogEconomyEvent
AnalyticsService:LogEconomyEvent(
player:Player, flowType:Enum.AnalyticsEconomyFlowType, currencyType:string, amount:number, endingBalance:number, transactionType:string, itemSku:string, customFields:Dictionary
):()
Paramètres
| Valeur par défaut : "nil" |
Retours
()
Échantillons de code
Suivi d'un achat in-app
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- Combien de pièces sont dans le pack
1020, -- solde après la transaction
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- Identifiant unique du pack de pièces
)LogFunnelStepEvent
Retours
()
Échantillons de code
Suivi des étapes de la boutique
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- Journaliser lorsque l'utilisateur ouvre le magasin
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Nom du funnel utilisé pour regrouper les étapes
funnelSessionId, -- ID de session de funnel pour cette session d'achat unique
1, -- Numéro d'étape
"Magasin ouvert" -- Nom de l'étape
)
-- Journaliser lorsque l'utilisateur consulte un article
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Nom du funnel utilisé pour regrouper les étapes
funnelSessionId, -- ID de session de funnel pour cette session d'achat unique
2, -- Numéro d'étape
"Article consulté" -- Nom de l'étape
)
-- Journaliser lorsque l'utilisateur ajoute au panier
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Nom du funnel utilisé pour regrouper les étapes
funnelSessionId, -- ID de session de funnel pour cette session d'achat unique
3, -- Numéro d'étape
"Ajouté au panier" -- Nom de l'étape
)LogOnboardingFunnelStepEvent
AnalyticsService:LogOnboardingFunnelStepEvent(
):()
Paramètres
| Valeur par défaut : "nil" |
Retours
()
Échantillons de code
Suivi des étapes d'intégration
local AnalyticsService = game:GetService("AnalyticsService")
-- Enregistrer la première étape de l'FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- Numéro de l'étape
"Rejoint le jeu" -- Nom de l'étape
)
-- Enregistrer la deuxième étape de l'FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- Numéro de l'étape
"Choisir une classe" -- Nom de l'étape
)LogProgressionCompleteEvent
AnalyticsService:LogProgressionCompleteEvent(
):()
Paramètres
| Valeur par défaut : "nil" |
Retours
()
LogProgressionEvent
AnalyticsService:LogProgressionEvent(
player:Player, progressionPathName:string, status:Enum.AnalyticsProgressionType, level:number, levelName:string, customFields:Dictionary
):()
Paramètres
| Valeur par défaut : "nil" |
Retours
()
LogProgressionFailEvent
AnalyticsService:LogProgressionFailEvent(
):()
Paramètres
| Valeur par défaut : "nil" |
Retours
()
LogProgressionStartEvent
AnalyticsService:LogProgressionStartEvent(
):()
Paramètres
| Valeur par défaut : "nil" |
Retours
()