Show Menu
화제×

SDK 구성

SDK에 대한 구성은 configure 명령으로 수행됩니다.
configure 항상 호출된 첫 번째 명령이어야 합니다.
alloy("configure", {
  "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg"
});

구성 중에 설정할 수 있는 옵션이 많습니다. 모든 옵션은 아래에 카테고리별로 그룹화되어 있습니다.

일반 옵션

edgeConfigId

유형
필수 여부
기본값
문자열
없음
SDK를 해당 계정 및 구성에 연결하는 할당된 구성 ID입니다. 단일 페이지 내에서 여러 인스턴스를 구성할 때 각 인스턴스에 대해 다른 인스턴스 edgeConfigId 를 구성해야 합니다.

context

유형
필수 여부
기본값
문자열 배열
아니요
["web", "device", "environment", "placeContext"]
자동 정보에 설명된 대로 자동으로 수집할 컨텍스트 카테고리를 나타냅니다 . 이 구성을 지정하지 않으면 기본적으로 모든 카테고리가 사용됩니다.

debugEnabled

유형
필수 여부
기본값
부울
아니요
false
디버깅을 사용할지 여부를 나타냅니다. 다음 기능을 사용하도록 이 구성 true 을 설정합니다.
기능
함수
동기 유효성 검사
스키마에 대해 수집되는 데이터의 유효성을 확인하고 다음 레이블 아래의 응답에서 오류를 반환합니다. collect:error OR success
콘솔 로깅
브라우저의 JavaScript 콘솔에 표시되는 디버깅 메시지 사용

edgeDomain

유형
필수 여부
기본값
문자열
아니요
beta.adobedc.net
Adobe 서비스와 상호 작용하는 데 사용되는 도메인. Adobe 에지 인프라에 요청을 프록시하는 퍼스트 파티 도메인(CNAME)이 있는 경우에만 사용됩니다.

orgId

유형
필수 여부
기본값
문자열
없음
Your assigned Experience Cloud organization ID. 페이지 내에서 여러 인스턴스를 구성할 때는 각 인스턴스에 대해 다른 인스턴스 orgId 를 구성해야 합니다.

데이터 수집

clickCollectionEnabled

유형
필수 여부
기본값
부울
아니요
true
링크 클릭과 연관된 데이터를 자동으로 수집할지 여부를 나타냅니다. 링크 클릭으로 자격이 되는 클릭의 경우 다음 웹 상호 작용 데이터가 수집됩니다.
속성
설명
링크 이름
링크 컨텍스트에 의해 결정된 이름
링크 URL
정규화된 URL
링크 유형
다운로드, 종료 또는 기타

onBeforeEventSend

유형
필수 여부
기본값
함수
아니요
() => 정의되지 않음
수신자가 전송되기 직전에 모든 이벤트에 대해 호출되는 콜백을 구성하려면 이 설정을 설정하십시오. 필드가 포함된 객체 xdm 가 콜백으로 전송됩니다. 전송될 개체를 xdm 변경하려면 개체를 수정합니다. 콜백 내에서 개체는 이벤트 명령에서 전달된 데이터와 자동으로 수집된 정보를 이미 xdm 갖습니다. 이 콜백의 시간 및 예제에 대한 자세한 내용은 전역 으로 이벤트 수정을 참조하십시오 .

개인 정보 옵션

개인화 옵션

prehidingStyle

유형
필수 여부
기본값
문자열
아니요
없음
개인화된 컨텐츠가 서버에서 로드되는 동안 웹 페이지의 컨텐츠 영역을 숨기는 CSS 스타일 정의를 만드는 데 사용됩니다. 이 옵션을 제공하지 않으면 SDK에서 개인화된 컨텐츠가 로드되는 동안 컨텐츠 영역을 숨기지 않으므로 잠재적으로 "깜박임"이 발생합니다.
예를 들어, 개인화된 컨텐츠가 서버에서 로드되는 동안 숨겨야 하는 기본 컨텐츠의 ID가 있는 웹 페이지의 요소가 container 있는 경우, 사전 숨김 스타일의 예는 다음과 같습니다.
  prehidingStyle: "#container { opacity: 0 !important }"

대상 옵션

cookieDestinationsEnabled

유형
필수 여부
기본값
부울
아니요
true
세그먼트 자격 조건에 따라 쿠키 설정을 허용하는 Audience Manager 쿠키 대상을 활성화합니다.

urlDestinationsEnabled

유형
필수 여부
기본값
부울
아니요
true
세그먼트 자격 조건에 따라 URL을 실행할 수 있는 URL 대상을 활성화합니다. Audience Manager

ID 옵션

idMigrationEnabled

유형
필수 여부
기본값
부울
아니요
true
true이면 SDK가 이전 AMCV 쿠키를 읽고 설정합니다. 이렇게 하면 사이트의 일부 부분이 여전히 Visitor.js를 사용하고 있을 수 있지만 AEP 웹 SDK를 사용하는 것으로 전환하는 데 도움이 됩니다. 또한 방문자 API가 페이지에 정의된 경우 SDK는 방문자 API에 대해 ECID를 쿼리합니다. 이를 통해 AEP 웹 SDK를 사용하여 이중 태그 페이지를 만들 수 있으며 동일한 ECID를 가질 수 있습니다.

thirdPartyCookiesEnabled

유형
필수 여부
기본값
부울
아니요
true
타사 쿠키 Adobe 설정을 활성화합니다. SDK에는 방문자 ID를 타사 컨텍스트에서 유지하여 여러 사이트에서 동일한 방문자 ID를 사용할 수 있는 기능이 있습니다. 여러 사이트가 있거나 파트너와 데이터를 공유하려는 경우 유용합니다.하지만 경우에 따라 개인 정보 보호 이유로 이러한 것이 권장되지 않습니다.