Show Menu
화제×

SDK 구성

SDK에 대한 구성은 configure 명령으로 수행됩니다.
alloy("configure", {
  "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg"
});

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

일반 옵션

edgeConfigId

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

context

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

debugEnabled

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

edgeDomain

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

orgId

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

데이터 수집

clickCollectionEnabled

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

onBeforeEventSend

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

개인 정보 옵션

defaultConsent

유형
필수 여부
기본값
개체
아니요
{"general": "in"}
사용자의 기본 동의를 설정합니다. 사용자에 대해 이미 저장된 동의 환경 설정이 없을 때 사용됩니다. 다른 유효한 값은 입니다 {"general": "pending"} . 이 설정이 되면 사용자가 동의 환경 설정을 제공할 때까지 작업이 대기됩니다. 사용자의 환경 설정이 제공되면 사용자의 환경 설정에 따라 작업이 진행되거나 중단됩니다. 자세한 내용은 동의 지원을 참조하십시오.

개인화 옵션

prehidingStyle

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

대상 옵션

cookieDestinationsEnabled

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

urlDestinationsEnabled

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

ID 옵션

idSyncContainerId

유형
필수 여부
기본값
숫자
아니요
none
실행된 ID를 지정하는 컨테이너 ID. 컨설턴트가 얻을 수 있는 음수가 아닌 정수입니다.

idSyncEnabled

유형
필수 여부
기본값
부울
아니요
true
URL을 실행하여 Adobe 고유 사용자 ID를 타사 데이터 소스의 고유 사용자 ID와 동기화할 수 있는 ID 동기화 기능을 활성화합니다.

thirdPartyCookiesEnabled

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