[Alpha]{class="badge informative"}

Diferencias con Web SDK

Server SDK y Web SDK comparten el mismo núcleo, por lo que envían datos en el mismo formato a los mismos flujos de datos y utilizan las mismas cookies. Dado que uno se ejecuta en un servidor y el otro en un explorador, difieren en varias formas. Utilice esta página para planificar una migración o para compartir código entre un explorador y una implementación de servidor.

Comparación comparison

Área
SDK web
SDK de servidor
Dónde se ejecuta
El explorador del visitante
El servidor, en Node.js u otro tiempo de ejecución de JavaScript del lado del servidor. Consulte Compatibilidad en tiempo de ejecución.
Instalación
Extensión de etiqueta, biblioteca JavaScript o paquete npm @adobe/alloy
El paquete npm de @adobe/alloy-node. Consulte Instalar.
Cómo lo llamas
alloy("sendEvent", { ... })
alloy.sendEvent({ ... }). Ver descripción general de métodos.
Instancias
Uno por carga de página para un visitante
Uno por proceso, más un identificador de forRequest para cada solicitud de visitante
Autenticación
Ninguno
Requerido. Los eventos van a la API de servidor de Edge Network autenticada. Ver Autenticación.
Identidad
Leer y escribir automáticamente en las cookies del explorador
Leer y escribir en un servicio de cookies proporcionado por el usuario. Cada evento necesita una identidad principal.
Consentimiento
defaultConsent acepta "in", "out" y "pending"
defaultConsent solo acepta "in" y "out"
Personalización
Solicita, procesa y rastrea la visualización de propuestas
Solicita propuestas y las devuelve. No los procesa ni rastrea su visualización.
Datos de contexto
Detalles de página, dispositivo, entorno, ubicación y sugerencia del cliente desde el explorador
Detalles de implementación, los encabezados de solicitud reenviados del visitante y la dirección URL de la página desde el encabezado Referer. Ver Contexto y encabezados reenviados.
sendEvent resultado
propositions, inferences y destinations
propositions
Depuración
debugEnabled, setDebug, el parámetro de cadena de consulta alloy_debug y Adobe Experience Platform Debugger
debugEnabled y setDebug, con mensajes escritos en la consola
Enlaces de monitorización
La opción monitors y la variable global __alloyMonitors
La opción monitors de createInstance

Métodos methods

Server SDK agrega el método forRequest, que no existe en Web SDK.

Admite los siguientes comandos de Web SDK como métodos: appendIdentityToUrl, applyResponse, configure, getIdentity, getLibraryInfo, sendEvent, setConsent y setDebug.

Los siguientes comandos de Web SDK no están disponibles porque dependen de un explorador o de componentes que Server SDK no incluye:

  • applyPropositions
  • createMediaSession
  • getMediaAnalyticsTracker
  • sendMediaEvent
  • sendPushSubscription
  • subscribeRulesetItems

Opciones de configuración configuration

opciones de sendEvent sendevent

Preguntas frecuentes faq

¿Puedo utilizar Server SDK y Web SDK en el mismo sitio web? same-site

Sí. Un patrón común es solicitar la personalización en el servidor y procesarla en el explorador. Consulte Personalización híbrida. Ambas bibliotecas pueden enviar datos al mismo conjunto de datos si su tipo de acceso es autenticación mixta. Ambos utilizan los mismos nombres de cookies para la identidad y el consentimiento.

¿Por qué cada evento necesita una identidad principal? primary-identity

Server SDK envía eventos a la API de servidor de Edge Network autenticada. Como la solicitud proviene del servidor, Edge Network no puede utilizar las cookies del explorador del visitante para identificarlas. En su lugar, requiere una identidad principal en el evento. Ver xdm.

¿Puedo utilizar Server SDK en funciones sin servidor? serverless

Sí, si el tiempo de ejecución de la función cumple los requisitos. Cree y configure la instancia en el nivel superior del módulo, fuera del controlador de funciones. De este modo, las invocaciones cálidas reutilizan la instancia configurada y su token de acceso en caché. Llame a forRequest dentro del controlador para cada invocación.

¿Puedo usar Adobe Experience Platform Debugger? debugger

No. Adobe Experience Platform Debugger es una extensión del explorador que inspecciona páginas. Para depurar Server SDK, establezca debugEnabled en true o llame a setDebug y revise el resultado de la consola del servidor.

recommendation-more-help
experience-platform-help-collection