Show Menu
화제×

(베타) SDK 구성

Adobe Experience Platform Web SDK는 현재 베타 버전이며 일부 사용자는 사용할 수 없습니다. 설명서 및 기능은 변경될 수 있습니다.
SDK에 대한 구성은 configure 명령으로 수행됩니다.
alloy("configure", {
  "configId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg"
});

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

일반 옵션

configId

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

context

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

debugEnabled

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

edgeDomain

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

errorsEnabled

유형
필수 여부
기본값
부울
아니요
true
오류를 억제해야 하는지 여부를 나타냅니다. 명령 실행에 설명된 대로 Adobe Experience Platform 웹 SDK에서 디버깅이 활성화되었는지 여부에 관계없이 캡처되지 않는오류가 개발자 콘솔에 기록됩니다. 다음으로 errorsEnabled 설정하면 Adobe Experience Platform false Web SDK에서 반환되는 약속은 거부되지 않습니다. 그러나 로깅이 Adobe Experience Platform Web SDK에서 활성화된 경우 콘솔에 오류가 계속 기록됩니다.

orgId

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

데이터 수집

clickCollectionEnabled

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

onBeforeEventSend

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

개인 정보 옵션

defaultConsent

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

개인화 옵션

prehidingStyle

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

대상 옵션

cookieDestinationsEnabled

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

urlDestinationsEnabled

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

ID 옵션

idSyncContainerId

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

idSyncEnabled

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

thirdPartyCookiesEnabled

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