설명서 Experience Platform Target을 at.js 2.x에서 Web SDK로 마이그레이션

Platform Web SDK에 대한 at.js 비교

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

주제:

작성 대상:

중간
경험
개발자

독립형 Adobe Target at.js 라이브러리는 Platform Web SDK와 크게 다릅니다. 다음 표는 마이그레이션 프로세스 중에 초점을 두어야 할 구현 영역을 평가하는 데 도움이 되는 참조입니다.

아래 정보를 검토하고 현재 기술 at.js 구현을 평가한 후 다음을 이해할 수 있어야 합니다.

Platform Web SDK에서 지원하는 Target 기능
Platform Web SDK에 해당하는 at.js 함수가 있는 함수
Target 설정을 Platform Web SDK에 적용하는 방법
at.js와 Platform Web SDK의 데이터 흐름이 서로 다른 방식

Platform Web SDK를 처음 사용하는 경우 걱정하지 마십시오. 아래 항목은 이 자습서 전체에서 자세히 다룹니다.

기능 비교

Target at.js 2.x

Platform Web SDK

Target 프로필 업데이트

지원됨

SPA에 대한 트리거 보기

지원됨

Target Recommendations

지원됨

양식 기반 오퍼 가져오기

지원됨

이벤트 추적

지원됨

A4T: 단일 페이지 애플리케이션

지원됨

A4T: 클릭 추적

지원됨

A4T: 클라이언트측 로깅

지원됨

A4T: 서버측 로깅

지원됨

오퍼 적용

지원됨

알림 없이 SPA에서 보기 다시 렌더링

지원됨

하이브리드 애플리케이션

지원됨

QA URL

지원됨

Mbox 타사 ID

지원됨

고객 속성

지원됨

원격 오퍼

지원됨

리디렉션 오퍼

지원됨

지원됨. 그러나 Platform Web SDK가 있는 페이지에서 at.js가 있는 페이지(및 반대 방향)로의 리디렉션은 지원되지 않습니다.

온디바이스 의사 결정

지원됨

현재 지원되지 않음

Mbox 미리 가져오기

사용자 지정 범위 및 SPA VEC에 대해 지원됨

미리 가져오기는 웹 SDK의 기본 모드입니다.

사용자 지정 이벤트

지원됨

지원되지 않습니다. 현재 상태는 공개 로드맵을 참조하세요.

응답 토큰

지원됨

지원됨. at.js와 Platform Web SDK의 코드 예제 및 차이점에 대해서는 전용 응답 토큰 설명서를 참조하십시오

데이터 공급자

지원됨

지원되지 않습니다. 사용자 지정 코드는 다른 공급자에서 데이터를 검색한 후 Platform Web SDK sendEvent 명령을 트리거하는 데 사용할 수 있습니다.

주목할 만한 설명선

Target at.js 2.x

Platform Web SDK

플리커 완화

비동기 구현을 위한 코드 조각 사전 숨김에서 at-body-style의 스타일 ID를 사용합니다. at.js는 응답이 수신된 후 스타일을 제거하기 위해 이 요소 ID를 찾습니다.

기본 코드 조각 사전 숨김은 alloy-prehiding의 스타일 ID를 사용합니다. 웹 SDK는 at.js 코드 조각 사전 숨김과 호환되지 않으므로 마이그레이션 프로세스의 일부로 변경해야 합니다.

페이지 로드 시 자동으로 콘텐츠 렌더링

Target 전역 설정으로 제어됩니다. pageLoadEnabled이(가) true(으)로 설정된 경우 활성화됩니다.

Platform Web SDK sendEvent 명령에 지정되었습니다. renderDecisions 옵션을 true(으)로 설정하여 사용할 수 있습니다.

수동으로 컨텐츠 렌더링

applyOffer() 및 applyOffers() 함수는 HTML 설정만 지원합니다.

applyPropositions 명령은 유연성을 높이기 위해 HTML 설정, 바꾸기 또는 추가를 지원합니다

사용자 지정 이벤트 추적

trackEvent() 및 sendNotifications() 함수로 지원됩니다. 이러한 함수는 Target에만 해당되며 Adobe Analytics 지표에 영향을 주지 않습니다.

Platform 웹 SDK sendEvent 호출의 모든 데이터가 Target으로 전달됩니다. Adobe Analytics 지표가 영향을 받지 않도록 하려면 Target에 특별히 필요한 보조 데이터를 eventType이 decisioning.propositionDisplay 또는 decisioning.propositionInteract인 sendEvent 명령에 포함해야 합니다.

대상 CNAME

지원됨. 이는 Analytics에 사용되는 CNAME 및 Experience Cloud ID 서비스와 별개입니다.

더 이상 관련이 없습니다. 모든 Platform 웹 SDK 호출에 단일 CNAME을 사용할 수 있습니다.

디버깅

mboxDisable, mboxDebug 및 mboxTrace URL 매개 변수는 브라우저의 개발자 도구를 사용하여 디버깅하는 데 사용할 수 있습니다.

Adobe Experience Platform Debugger은 지원되는 디버깅 도구이기도 합니다.

mboxDisable, mboxDebug 및 mboxTrace URL 매개 변수는 지원되지 않습니다.

쿼리 문자열에 alloy_debug=true을(를) 추가하거나 개발자 콘솔에서 alloy("setDebug", { "enabled": true });을(를) 실행하여 웹 SDK 디버깅을 설정할 수 있습니다.

Adobe Experience Platform Debugger 브라우저 확장을 사용하여 디버깅을 위한 Edge 추적을 시작할 수 있습니다.

자세한 내용은 Platform Web SDK 디버깅 설명서를 참조하십시오.

Analytics for Target (A4T)

SDID 값을 사용하여 Target 및 Analytics 호출 연결

연결할 필요 없이 기본적으로 지원됨

NOTE

지정된 페이지에 대한 기존 AppMeasurement Adobe Analytics 구현을 유지하면서 Target을 Platform Web SDK로 마이그레이션하는 기능은 지원되지 않습니다.

at.js(및 AppMeasurement.js) 구현을 Platform Web SDK에 한 번에 한 페이지씩 마이그레이션할 수 있습니다. 이 방법을 사용하는 경우 configure 명령을 사용하여 idMigrationEnabled 및 targetMigrationEnabled 옵션을 true(으)로 설정하는 것이 좋습니다.

at.js 함수 및 이에 상응하는 Platform Web SDK

많은 at.js 함수에는 아래 표에 설명된 Platform Web SDK를 사용하는 것과 동일한 접근 방식이 있습니다. at.js 함수에 대한 자세한 내용은 Adobe Target 개발자 안내서를 참조하십시오.

at.js 2.x 함수

Platform Web SDK에 해당하는 함수

getOffer() 및 getOffers()

Target VEC 기반 경험을 요청하고 자동으로 렌더링하려면 sendEvent 명령을 사용하고 renderDecisions 옵션을 true로 설정하십시오.

양식 기반 경험을 요청하거나 수동으로 렌더링 콘텐츠를 요청하려면 sendEvent 명령을 사용하여 decisionScopes(mbox)의 배열을 지정하십시오.

applyOffer() 및 applyOffers()

콘텐츠를 적용하려면 applyPropositions 명령을 사용하십시오. 특정 선택기에 HTML을 설정, 대체 또는 추가하도록 선택할 수 있습니다.

triggerView()

sendEvent 명령의 xdm 옵션 아래에 web.webPageDetails.viewName 속성이 설정된 경우 SPA VEC를 위해 Platform Web SDK에서 보기 변경을 자동으로 트리거합니다.

trackEvent() 및 sendNotifications()

sendEvent 명령을 특정 eventType 집합과 함께 사용하면:

decisioning.propositionDisplay 활동을 렌더링한다는 신호를 보냅니다

decisioning.propositionInteract 마우스 클릭과 같은 활동과 사용자 상호 작용을 한다는 신호를 보냅니다.

targetGlobalSettings()

직접 동등 항목 없음. 자세한 내용은 대상 설정 비교를 참조하세요.

targetPageParams() 및 targetPageParamsAll()

sendEvent 명령의 xdm 옵션에서 전달된 모든 데이터가 Target mbox 매개 변수에 매핑됩니다. mbox 매개 변수는 직렬화된 점 표기법을 사용하여 이름이 지정되므로 Platform Web SDK로 마이그레이션하려면 기존 대상과 활동을 업데이트하여 새 mbox 매개 변수 이름을 사용해야 할 수 있습니다. sendEvent 명령의 data.__adobe.target 일부로 전달된

데이터가 Target 프로필 및 Recommendations 특정 매개 변수에 매핑됩니다.

at.js 사용자 지정 이벤트

지원되지 않습니다. 현재 상태는 공개 로드맵을 참조하세요. 응답 토큰이 sendEvent 호출의 응답에서 propositions의 일부로 노출됩니다.

at.js 설정 및 이에 해당하는 Platform Web SDK

Target UI의 다양한 설정을 사용하여 at.js 라이브러리를 구성하고 다운로드할 수 있습니다. 이러한 설정은 targetGlobalSettings() 함수로 업데이트할 수도 있습니다. 아래 표는 이러한 설정을 Platform Web SDK에서 사용할 수 있는 설정과 비교합니다.

at.js 설정

Platform Web SDK에 해당하는 함수

bodyHiddenStyle

configure 명령을 사용하여 prehidingStyle 설정

bodyHidingEnabled

configure 명령으로 prehidingStyle이(가) 정의된 경우 이 기능을 사용할 수 있습니다. 스타일이 정의되지 않은 경우 Platform Web SDK는 콘텐츠를 숨기지 않습니다.

clientCode

자동으로 구성됨

cookieDomain

적용할 수 없음

crossDomain

configure 명령을 사용하여 thirdPartyCookiesEnabled 옵션을 true(으)로 설정하여 도메인 간 사용 사례에 대해 자사 및 서드파티 쿠키를 사용하도록 설정합니다.

cspScriptNonce 및 cspStyleNonce

CSP 구성에 대한 설명서를 참조하세요.

dataProviders

지원되지 않음

decisioningMethod

모든 Platform Web SDK sendEvent 명령은 서버측 의사 결정을 사용합니다. 하이브리드 및 온디바이스 의사 결정은 지원되지 않습니다.

defaultContentHiddenStyle 및 defaultContentVisibleStyle

at.js 1.x에서만 적용할 수 있습니다. at.js 2.x와 마찬가지로, 양식 기반 경험에 대한 플리커 완화는 사용자 지정 코드를 사용하여 수행할 수 있습니다.

deviceIdLifetime

지원되지 않습니다. configure 명령을 사용하여 targetMigrationEnabled을(를) true(으)로 설정하면 장치 수명이 2년으로 설정된 mbox 쿠키가 설정됩니다. 이 값은 구성할 수 없습니다.

enabled

대상 기능은 데이터 스트림 구성으로 활성화되거나 비활성화됩니다.

globalMboxAutoCreate

VEC 기반 경험을 자동으로 가져오고 렌더링하려면 sendEvent 명령을 사용하여 renderDecisions 옵션을 true(으)로 설정하십시오.VEC 기반 경험을 수동으로 렌더링하려면

__view__에 대해 decisionScope을(를) 요청합니다.

imsOrgId

configure 명령으로 orgId 설정

optinEnabled 및 optoutEnabled

Platform Web SDK 개인 정보 보호 옵션을 참조하세요. defaultConsent 옵션은 Platform Web SDK에서 지원하는 모든 Adobe 솔루션에 적용됩니다.

overrideMboxEdgeServer 및 overrideMboxEdgeServerTimeout

해당 사항 없음. 모든 Platform Web SDK 요청은 Adobe Experience Platform Edge 네트워크를 사용합니다.

pageLoadEnabled

sendEvent 명령을 사용하여 renderDecisions 옵션을 true(으)로 설정

secureOnly

지원되지 않습니다. Platform Web SDK는 secure 및 sameSite="none" 특성이 있는 모든 쿠키를 설정합니다.

selectorsPollingTimeout

지원되지 않습니다. Platform Web SDK는 5초 값을 사용합니다. 필요한 경우 사용자 지정 코드를 사용하여 콘텐츠를 수동으로 렌더링할 수 있습니다.

serverDomain

configure 명령과 함께 edgeDomain 설정 사용

telemetryEnabled

적용할 수 없음

timeout

지원되지 않습니다. 깜박임 완화 코드에 적절한 시간 제한이 포함되어 있는지 확인하는 것이 좋습니다.

viewsEnabled

지원되지 않습니다. renderDecisions이(가) true(으)로 설정되어 있거나 __view__ decisionScope가 요청에 포함된 경우 Target 보기의 콘텐츠를 항상 첫 번째 sendEvent() 호출 시 가져옵니다.

visitorApiTimeout

적용할 수 없음

시스템 다이어그램 비교

다음 다이어그램은 at.js를 사용하는 Target 구현과 Platform Web SDK를 사용하는 구현 간의 데이터 흐름 차이를 이해하는 데 도움이 됩니다.

at.js 2.x 시스템 다이어그램

페이지 로드 시 at.js 2.0 동작 {modal="regular"}

호출

세부 정보

호출이 ECID(Experience Cloud ID)를 반환합니다. 사용자가 인증되면 다른 호출이 고객 ID를 동기화합니다.

at.js 라이브러리는 동기식으로 로드되며 문서 본문을 숨깁니다(at.js는 페이지에 구현된 코드 조각을 미리 숨기는 선택 사항을 사용하여 비동기식으로 로드할 수도 있습니다).

모든 구성된 매개 변수, ECID, SDID 및 고객 ID를 포함하는 페이지 로드 요청이 이루어집니다.

프로필 스크립트가 실행되어 프로필 스토어에 반영됩니다. 저장소는 대상 라이브러리의 적절한 대상(예: Analytics, Audience Manager 등에서 공유되는 대상)을 요청합니다. 고객 속성은 묶음 프로세스를 통해 프로필 저장소로 전송됩니다.

Target에서는 URL, 요청 매개 변수 및 프로필 데이터를 기반으로 현재 페이지 및 미래 보기를 위해 방문자에게 반환할 활동 및 경험을 결정합니다.

타깃팅된 컨텐츠를 다시 페이지로 전송하며, 원할 경우 추가적인 개인화를 위한 프로필 값을 포함할 수 있습니다.

현재 페이지의 타깃팅된 콘텐츠는 기본 콘텐츠의 플리커 없이 가능한 한 빨리 나타납니다.

단일 페이지 응용 프로그램의 미래 보기를 위한 타깃팅된 콘텐츠가 브라우저에 캐시되므로 보기가 트리거될 때 추가적인 서버 호출 없이 즉시 적용될 수 있습니다.

페이지에서 데이터 수집 서버로 전송된 Analytics 데이터.

Target 데이터는 SDID를 통해 Analytics 데이터에 대응되며 Analytics 보고 저장소로 처리됩니다. 그런 다음 Analytics 데이터는 A4T 보고서를 통해 Analytics 및 Target 모두에서 볼 수 있게 됩니다.

단일 페이지 애플리케이션용 at.js를 사용하여 Target을 구현하는 방법에 대한 자세한 내용은 개발자 안내서를 참조하십시오.

Platform Web SDK 시스템 다이어그램

Platform Web SDK를 사용한 Adobe Target Edge 의사 결정 다이어그램

호출

세부 정보

디바이스가 Platform Web SDK를 로드합니다. Platform Web SDK는 XDM 데이터, 데이터스트림 환경 ID, 전달된 매개 변수 및 고객 ID(선택 사항)를 사용하여 Edge Network에 요청을 보냅니다. 페이지(또는 컨테이너)가 미리 숨겨져 있습니다.

Edge 네트워크는 Edge 서비스에 요청을 전송하여 방문자 ID, 동의와 지리적 위치 및 장치 친화적 이름과 같은 기타 방문자 컨텍스트 정보로 보강합니다.

Edge 네트워크는 방문자 ID 및 전달된 매개 변수와 함께 보강된 개인화 요청을 Target Edge로 보냅니다.

프로필 스크립트가 실행된 다음 Target 프로필 저장소에 반영됩니다. 프로필 저장소는 대상 라이브러리의 세그먼트(예: Adobe Analytics, Adobe Audience Manager, Adobe Experience Platform에서 공유된 세그먼트)를 가져옵니다.

Target은 URL 요청 매개 변수 및 프로필 데이터를 기반으로 현재 페이지 보기 및 향후 프리페치된 보기에 대해 방문자에게 표시할 활동 및 경험을 결정합니다. 그러면 Target이 이를 다시 에지 네트워크로 보냅니다.

a. 에지 네트워크는 추가적인 개인화를 위한 프로필 값을 선택적으로 포함하여 개인화 응답을 다시 페이지로 전송합니다. 현재 페이지의 개인화된 콘텐츠는 기본 콘텐츠의 플리커 없이 가능한 한 빨리 나타납니다.

b. SPA(단일 페이지 애플리케이션)에서 사용자 작업의 결과로 표시되는 보기를 위한 개인화된 콘텐츠는 추가 서버 호출 없이 즉각적인 렌더링을 위해 캐시됩니다.

c입니다. Edge 네트워크는 방문자 ID와 쿠키의 다른 값(예: 동의, 세션 ID, ID, 쿠키 확인, 개인화 등)을 전송합니다.

에지 네트워크는 Analytics for Target(A4T) 세부 사항(활동, 경험 및 전환 메타데이터)을 Analytics 에지로 전달합니다.

단일 페이지 애플리케이션용 Platform Web SDK를 사용하여 Target을 구현하는 방법에 대한 자세한 내용은 개발자 안내서를 참조하십시오.

현재 Target 구현과 사용 중인 기능에 대한 기술적인 이해를 완료한 후 다음 단계는 초기 설정을 수행하는 것입니다.

NOTE

at.js에서 Web SDK로 Target을 성공적으로 마이그레이션할 수 있도록 지원하기 위해 최선을 다하고 있습니다. 마이그레이션에 문제가 발생하거나 이 안내서에 중요한 정보가 누락된 것 같은 느낌이 드는 경우 이 커뮤니티 토론에 게시하여 알려 주십시오.

recommendation-more-help

a69e1b51-9545-4d8a-822d-319242c29110