[Alpha]{class="badge informative"}

Servicios de plataforma

Server SDK comparte su lógica principal con Web SDK. Cualquier cosa que dependa del entorno, como el envío de solicitudes de red, la lectura de cookies o el almacenamiento de datos, pasa por un conjunto de servicios de plataforma. SDK incluye servicios predeterminados que solo usan API estándar en la web, por lo que funcionan en cualquier tiempo de ejecución que cumpla los requisitos. Puede reemplazar cualquiera de ellos con su propia implementación.

La mayoría de las implementaciones no necesitan reemplazar ningún servicio. El motivo más común para reemplazar una es proporcionar un servicio de cookie, de modo que un visitante conserve la misma identidad y consentimiento en todas las solicitudes.

Dónde pasar los servicios where

Puede pasar servicios en dos lugares:

import { createInstance } from "@adobe/alloy-node";

// Applies to the top-level instance. Handles reuse network, runtime, legacy, and globals.
const alloy = createInstance({
  platformServices: {
    runtime: myRuntimeService
  }
});

await alloy.configure({
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  edgeCredentials: {
    clientId: process.env.ADOBE_CLIENT_ID,
    clientSecret: process.env.ADOBE_CLIENT_SECRET,
    scopes: process.env.ADOBE_SCOPES.split(",")
  }
});

// Applies only to this handle
const visitor = alloy.forRequest({
  request: req,
  cookie: myCookieServiceForThisVisitor,
  storage: myStorageServiceForThisVisitor
});

Las interfaces de cada servicio se definen en packages/core/src/services/types.ts en el repositorio adobe/alloy de GitHub. Al reemplazar un servicio, la implementación debe proporcionar todos los métodos de la interfaz.

Servicios disponibles services

Servicio de cookies cookie

SDK almacena la identidad de cada visitante (ECID) y las preferencias de consentimiento en cookies. En un servidor, lee y escribe esas cookies a través del servicio cookie. El servicio de cookies debe proporcionar los siguientes métodos:

El servicio de cookies predeterminado mantiene las cookies solo en la memoria:

SDK no incluye un servicio de cookies que lea el encabezado de solicitud Cookie del visitante y escriba Set-Cookie encabezados de respuesta. Para conservar la identidad y el consentimiento de un visitante en todas las solicitudes, debe proporcionar su propia implementación y pasar una nueva a forRequest para cada solicitud.

Servicio de almacenamiento storage

SDK usa el servicio storage para recordar algunos valores, como si la depuración está activada con setDebug, qué preferencias de consentimiento setConsent ya se han enviado y el ID de cliente que Adobe Experience Platform Assurance usa para validar solicitudes. El servicio de almacenamiento predeterminado mantiene los datos en la memoria.

Cada identificador de forRequest obtiene un nuevo servicio de almacenamiento vacío a menos que pase uno. Si usa Assurance y desea que el ID de cliente de Assurance de un visitante permanezca igual en todas las solicitudes, pase un servicio storage para ese visitante a forRequest.

Servicio de red network

El servicio de red predeterminado envía solicitudes con la función global fetch. Cuando pasa un(a) request a forRequest, también agrega los encabezados del visitante a cada solicitud. Ver Contexto y encabezados reenviados.

Para reemplazar el servicio de red, pase una función que reciba el registrador de SDK y devuelva un servicio de red, en lugar de pasar el propio objeto de servicio:

const alloy = createInstance({
  platformServices: {
    network: (logger) => myNetworkService
  }
});