Adobe Experience Platform Launch est désormais une suite de technologies destinées à la collecte de données dans Adobe Experience Platform. Plusieurs modifications terminologiques ont par conséquent été apportées à la documentation du produit. Reportez-vous au document suivant pour consulter une référence consolidée des modifications terminologiques.
L’objet turbine
est une « variable libre » dans la portée des modules de bibliothèque de votre extension. Il fournit des informations et des utilitaires spécifiques à l’exécution de balise Adobe Experience Platform et est toujours disponible pour les modules de bibliothèque sans utiliser require()
.
buildInfo
console.log(turbine.buildInfo.turbineBuildDate);
turbine.buildInfo
est un objet contenant des informations de version sur la bibliothèque actuelle dʼexécution des balises.
{
turbineVersion: "14.0.0",
turbineBuildDate: "2016-07-01T18:10:34Z",
buildDate: "2016-03-30T16:27:10Z"
}
Propriété | Description |
---|---|
turbineVersion |
Version de Turbine utilisée dans la bibliothèque actuelle. |
turbineBuildDate |
Date ISO 8601 de création de la version de Turbine utilisée dans le conteneur. |
buildDate |
Date ISO 8601 de la création de la bibliothèque actuelle. |
environment
console.log(turbine.environment.stage);
turbine.environment
est un objet contenant des informations sur l’environnement sur lequel la bibliothèque est déployée.
{
id: "ENbe322acb4fc64dfdb603254ffe98b5d3",
stage: "development"
}
Propriété | Description |
---|---|
id |
Identifiant de l’environnement. |
stage |
Environnement pour lequel cette bibliothèque a été créée. Les valeurs possibles sont les suivantes : development , staging et production . |
debugEnabled
Valeur booléenne indiquant si le débogage des balises est actuellement activé.
Si vous essayez simplement de consigner des messages, il est peu probable que vous ayez besoin d’utiliser cette fonctionnalité. Au lieu de cela, consignez toujours les messages à lʼaide de turbine.logger
afin de vous assurer quʼils ne sont imprimés sur la console que lorsque le débogage des balises est activé.
getDataElementValue
console.log(turbine.getDataElementValue(dataElementName));
Renvoie la valeur d’un élément de données.
getExtensionSettings
var extensionSettings = turbine.getExtensionSettings();
Renvoie l’objet settings qui a été enregistré pour la dernière fois à partir de la vue configuration de l’extension.
Veuillez noter que les valeurs des objets settings renvoyés peuvent provenir d’éléments de données. Par conséquent, l’appel de getExtensionSettings()
à des moments différents peut donner des résultats différents si les valeurs des éléments de données ont changé. Pour obtenir les valeurs les plus récentes, patientez aussi longtemps que possible avant dʼappeler getExtensionSettings()
.
getHostedLibFileUrl
var loadScript = require('@adobe/reactor-load-script');
loadScript(turbine.getHostedLibFileUrl('AppMeasurement.js')).then(function() {
// Do something ...
})
La propriété hostedLibFiles peut être définie dans le manifeste dʼextension afin dʼhéberger divers fichiers avec la bibliothèque dʼexécution des balises. Ce module renvoie l’URL d’hébergement du fichier de bibliothèque donné.
getSharedModule
var mcidInstance = turbine.getSharedModule('adobe-mcid', 'mcid-instance');
Récupère un module qui a été partagé depuis une autre extension. Si aucun module correspondant n’est trouvé, undefined
est renvoyé. Voir Implémentation de modules partagés pour plus d’informations sur les modules partagés.
logger
turbine.logger.error('Error!');
Lʼutilitaire de journalisation est utilisé pour consigner les messages dans la console. Les messages s’affichent uniquement dans la console si le débogage est activé par l’utilisateur. La méthode recommandée pour activer le débogage consiste à utiliser Adobe Experience Cloud Debugger. Lʼutilisateur peut également exécuter la commande suivante _satellite.setDebug(true)
dans la console de développeur du navigateur. La journalisation utilise les méthodes suivantes :
logger.log(message: string)
: consigne un message sur la console.logger.info(message: string)
: consigne un message d’information dans la console.logger.warn(message: string)
: consigne un message d’avertissement dans la console.logger.error(message: string)
: consigne un message d’erreur dans la console.logger.debug(message: string)
: consigne un message de débogage dans la console. (Visible uniquement lorsque la journalisation verbose
est activée dans la console du navigateur.)logger.deprecation(message: string)
: consigne un message d’avertissement dans la console, que le débogage des balises soit activé ou non par l’utilisateur.onDebugChanged
En transmettant une fonction de rappel dans turbine.onDebugChanged
, les balises appellent votre rappel chaque fois que le débogage est activé/désactivé. Les balises transmettent une valeur booléenne à la fonction de rappel, qui est vraie si le débogage a été activé ou fausse si le débogage a été désactivé.
Si vous essayez simplement de consigner des messages, il est peu probable que vous ayez besoin d’utiliser cette fonctionnalité. Au lieu de cela, consignez toujours les messages à lʼaide de turbine.logger
et les balises feront en sorte que vos messages ne soient imprimés sur la console que lorsque le débogage des balises sera activé.
propertySettings
console.log(turbine.propertySettings.domains);
Un objet contenant les paramètres suivants définis par lʼutilisateur pour la propriété de la bibliothèque dʼexécution des balises actuelle :
propertySettings.domains: Array<String>
Tableau de domaines couverts par la propriété.
propertySettings.undefinedVarsReturnEmpty: boolean
Les développeurs d’extensions ne doivent pas se préoccuper de ce paramètre.