Platform Web SDK 구성

SDK에 대한 구성은 configure 명령을 사용하여 수행됩니다.

중요

configure 는 ** 항상 첫 번째 명령을 호출합니다.

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

구성 중에 설정할 수 있는 다양한 옵션이 있습니다. 모든 옵션은 카테고리별로 그룹화된 아래에서 찾을 수 있습니다.

일반 옵션

edgeConfigId

노트

Edge Configurations의 브랜드가 데이터 세트로 다시 지정되었습니다. 데이터 스트림 ID는 구성 ID와 같습니다.

유형 필수 여부 기본값
문자열 None

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

context

유형 필수 여부 기본값
문자열 배열 아니요 ["web", "device", "environment", "placeContext"]

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

debugEnabled

유형 필수 여부 기본값
부울 아니요 false

디버깅을 활성화할지 여부를 나타냅니다. 이 구성을 true(으)로 설정하면 다음 기능이 활성화됩니다.

기능 함수
콘솔 로깅 브라우저의 JavaScript 콘솔에 디버깅 메시지가 표시되도록 합니다

edgeDomain

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

도메인은 www의 웹 사이트에 대한 data.{customerdomain.com}과 유사합니다.{customerdomain.com}.

orgId

유형 필수 여부 기본값
문자열 없음

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

데이터 수집

clickCollectionEnabled

유형 필수 여부 기본값
부울 아니요 true

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

onBeforeEventSend

유형 필수 여부 기본값
함수 아니요 () => 정의되지 않음

전송되기 바로 전에 모든 이벤트에 대해 호출되는 콜백을 구성합니다. 필드가 xdm인 개체가 콜백으로 전송됩니다. 전송할 내용을 변경하려면 xdm 개체를 수정합니다. 콜백 내에서 xdm 개체는 이미 이벤트 명령에서 전달된 데이터와 자동으로 수집된 정보를 가지고 있습니다. 이 콜백의 시간 및 예제에 대한 자세한 내용은 Modifying Events Globally 를 참조하십시오.

개인 정보 보호 옵션

유형 필수 여부 기본값
개체 아니요 "in"

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

  • "in": 이 설정을 지정하거나 값을 제공하지 않으면 사용자 동의 환경 설정 없이 작업을 계속 진행합니다.
  • "pending": 이 설정을 사용하면 사용자가 동의 환경 설정을 제공할 때까지 작업을 큐에 올릴 수 있습니다.
  • "out": 이 설정을 지정하면 사용자가 동의 환경 설정을 제공할 때까지 작업이 삭제됩니다.
    사용자의 환경 설정이 제공되면 사용자의 환경 설정에 따라 작업이 진행되거나 중단됩니다. 자세한 내용은 지원 동의를 참조하십시오.

개인화 옵션

prehidingStyle

유형 필수 여부 기본값
문자열 아니요 없음

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

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

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

대상 옵션

cookieDestinationsEnabled

유형 필수 여부 기본값
부울 아니요 true

세그먼트 자격에 따라 쿠키를 설정할 수 있는 Audience Manager 쿠키 대상을 활성화합니다.

urlDestinationsEnabled

유형 필수 여부 기본값
부울 아니요 true

세그먼트 자격에 따라 URL을 실행할 수 있는 Audience Manager URL 대상을 활성화합니다.

ID 옵션

idMigrationEnabled

유형 필수 여부 기본값
부울 아니요 true

true인 경우 SDK는 이전 AMCV 쿠키를 읽고 설정합니다. 이 옵션은 사이트의 일부 부분이 여전히 Visitor.js를 사용할 수 있지만 Adobe Experience Platform Web SDK를 사용하여 로 전환하는 데 도움이 됩니다. 방문자 API가 페이지에 정의된 경우 SDK는 ECID에 대해 방문자 API를 쿼리합니다. 이 옵션을 사용하면 Adobe Experience Platform Web SDK를 사용하여 페이지를 이중 태깅하고 여전히 동일한 ECID를 가질 수 있습니다.

thirdPartyCookiesEnabled

유형 필수 여부 기본값
부울 아니요 true

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

이 페이지에서는