[Alpha]{class="badge informative"}

웹 SDK과의 차이점

마지막 업데이트: 2026년 10월 30일

주제:
Data Collection

작성 대상:

Developer

Server SDK과 Web SDK은(는) 동일한 코어를 공유하므로 동일한 형식의 데이터를 동일한 데이터 스트림으로 보내고 동일한 쿠키를 사용합니다. 하나는 서버에서 실행되고 다른 하나는 브라우저에서 실행되므로 여러 가지 면에서 다릅니다. 이 페이지에서는 마이그레이션을 계획하거나 브라우저와 서버 구현 간에 코드를 공유할 수 있습니다.

비교 comparison

영역

Web SDK

서버 SDK

실행 위치

방문자의 브라우저

Node.js 또는 다른 서버측 JavaScript 런타임에서의 서버입니다. 런타임 지원을 참조하십시오.

설치

태그 확장, JavaScript 라이브러리 또는 @adobe/alloy npm 패키지

@adobe/alloy-node npm 패키지. 설치를 참조하십시오.

그걸 어떻게 부를까

alloy("sendEvent", { ... })

alloy.sendEvent({ ... }). 메서드 개요를 참조하십시오.

인스턴스

페이지 로드당 한 개, 방문자 한 명에게 제공

프로세스당 1개, 각 방문자 요청에 대해 forRequest 핸들 추가

인증

없음

필수 여부. 이벤트는 인증된 Edge Network 서버 API로 이동합니다. 인증을 참조하세요.

브라우저 쿠키에서 자동으로 읽고 쓸 수 있습니다

에서 읽고 사용자가 제공하는 쿠키 서비스에 씁니다. 모든 이벤트에는 기본 ID가 필요합니다.

동의

defaultConsent이(가) "in", "out" 및 "pending"을(를) 수락합니다.

defaultConsent이(가) "in" 및 "out"만 수락

개인화

제안 표시 요청, 렌더링 및 추적

제안을 요청하고 반환합니다. 렌더링하거나 표시를 추적하지 않습니다.

컨텍스트 데이터

브라우저의 페이지, 장치, 환경, 장소 및 클라이언트 힌트 세부 정보

구현 세부 정보, 방문자의 전달된 요청 헤더 및 Referer 헤더의 페이지 URL. 컨텍스트 및 전달된 헤더를 참조하십시오.

sendEvent개 결과

propositions, inferences 및 destinations

propositions

디버깅

debugEnabled, setDebug, alloy_debug 쿼리 문자열 매개 변수 및 Adobe Experience Platform Debugger

debugEnabled 및 setDebug(콘솔에 기록된 메시지 포함)

후크 모니터링

monitors 옵션 및 __alloyMonitors 전역 변수

createInstance의 monitors 옵션

메서드에서 사용할 수 있습니다 methods

Server SDK에서 웹 SDK에 없는 forRequest 메서드를 추가합니다.

appendIdentityToUrl, applyResponse, configure, getIdentity, getLibraryInfo, sendEvent, setConsent 및 setDebug 웹 SDK 명령을 메서드로 지원합니다.

다음 웹 SDK 명령은 브라우저나 서버 SDK에 포함되지 않은 구성 요소에 따라 달라지므로 사용할 수 없습니다.

applyPropositions
createMediaSession
getMediaAnalyticsTracker
sendMediaEvent
sendPushSubscription
subscribeRulesetItems

구성 옵션 configuration

신규 및 필수: edgeCredentials.
지원됨: datastreamId, orgId, debugEnabled, defaultConsent, edgeBasePath, edgeConfigOverrides, edgeDomain, idMigrationEnabled, onBeforeEventSend 및 thirdPartyCookiesEnabled. 이러한 기능 중 일부는 서버에서 다르게 동작합니다. 각 옵션의 페이지를 참조하십시오.
지원되지 않음: 다른 모든 웹 SDK 옵션입니다. 하나를 포함하면 configure이(가) 거부합니다. 서버 SDK에서 지원하지 않는 옵션을 참조하세요.

sendEvent 옵션 sendevent

지원됨: xdm, data, type, personalization.decisionScopes 및 personalization.surfaces, 최상위 decisionScopes 배열 및 edgeConfigOverrides.
수락되었지만 영향을 주지 않음: renderDecisions, advertising 및 기타 personalization 속성. 서버에 영향을 주지 않는 옵션을 참조하세요.
방지: documentUnloading.

자주 묻는 질문 faq

동일한 웹 사이트에서 Server SDK 및 Web SDK을 사용할 수 있습니까? same-site

예. 일반적인 패턴은 서버에서 개인화를 요청하고 브라우저에서 렌더링하는 것입니다. 하이브리드 개인화를 참조하세요. 액세스 형식이(가) 혼합 인증인 경우 두 라이브러리가 동일한 데이터 스트림으로 데이터를 보낼 수 있습니다. 둘 다 ID와 동의에 동일한 쿠키 이름을 사용합니다.

모든 이벤트에 기본 ID가 필요한 이유는 무엇입니까? primary-identity

Server SDK은 인증된 Edge Network Server API에 이벤트를 전송합니다. 요청을 서버에서 받기 때문에 Edge Network은 방문자의 브라우저 쿠키를 사용하여 이를 식별할 수 없습니다. 대신 이벤트에 기본 ID가 필요합니다. xdm을(를) 참조하십시오.

서버리스 기능에서 서버 SDK을 사용할 수 있습니까? serverless

예. 함수의 런타임이 요구 사항을(를) 충족하면 가능합니다. 함수 처리기 외부의 모듈의 최상위 수준에서 인스턴스를 만들고 구성합니다. 이러한 방식으로 웜 호출은 구성된 인스턴스와 캐시된 액세스 토큰을 재사용합니다. 각 호출에 대한 처리기 내에서 forRequest을(를) 호출합니다.

Adobe Experience Platform Debugger을 사용할 수 있습니까? debugger

아니요. Adobe Experience Platform Debugger은 페이지를 검사하는 브라우저 확장 프로그램입니다. 서버 SDK을 디버깅하려면 debugEnabled을(를) true(으)로 설정하거나 setDebug을(를) 호출하고 서버의 콘솔 출력을 검토하십시오.

recommendation-more-help

experience-platform-help-collection