[Alpha]{class="badge informative"}
Diferenças do Web SDK
O SDK do Servidor e o Web SDK compartilham o mesmo núcleo, enviam dados no mesmo formato para as mesmas sequências de dados e usam os mesmos cookies. Como um é executado em um servidor e o outro em um navegador, eles diferem de várias maneiras. Use esta página para planejar uma migração ou compartilhar código entre um navegador e uma implementação de servidor.
Comparação comparison
@adobe/alloy npm@adobe/alloy-node npm. Consulte Instalar.alloy("sendEvent", { ... })alloy.sendEvent({ ... }). Consulte Visão geral dos métodos.forRequest para cada solicitação de visitantedefaultConsent aceita "in", "out" e "pending"defaultConsent aceita somente "in" e "out"Referer. Consulte Contexto e cabeçalhos encaminhados.sendEvent resultadopropositions, inferences e destinationspropositionsdebugEnabled, setDebug, o parâmetro da cadeia de caracteres de consulta alloy_debug e o Adobe Experience Platform DebuggerdebugEnabled e setDebug, com mensagens gravadas no consolemonitors e a variável global __alloyMonitorsmonitors de createInstanceMétodos methods
O SDK do Servidor adiciona o método forRequest, que não existe no Web SDK.
Ele oferece suporte aos seguintes comandos do Web SDK como métodos: appendIdentityToUrl, applyResponse, configure, getIdentity, getLibraryInfo, sendEvent, setConsent e setDebug.
Os seguintes comandos do Web SDK não estão disponíveis, pois dependem de um navegador ou de componentes que o SDK do servidor não inclui:
applyPropositionscreateMediaSessiongetMediaAnalyticsTrackersendMediaEventsendPushSubscriptionsubscribeRulesetItems
Opções de configuração configuration
- Novo e necessário:
edgeCredentials. - Com Suporte:
datastreamId,orgId,debugEnabled,defaultConsent,edgeBasePath,edgeConfigOverrides,edgeDomain,idMigrationEnabled,onBeforeEventSendethirdPartyCookiesEnabled. Alguns deles se comportam de forma diferente em um servidor. Consulte a página de cada opção. - Sem suporte: todas as outras opções do Web SDK. Se você incluir um,
configureserá rejeitado. Consulte Opções não suportadas pelo Server SDK.
opções sendEvent sendevent
- Com suporte:
xdm,data,type,personalization.decisionScopesepersonalization.surfaces, a matrizdecisionScopesde nível superior eedgeConfigOverrides. - Aceito, mas sem efeito:
renderDecisions,advertisinge as outras propriedadespersonalization. Consulte Opções sem efeito em um servidor. - Evitar:
documentUnloading.
Perguntas frequentes faq
Posso usar o Server SDK e o Web SDK no mesmo site? same-site
Sim. Um padrão comum é solicitar personalização no servidor e renderizá-la no navegador. Consulte Personalização híbrida. Ambas as bibliotecas podem enviar dados para a mesma sequência de dados se seu Tipo de Acesso for Autenticação Mista. Ambos usam os mesmos nomes de cookies para identidade e consentimento.
Por que cada evento precisa de uma identidade principal? primary-identity
O SDK do servidor envia eventos para a API autenticada do Edge Network Server. Como a solicitação é proveniente do servidor, o Edge Network não pode usar os cookies do navegador do visitante para identificá-los. Em vez disso, requer uma identidade principal no evento. Consulte xdm.
Posso usar o Server SDK em funções sem servidor? serverless
Sim, se o tempo de execução da função atender aos requisitos. Crie e configure a instância no nível superior do módulo, fora do manipulador de função. Dessa forma, as invocações quentes reutilizam a instância configurada e seu token de acesso em cache. Chame forRequest dentro do manipulador para cada invocação.
Posso usar o Adobe Experience Platform Debugger? debugger
Não. O Adobe Experience Platform Debugger é uma extensão de navegador que inspeciona páginas. Para depurar o SDK do Servidor, defina debugEnabled como true ou chame setDebug e revise a saída do console do servidor.