Adobe Experience Platform Web SDK Extension

AEP 웹 SDK 익스텐션은 Adobe Experience Platform Edge 네트워크를 통해 웹 속성에서 Adobe Experience Cloud으로 데이터를 전송합니다. Adobe Experience Platform Web SDK 익스텐션을 사용하면 데이터를 플랫폼에 스트리밍하거나 ID를 동기화하고 옵트인 및 컨텍스트 데이터를 자동으로 수집할 수 있습니다.

AEP 웹 SDK 확장 구성

이 섹션에서는 Adobe Experience Platform 웹 SDK 확장 기능을 구성할 때 사용할 수 있는 옵션에 대한 참조를 제공합니다.

Adobe Experience Platform 웹 SDK 익스텐션이 아직 설치되어 있지 않은 경우 속성을 열고 Extensions > Catalog​을 선택하고 Adobe Experience Platform 웹 SDK 확장 프로그램 위로 마우스를 가져간 다음 Install​을 선택합니다.

확장을 구성하려면 Extensions 탭을 열고 확장자 위로 마우스를 가져간 다음 Configure​을 선택합니다.

인스턴스 이름

AEP 웹 SDK 익스텐션은 페이지에서 여러 인스턴스를 지원합니다. 이 확장은 단일 Adobe Experience Platform Launch 구성을 사용하여 여러 조직에 데이터를 전송하는 데 사용됩니다. Name 기본값은 alloy입니다. 그러나 인스턴스 이름을 유효한 JavaScript 개체 이름으로 변경할 수 있습니다. Adobe Experience Platform 확장 기능을 사용하려면 각 인스턴스에 서로 다른 Config ID​와 Organization ID​가 있어야 합니다.

Config ID

Config ID​는 Adobe Experience Platform에 데이터를 라우팅해야 하는 위치와 서버에서 사용해야 하는 구성을 알려줍니다. Adobe Experience Platform 확장이 작동하는 데 필요합니다. 클라이언트 지원팀에 연락하여 구성 ID를 얻을 수 있습니다.

Organization ID

Organization ID​는 Adobe에 데이터를 전송하는 조직입니다. 대부분의 경우 자동 채우기되는 기본값을 사용해야 합니다. 페이지에 인스턴스가 여러 개 있으면 데이터를 보낼 두 번째 조직의 값으로 이 인스턴스를 채웁니다.

Edge Domain

Edge Domain​은 Adobe Experience Platform 확장에서 데이터를 보내고 받는 도메인입니다. 기본 타사 도메인은 프로덕션 트래픽에 자사 CNAME을 사용해야 합니다. 기본 타사 도메인은 개발 환경에서 작동하지만, 프로덕션 환경에는 적합하지 않습니다. 자사 CNAME을 설정하는 방법에 대한 지침은 여기에 나와 있습니다.

Enable Errors

기본적으로 확장 프로그램에 오류가 있으면 콘솔에 오류가 기록됩니다. 프로덕션 환경에서 오류를 숨기려면 확인란의 Enable Errors 선택을 취소합니다. Platform Launch에서 디버깅이 설정되어 있어도 오류가 인쇄됩니다.

Enable Opt-in

Enable Opt-in​이(가) 활성화된 경우 AEP 웹 SDK 확장은 옵트인이 수신될 때까지 히트를 저장할 수 있습니다. 이 확장은 옵트인 환경 설정을 지정하는 동작을 표시합니다.

Enable Migrate ECID

AEP 웹 SDK 익스텐션은 새 쿠키를 사용하여 ECID를 저장합니다. 이 설정을 사용하면 마이그레이션을 위해 새 쿠키와 이전 쿠키가 호환됩니다. ECID가 있는 기존 방문자가 없는 한 이 기능을 사용할 것을 적극 권장합니다.

Use 3rd Party Cookies

Adobe Experience Platform은 쿠키를 항상 자사 도메인에 저장합니다. 이 옵션을 사용하면 자사 도메인의 쿠키뿐만 아니라 demdex.net에 설정된 타사 쿠키를 사용할 수 있습니다. 이 기능은 여러 도메인 간에 전환하는 사용자가 있을 때 유용합니다. 이 옵션을 선택하면 demdex.net 호출이 비활성화됩니다.

Context

확장은 요청 컨텍스트에 대한 정보(예: URL 및 브라우저에 대한 세부 정보)를 자동으로 수집합니다. 특정 컨텍스트를 선택 취소하여 비활성화할 수 있습니다.

  • web - URL, 레퍼러 등 웹 페이지에 대한 세부 사항
  • device - 화면 방향, 화면 높이 및 화면 폭과 같은 장치에 대한 세부 사항
  • environment - 컴퓨팅 환경 정보(브라우저, 연결 등)
  • location - 사용자의 위치에 대한 제한된 정보

작업 유형

이벤트 보내기

Adobe Experience Platform에서 전송하는 데이터를 수집하고 해당 정보에 대해 조치를 취할 수 있도록 이벤트를 Adobe Experience Platform로 전송합니다. 인스턴스를 선택해야 합니다(인스턴스가 두 개 이상인 경우). 페이지 로드 시작 시 또는 단일 페이지 애플리케이션에서 보기 변경 중에 이벤트가 발생하는 경우 Occurs at the start of a view​를 선택합니다.

전송하려는 모든 데이터는 XDM Data 필드에서 전송할 수 있습니다. XDM 스키마의 구조를 준수하는 JSON 개체여야 합니다. 이 개체는 페이지 또는 Custom Code Data Element​를 통해 만들 수 있습니다.

동의 설정

사용자의 동의를 받은 후에는 AEP 웹 SDK에 통신해야 합니다. 이렇게 하려면 "동의 설정" 작업 유형을 사용합니다. 현재 2가지 유형의 표준이 지원됩니다."Adobe" 및 "IAB TCF" Adobe 표준을 사용하는 경우 현재 동의를 "시작", "종료"로 설정하거나 데이터 요소를 사용하여 제공할 수 있습니다. IAB TCF 표준을 사용하는 경우 사용할 버전 및 값과 GDPR에 대한 추가 정보를 제공합니다.

이 작업에서는 동의를 받으면 ID를 동기화할 수 있도록 ID 맵을 포함할 선택적 필드도 제공됩니다. 이 기능은 동의 호출이 "보류 중"으로 구성된 경우 처음 전화를 거는 것일 수 있으므로 유용합니다.

이벤트 병합 ID 재설정

페이지에서 이벤트 병합 ID를 재설정하려면 이 작업으로 할 수 있습니다. ID를 재설정하려면 재설정할 병합 ID를 선택하고 필요에 따라 작업을 실행해야 합니다.

데이터 요소 유형

이벤트 병합 ID

이 데이터 요소는 사용될 때 이벤트 병합 ID를 제공합니다. 이 데이터 요소에는 구성이 필요하지 않습니다. 제공된 데이터 요소는 방문자가 페이지를 떠나거나 "이벤트 병합 ID 재설정" 작업 유형이 사용될 때까지 동일하게 유지됩니다.

ID 맵

ID 맵 데이터 요소를 사용하면 다른 데이터 요소 또는 지정한 다른 값에서 ID를 만들 수 있습니다. 만드는 모든 ID는 해당 네임스페이스에 다시 연결해야 합니다. 이 데이터 요소는 사용자가 만든 모든 기본 네임스페이스와 모든 기본 네임스페이스를 표시하는 드롭다운을 제공합니다.

XDM 개체

Adobe Experience Platform Web SDK로 전송하는 모든 데이터는 XDM 형식이어야 합니다. XDM 개체 데이터 요소를 사용하면 데이터 서식을 보다 손쉽게 지정할 수 있습니다. 이 데이터 요소를 처음 열면 올바른 Adobe Experience Platform 샌드박스 및 스키마를 선택합니다. 스키마를 선택하면 스키마 구조가 표시되며 쉽게 작성할 수 있습니다.

web.webPageDetails.URL과 같은 스키마의 특정 필드를 열면 일부 항목이 자동으로 수집됩니다. 여러 항목이 자동으로 수집되지만 필요한 경우 덮어쓸 수 있습니다. 모든 값은 수동으로 채우거나 다른 데이터 요소를 사용할 수 있습니다.

노트

수집하고자 하는 정보는 단지 작성할 필요가 있다. 채워지지 않은 모든 내용은 데이터가 솔루션으로 전송될 때 무시됩니다.

이 페이지에서는