Turbine 자유 변수
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
turbineBuildDate
buildDate
environment
console.log(turbine.environment.stage);
turbine.environment
은(는) 라이브러리가 배포된 환경에 대한 정보가 포함된 개체입니다.
{
id: "ENbe322acb4fc64dfdb603254ffe98b5d3",
stage: "development"
}
id
stage
development
, staging
및 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
확장 개발자는 이 설정에 관여하지 않아야 합니다.