웹 SDK 구성

SDK에 대한 구성은 configure 명령입니다.

alloy("configure", {
  "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg"
});

구성 중에 설정할 수 있는 옵션은 다양합니다. 모든 옵션은 아래에 있으며 범주별로 그룹화되어 있습니다.

일반 옵션

edgeConfigId

SDK를 적절한 계정 및 구성에 연결하는 할당된 구성 ID입니다. 단일 페이지 내에서 여러 인스턴스를 구성할 때는 다른 인스턴스를 구성해야 합니다 edgeConfigId 각 인스턴스에 대해

context context

에 설명된 대로 자동으로 수집할 컨텍스트 범주를 나타냅니다. 자동 정보. 이 구성이 지정되지 않으면 기본적으로 모든 카테고리가 사용됩니다.

활성화하려면 높은 엔트로피 클라이언트 힌트 웹 SDK 배포에 추가 항목을 포함해야 합니다. highEntropyUserAgentHints 컨텍스트 옵션을 사용할 수 있습니다.

예를 들어 웹 속성에서 높은 엔트로피 클라이언트 힌트를 검색하려면 다음과 같이 구성하십시오.

context: ["highEntropyUserAgentHints", "web"]

debugEnabled

디버깅이 활성화되었는지 여부를 나타냅니다. 이 구성을 다음으로 설정 중 true 은 다음 기능을 활성화합니다.

edgeDomain edge-domain

이 필드를 자사 도메인으로 채웁니다. 자세한 내용은 설명서.

도메인은 와 유사합니다. data.{customerdomain.com} www의 웹 사이트용.{customerdomain.com}.

edgeBasePath edge-base-path

Adobe 서비스와 통신하고 상호 작용하는 데 사용되는 edgeDomain 뒤의 경로입니다. 종종 이는 기본 프로덕션 환경을 사용하지 않을 때만 변경됩니다.

orgId

내가 할당함 Experience Cloud 조직 ID. 페이지 내에서 여러 인스턴스를 구성할 때는 다른 인스턴스를 구성해야 합니다 orgId 각 인스턴스에 대해

데이터 수집

clickCollectionEnabled clickCollectionEnabled

링크 클릭과 연결된 데이터가 자동으로 수집되는지 여부를 나타냅니다. 다음을 참조하십시오 자동 링크 추적 추가 정보. 또한 링크에 다운로드 속성이 포함되어 있거나 링크가 파일 확장명으로 끝나는 경우 다운로드 링크로 레이블이 지정됩니다. 다운로드 링크 한정자는 정규 표현식으로 구성할 수 있습니다. 기본값은 입니다. "\\.(exe|zip|wav|mp3|mov|mpg|avi|wmv|pdf|doc|docx|xls|xlsx|ppt|pptx)$"

onBeforeEventSend

전송되기 바로 전에 모든 이벤트에 대해 호출되는 콜백을 구성합니다. 필드가 있는 개체 xdm 콜백으로 전송됩니다. 전송된 항목을 변경하려면 xdm 개체. 콜백 내에서 xdm 개체에 이미 이벤트 명령에서 전달된 데이터와 자동으로 수집된 정보가 있습니다. 이 콜백의 타이밍과 예제에 대한 자세한 내용은 전체적으로 이벤트 수정.

onBeforeLinkClickSend onBeforeLinkClickSend

모든 링크 클릭 추적 이벤트에 대해 호출되기 바로 전에 콜백을 구성합니다. 콜백은 xdm, clickedElement, 및 data 필드.

DOM 요소 구조를 사용하여 링크 추적을 필터링할 때 clickElement 명령입니다. clickedElement 는 클릭되었으며 상위 노드 트리를 캡슐화한 DOM 요소 노드입니다.

전송되는 데이터를 변경하려면 xdm 및/또는 data 개체. 콜백 내에서 xdm 개체에 이미 이벤트 명령에서 전달된 데이터와 자동으로 수집된 정보가 있습니다.

개인 정보 보호 옵션

defaultConsent default-consent

사용자의 기본 동의를 설정합니다. 사용자에 대해 이미 저장된 동의 기본 설정이 없는 경우 이 설정을 사용합니다. 다른 유효한 값은 다음과 같습니다. "pending" 및 "out". 이 기본값은 사용자의 프로필로 유지되지 않습니다. 사용자의 프로필은 다음과 같은 경우에만 업데이트됩니다. setConsent 이(가) 호출되었습니다.

개인화 옵션 personalization

prehidingStyle prehidingStyle

개인화된 콘텐츠가 서버에서 로드되는 동안 웹 페이지의 콘텐츠 영역을 숨기는 CSS 스타일 정의를 만드는 데 사용됩니다. 이 옵션이 제공되지 않으면 SDK는 개인화된 콘텐츠가 로드되는 동안 콘텐츠 영역을 숨기지 않아 "깜박임"이 발생할 수 있습니다.

예를 들어 웹 페이지의 요소에 의 ID가 있는 경우 container에서 개인화된 콘텐츠가 서버에서 로드되는 동안 숨길 기본 콘텐츠를 보려면 다음 사전 숨김 스타일을 사용하십시오.

  prehidingStyle: "#container { opacity: 0 !important }"

targetMigrationEnabled targetMigrationEnabled

이 옵션은에서 개별 페이지를 마이그레이션할 때 사용해야 합니다. at.js 웹 SDK에 연결합니다.

이 옵션을 사용하여 웹 SDK에서 기존 을 읽고 쓸 수 있도록 설정합니다. mbox 및 mboxEdgeCluster 에서 사용하는 쿠키 at.js. 이렇게 하면 Web SDK를 사용하는 페이지에서 를 사용하는 페이지로 이동하는 동안 방문자 프로필을 유지하는 데 도움이 됩니다. at.js 라이브러리도 있고 그 반대의 경우도 있습니다.

대상 옵션

cookieDestinationsEnabled

사용 Audience Manager 쿠키 대상: 세그먼트 자격을 기반으로 쿠키를 설정할 수 있습니다.

urlDestinationsEnabled

사용 Audience Manager 세그먼트 자격에 따라 URL을 실행할 수 있는 URL 대상.

ID 옵션

idMigrationEnabled id-migration-enabled

true인 경우 SDK는 이전 AMCV 쿠키를 읽고 설정합니다. 이 옵션은 사이트의 일부 부분에서 여전히 Visitor.js를 사용할 수 있는 동안 Adobe Experience Platform Web SDK를 사용하여 로 전환하는 데 도움이 됩니다.

방문자 API가 페이지에 정의된 경우, SDK는 방문자 API에서 ECID를 쿼리합니다. 이 옵션을 사용하면 Adobe Experience Platform 웹 SDK를 사용하여 페이지에 이중 태그를 지정할 수 있지만 여전히 동일한 ECID를 사용할 수 있습니다.

thirdPartyCookiesEnabled

Adobe 서드파티 쿠키의 설정을 활성화합니다. SDK는 타사 컨텍스트에서 방문자 ID를 유지하여 사이트 간에 동일한 방문자 ID를 사용할 수 있습니다. 여러 사이트가 있거나 파트너와 데이터를 공유하려는 경우 이 옵션을 사용합니다. 그러나 개인 정보 보호를 위해 이 옵션을 사용하지 않는 경우가 있습니다.