Turbine 自由變數

NOTE
Adobe Experience Platform Launch已經過品牌重塑,現在是Adobe Experience Platform中的一套資料收集技術。 因此,所有產品文件中出現了幾項術語變更。 如需術語變更的彙整參考資料,請參閱以下文件

turbine 物件是您擴充功能的程式庫模組範圍內的「自由變數」。此變數提供Adobe Experience Platform標籤執行階段的特定資訊和公用程式,且程式庫模組隨時都可加以使用(無需使用) require().

buildInfo

console.log(turbine.buildInfo.turbineBuildDate);

turbine.buildInfo 是一個物件,其中包含目前標籤執行階段程式庫的相關建置資訊。

{
    turbineVersion: "14.0.0",
    turbineBuildDate: "2016-07-01T18:10:34Z",
    buildDate: "2016-03-30T16:27:10Z"
}
屬性
說明
turbineVersion
目前程式庫內使用的 Turbine 版本。
turbineBuildDate
建置容器內使用的 Turbine 版本時的 ISO 8601 日期。
buildDate
建置目前程式庫時的 ISO 8601 日期。

environment

console.log(turbine.environment.stage);

turbine.environment 是一個物件,其中包含程式庫部署所在環境的相關資訊。

{
    id: "ENbe322acb4fc64dfdb603254ffe98b5d3",
    stage: "development"
}
屬性
說明
id
環境的ID。
stage
建置此程式庫的環境。可能的值包括 developmentstaging、和 production.

debugEnabled

表示標籤偵錯目前是否啟用的布林值。

如果您只是要記錄訊息,則不太可能需要使用此功能。請一律使用來記錄訊息 turbine.logger 以確保在啟用標籤偵錯功能時,您的訊息只會列印至主控台。

getDataElementValue

console.log(turbine.getDataElementValue(dataElementName));

傳回資料元素的值。

getExtensionSettings get-extension-settings

var extensionSettings = turbine.getExtensionSettings();

傳回上次從擴充功能組態檢視儲存的設定物件。

請注意,傳回的設定物件中包含的值可能來自資料元素。因此,如果資料元素的值已變更,則在不同時間呼叫 getExtensionSettings() 可能會產生不同的結果。若要取得最新的值,請儘可能久地等候一段時間,然後再呼叫 getExtensionSettings().

getHostedLibFileUrl get-hosted-lib-file

var loadScript = require('@adobe/reactor-load-script');
loadScript(turbine.getHostedLibFileUrl('AppMeasurement.js')).then(function() {
  // Do something ...
})

Hostedlibfiles 屬性可定義於擴充功能資訊清單中,以將各種檔案與標籤執行階段程式庫裝載在一起。 此模組會傳回指定的程式庫檔案託管所在的 URL。

getSharedModule shared

var mcidInstance = turbine.getSharedModule('adobe-mcid', 'mcid-instance');

擷取已從其他擴充功能共用的模組。 若未找到相符的模組,將會傳回 undefined。如需關於共用模組的詳細資訊,請參閱實作共用模組

logger

turbine.logger.error('Error!');

記錄公用程式用於將訊息記錄到主控台。 只有在使用者開啟除錯功能時,訊息才會顯示在主控台中。開啟偵錯功能的建議方式,是使用 Adobe Experience Platform Debugger. 作為替代方法,使用者可以執行以下命令 _satellite.setDebug(true) 在瀏覽器開發人員控制檯內。 記錄器具有下列方法:

  • logger.log(message: string):將訊息記錄到主控台。
  • logger.info(message: string):將資訊性訊息記錄到主控台。
  • logger.warn(message: string):將警告訊息記錄到主控台。
  • logger.error(message: string):將錯誤訊息記錄到主控台。
  • logger.debug(message: string):將除錯訊息記錄到主控台。(只有在您的瀏覽器主控台內啟用 verbose 記錄時才可見。)
  • logger.deprecation(message: string):無論使用者是否啟用標籤偵錯,都會將警告訊息記錄到主控台。

onDebugChanged

將回呼函式傳入 turbine.onDebugChanged,標籤會在切換偵錯時呼叫您的回呼。 標籤會將布林值傳至回呼函式,若已啟用偵錯,則值為true;若停用偵錯,則值為false。

如果您只是要記錄訊息,則不太可能需要使用此功能。請一律使用來記錄訊息 turbine.logger 和標籤可確保在啟用標籤偵錯功能時,訊息只會列印至主控台。

propertySettings property-settings

console.log(turbine.propertySettings.domains);

一個物件,其中包含使用者為目前標籤執行階段程式庫的屬性所定義的下列設定:

  • propertySettings.domains: Array<String>

    屬性涵蓋的網域陣列。

  • propertySettings.undefinedVarsReturnEmpty: boolean

    擴充功能開發人員不應介入這項設定。

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743