자주 묻는 질문

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

작성 대상:

개발자

이 안내서에서는 Adobe Experience Platform 웹 SDK에 대해 자주 묻는 질문에 대한 답변을 제공합니다.

Adobe Experience Platform 웹 SDK란 무엇입니까?

Adobe Experience Platform Web SDK는 Adobe Experience Cloud의 다양한 서비스와 상호 작용할 수 있는 클라이언트측 JavaScript 라이브러리입니다.

Web SDK는 솔루션과 관계없는 방식(XDM)으로 데이터를 Experience Platform Edge Network에 전송한 다음, 해당 데이터를 솔루션별 형식 및 대상에 매핑하고 실시간으로 전송합니다.

Web SDK에 대한 자세한 내용은 다음 비디오를 참조하십시오. eVar 또는 Mbox에 대해 Alloy.js를 만나고 태그를 다시 사용하지 않음.

Adobe Experience Platform 웹 SDK는 이전 솔루션과 어떻게 다릅니까?

Web SDK Experience Platform 전

현재 각 개별 솔루션을 기반으로 서로 다른 JavaScript 라이브러리를 배포해야 합니다.

각 솔루션에는 자체 JavaScript 라이브러리, 스키마 및 도메인이 있습니다.
이러한 라이브러리는 서로 작동하도록 빌드되지 않았습니다.
솔루션 간 및 Adobe Experience Platform 사용 사례에서는 이러한 서로 다른 라이브러리가 상호 종속되어 배포 마찰을 일으킵니다.

Platform의 태그를 사용하여 이러한 라이브러리를 최대한 쉽게 배포 및 관리할 수 있지만 여전히 다음과 같은 문제가 있습니다.

라이브러리 크기(페이지에 Adobe 코드가 너무 많음)
성능(사이트 로드 시간이 너무 오래 걸림)
단일 사용 사례에 대한 여러 호출
개인화 호출 전에 ECID 반환 대기 중(지연 발생)
분리된 데이터 수집(evar란 무엇입니까?)
솔루션 간 스키마 혼동(A4T)
다른 덜 최적의 많은 것들

또한 현재 Adobe Experience Platform으로 데이터를 직접 전송하는 JavaScript 라이브러리는 없습니다.

Web SDK Experience Platform

새로운 Web SDK는 다음 솔루션에 대한 데이터를 단일 대상(Experience Platform Edge Network)으로 전송하고 위에서 언급한 가장 일반적인 솔루션 사용 사례를 해결합니다.

Adobe Analytics
Adobe Audience Manager
Adobe Target
방문자 ID
Adobe Experience Platform

다른 해결 방법도 함께 제공됩니다.

Adobe Experience Platform Web SDK는 Adobe Experience Platform으로 직접 데이터를 전송할 수도 있습니다. 이 데이터는 XDM 형식이며 서버측 솔루션 스키마에 매핑됩니다.

이 새로운 웹 SDK의 가치는 무엇입니까?

성능: 웹 SDK는 현재 Adobe 라이브러리를 모두 사용하는 것보다 작고 훨씬 빠른 페이지 로드를 제공합니다.

단순성: XDM, Web SDK, 태그, Edge Network, Adobe Experience Cloud 솔루션 및 Adobe Experience Platform의 결합으로 이해하기 쉽고 따라하기 쉬운 데이터 수집 스토리가 만들어집니다.

XDM: Adobe에 데이터를 보내는 데 사용하는 솔루션과 관계없는 스키마입니다. evar 또는 mbox에 대해 더 이상 태깅하지 않습니다.
Web SDK: Adobe Experience Platform Edge Network으로 데이터를 쉽게 보내고 받을 수 있습니다.
태그: 사이트에서 Web SDK(및 기타 JavaScript 태그)를 배포하고 구성하는 작업을 간소화합니다.
Edge Network: 데이터를 필요한 형식으로 Adobe Experience Platform 및 솔루션에 쉽게 라우팅합니다.
Adobe Experience Platform 및 Adobe 솔루션: 가치 제안을 사용하도록 설정합니다.

제어: 모든 데이터는 연결된 단일 데이터 스트림을 사용하므로 응용 프로그램과 여정의 매 밀리초 단위로 데이터의 모양을 논리적으로 추적하고 제어할 수 있습니다.

현대적이고 미래 준비: Web SDK와 Edge Network에 대한 연결을 통해 Adobe은 Adobe에서 데이터 수집, 개인화, 동의 및 서드파티 쿠키의 미래를 처리하는 방식을 크게 현대화할 수 있습니다. (Adobe에서 관리하는 자사 도메인을 활성화합니다.)

값 지정 시간: Adobe이 태그를 통해 Web SDK를 배포하고 클라이언트측 데이터를 XDM에 매핑하기 위해 최대한 노력했습니다(계속). 이 작업이 완료되면 다른 모든 Adobe 솔루션 및 Adobe Experience Platform 서비스를 서버측에서 켜거나 끌 수 있습니다. 예를 들어, Adobe Analytics에 대해 이 기능을 사용 중이며 Target 또는 Experience Platform을 켜려는 경우 데이터 스트림 구성에 대한 토글을 전환하고 해당 사용 사례를 켤 수 있습니다.

alloy.js (이)란?

alloy.js은(는) 웹 SDK JavaScript 라이브러리의 이름입니다. SDK 소스 코드 및 파일 이름 내에서 참조됩니다.

고객이 Web SDK을(를) 사용하려면 Adobe Experience Platform을 구입해야 합니까?

아니요. 모든 Adobe Digital Experience 고객은 Adobe Experience Platform Web SDK를 무료로 사용할 수 있습니다. Web SDK을(를) 사용하려는 고객은 데이터 수집 UI 또는 Experience Platform UI에서 스키마, 데이터 세트, ID 네임스페이스 및 데이터 스트림을 만드는 올바른 권한을 구성해야 합니다.

이러한 권한을 구성하는 방법에 대한 자세한 내용은 데이터 수집 권한 관리에 대한 설명서를 참조하십시오.

웹 SDK는 누가 사용해야 합니까?

Adobe Experience Platform Web SDK는 다음 고객을 위해 개발되었습니다.

Adobe Experience Platform 사용자
- 장치에서 Adobe Experience Platform으로 직접 데이터를 전송해야 하는 경우 이렇게 하는 것이 좋습니다.
- Adobe은 Adobe Analytics이 이미 있는 경우 Adobe Analytics 커넥터를 사용하는 것이 더 빠르다는 것을 알고 있지만, 데이터 수집을 위한 장기적인 전략은 아닙니다.
Adobe Experience Cloud 솔루션 고객
- 새 Adobe Analytics, Adobe Audience Manager 및 Adobe Target 고객은 기존 라이브러리를 사용하지 말고 새 Web SDK로 시작해야 합니다.
- 최대한 최적화된 구현을 얻고자 하는 기존 고객은 새로운 웹 SDK를 사용해야 합니다.

웹 SDK에 액세스하려면 어떻게 합니까?

Web SDK는 현재 일반 사용자가 사용할 수 있으며 Adobe Experience Cloud 제품으로 데이터를 전송하는 데 사용할 수 있습니다. 데이터를 서드파티 솔루션으로 보낼 수 있는 기능은 가까운 미래에 제공될 예정입니다.

SDK는 무료이며, Adobe에서 무료로 호스팅합니다. 필요한 경우 무료로 다운로드하여 자체 서버에 호스팅할 수 있습니다.

Adobe 서버가 SDK에서 들어오는 인바운드 데이터를 제대로 처리하려면 Web SDK에서 데이터스트림 구성 및 Experience Platform XDM 스키마 빌더에 액세스해야 합니다. 액세스 권한을 얻으려면 Adobe 계정 팀에 연락하여 요청 프로세스를 시작하십시오.

현재 웹 SDK에서 지원되는 사용 사례는 무엇입니까?

Web SDK는 빠르게 발전하고 있습니다. 더 많은 사용 사례가 진행 중입니다. 여기에서 현재 지원되는 사용 사례 목록을 찾을 수 있습니다.

현재 고객은 사이트에 태그를 다시 지정해야 합니까?

상황에 따라 다릅니다. Adobe Experience Platform Web SDK는 두 가지 스타일로 배포할 수 있습니다. 향후 마이그레이션 문서에서는 추가 세부 정보가 제공됩니다.

다른 태그만 추가: 사이트에 이미 솔루션에 대한 태그가 지정되어 있어 다시 태그를 지정할 수 없지만 Experience Platform 사용 사례 또는 예정된 이벤트 전달 기능(아래 참조)을 위해 Adobe Experience Platform Edge Network에 데이터를 전송하려는 경우 alloy.js 태그를 사이트에 추가할 수 있습니다. 여기서 이 태그는 "다른 태그"로 작동합니다.
유일한 태그: Experience Cloud 솔루션에 Web SDK를 사용하려면 해당 페이지의 솔루션 중 모두 에 사용해야 합니다. 예를 들어 사이트에 이미 Adobe Analytics에 대한 태그가 지정되어 있고 이 태그를 Target에 사용하려면 두 사이트뿐만 아니라 향후 다른 사이트에도 태그를 사용해야 합니다.

즉, 솔루션이 아닌 사용 사례에 Adobe Experience Platform Web SDK를 사용하려는 경우 alloy.js(으)로 사이트에 태그를 지정하고 새로운 솔루션인 것처럼 계속 진행할 수 있습니다. Adobe Analytics, Target 또는 Audience Manager에 사용하거나 애플리케이션 사용 사례에 사용하려는 경우 페이지에서 기존 코드를 제거해야 할 수 있습니다.

웹 SDK를 사용할 때 웹 사이트 방문자가 새 방문자로 표시되지 않도록 ECID를 마이그레이션할 수 있습니까?

예. Adobe Experience Platform Web SDK는 ID 마이그레이션 기능을 제공합니다. 자세한 내용은 Platform Web SDK ID 설명서의 ID 마이그레이션에 대한 지침을 따르십시오.

웹 SDK는 태그와 어떻게 다릅니까?

Experience Platform의 태그 에서 장치 코드를 관리합니다. 이를 사용하여 코드를 보다 쉽게 배포할 수 있습니다. 그것들은 자유롭고 강력합니다.
Adobe Experience Platform Web SDK 은(는) Adobe 사용 사례에 대해 태그에 의해 배포되는 새 코드의 공식 이름입니다. 또한 자유롭고 강력합니다.
alloy.js 은(는) Adobe Experience Platform 웹 SDK 코드의 파일 이름입니다.

Web SDK를 배포하려면 태그를 사용해야 합니까?

아니요. alloy.js 파일을 직접 다운로드할 수 있습니다.

그러나:

Adobe Experience Platform Web SDK에는 Edge Network가 스트림을 식별하고 데이터로 수행할 작업을 결정할 수 있도록 데이터 스트림 ID라는 것이 필요합니다. 이 ID는 Experience Platform 내에 만들어집니다. 즉, UI를 사용하여 속성을 만들거나 JavaScript 코드를 배포해야 하는 것은 아니지만, 태그를 사용하여 구성 ID를 만들어야 합니다.
태그는 최고의 사용 가능한 태그 및 SDK 관리자일 뿐만 아니라 alloy.js을(를) 배포하고 데이터를 XDM 스키마에 매핑하는 것도 매우 쉽습니다. 태그를 사용하지 않기로 결정한 경우 전송하기 전에 배포 alloy.js, 이벤트 및 XDM에 대한 데이터 매핑을 관리해야 합니다. 태그를 사용하는 것보다 훨씬 더 어려운 프로세스입니다.
alloy.js을(를) 배포하는 데 태그를 사용하는 것이 좋습니다.

이벤트 전달이란?

SDK를 사용하고 XDM을 Edge Network에 전송하는 경우 이러한 새로운 기능 이벤트 전달을 사용하여 새로운 서버측 확장을 설치하고 데이터를 Edge Network의 어디에나 매핑하고 전송할 수 있습니다. 이를 "서비스로서의 데이터 수집"으로 간주합니다. 이 기능은 Adobe Experience Platform의 일부로 번들로 제공될 뿐 아니라, 추가 비용으로 사용할 수 있습니다.

CNAME 또는 자사 도메인이란 무엇이며 이것이 중요한 이유는 무엇입니까?

CNAME에 대한 자세한 내용은 Adobe 설명서를 참조하세요.

Adobe Experience Platform 웹 SDK에서 쿠키를 사용합니까? 그렇다면 어떤 쿠키를 사용합니까?

예. 현재 Web SDK는 구현에 따라 1개에서 7개 사이의 쿠키를 사용합니다. 다음은 웹 SDK에서 볼 수 있는 쿠키와 쿠키 사용 방법의 목록입니다.

이름

maxAge

친숙한 나이

설명

kndct_orgid_identity

34128000

395일

ID 쿠키는 ECID와 ECID와 관련된 기타 정보를 저장합니다.

kndctr_orgid_consent_check

7200

2시간

이 세션 기반 쿠키는 서버에서 동의 환경 설정 서버측을 조회하도록 신호를 보냅니다.

kndctr_orgid_consent

15552000

180일

이 쿠키는 웹 사이트에 대한 사용자의 동의 기본 설정을 저장합니다.

kndctr_orgid_cluster

1800

30분

이 쿠키는 현재 사용자의 요청을 제공하는 Edge Network 영역을 저장합니다. Edge Network이 요청을 올바른 영역으로 라우팅할 수 있도록 URL 경로에 영역이 사용됩니다. 이 쿠키에는 30분의 라이프타임이 있으므로 사용자가 다른 IP 주소와 연결하는 경우 요청을 가장 가까운 영역으로 라우팅할 수 있습니다.

mbox

63072000

2년

이 쿠키는 Target 마이그레이션 설정이 true로 설정된 경우에 나타납니다. 이렇게 하면 웹 SDK에서 Target mbox 쿠키를 설정할 수 있습니다.

mboxEdgeCluster

1800

30분

이 쿠키는 Target 마이그레이션 설정이 true로 설정된 경우에 나타납니다. 이 쿠키를 사용하면 Web SDK가 올바른 에지 클러스터를 at.js에 전달할 수 있으므로, 사용자가 사이트를 탐색할 때 Target 프로필이 동기화 상태를 유지할 수 있습니다.

AMCV_###@AdobeOrg

34128000

395일

이 쿠키는 Adobe Experience Platform Web SDK에서 ID 마이그레이션을 사용하는 경우에만 나타납니다. 이 쿠키는 사이트의 일부가 여전히 visitor.js를 사용하는 동안 Web SDK로 전환할 때 도움이 됩니다. 자세한 내용은 idMigrationEnabled을(를) 참조하십시오.

Web SDK를 사용하는 경우 Edge Network은 위의 쿠키 중 하나 이상을 설정합니다. Edge Network이 secure 및 sameSite="none" 특성이 있는 모든 쿠키를 설정합니다.

현재 웹 사이트에 보안 섹션과 비보안 섹션이 모두 있는 경우 이로 인해 사용자 식별이 방해될 수 있습니다. 사용자가 사이트의 보안 섹션에서 비보안 섹션으로 이동하면 Edge Network은 요청과 함께 새 ECID을(를) 생성합니다.

Adobe Experience Platform Web SDK는 어떤 브라우저를 지원합니까?

Adobe Experience Platform Web SDK는 최신 버전의 Google Chrome, Safari, Firefox, Internet Explorer 11 및 Microsoft Edge Chromium에서 최적으로 작동되도록 설계되었습니다. 이전 버전의 브라우저에서 특정 기능을 사용하는 데 문제가 있을 수 있습니다.

Adobe Experience Platform Web SDK에 대한 자세한 내용은 어디에서 확인할 수 있습니까?

Internet Explorer 지원 support-internet-explore

이 SDK는 비동기 작업의 완료를 통신하는 방법인 약속을 사용합니다. SDK에서 사용하는 Promise 구현은 Internet Explorer을(를) 제외한 모든 대상 브라우저에서 기본적으로 지원됩니다. Internet Explorer에서 SDK를 사용하려면 window.Promise polyfilled가 있어야 합니다.

window.Promise을(를) 이미 채웠는지 확인하려면 다음을 수행하십시오.

Internet Explorer에서 웹 사이트를 엽니다.
브라우저의 디버깅 콘솔을 엽니다.
콘솔에 window.Promise을(를) 입력한 다음 Enter 키를 누릅니다.

undefined 이외의 항목이 나타나면 이미 window.Promise을(를) 채운 것 같습니다. 위의 설치 지침을 완료한 후 웹 사이트를 로드하여 window.Promise이(가) 폴리필되었는지 확인하는 다른 방법입니다. SDK에서 약속에 대해 언급하는 동안 오류가 발생하면 window.Promise을(를) 채우지 않았을 수 있습니다.

window.Promise을(를) 폴리필해야 한다고 결정한 경우 이전에 제공된 기본 코드 위에 다음 스크립트 태그를 포함하십시오.

<script src="https://cdn.jsdelivr.net/npm/promise-polyfill@8/dist/polyfill.min.js"></script>

이 태그는 window.Promise이(가) 올바른 Promise 구현인지 확인하는 스크립트를 로드합니다.

NOTE

다른 Promise 구현을 로드하도록 선택한 경우 Promise.prototype.finally을(를) 지원하는지 확인하십시오.

Internet Explorer 지원

Adobe Experience Platform SDK는 비동기 작업의 완료를 통신하는 방법인 약속을 사용합니다. SDK에서 사용하는 Promise 구현은 Internet Explorer을(를) 제외한 모든 대상 브라우저에서 기본적으로 지원됩니다. Internet Explorer에서 SDK를 사용하려면 window.Promise polyfilled가 있어야 합니다.

폴리필을 약속하는 데 사용할 수 있는 라이브러리 중 하나는 약속 폴리필입니다. NPM으로 설치하는 방법에 대한 자세한 내용은 promise-polyfill 설명서를 참조하세요.

NOTE

다른 Promise 구현을 로드하도록 선택한 경우 Promise.prototype.finally을(를) 지원하는지 확인하십시오.

recommendation-more-help

ad108910-6329-42f1-aa1d-5920a2b13636