Show Menu
TEMAS×

Servidor: implementación de Target

Information about Adobe Target Server Side delivery APIs, Server Side Batch Delivery APIs, NodeJS SDK, Target Recommendations APIs, and Target Classic APIs (decommissioned).
The following process occurs in a server-side implementation of Target:
  1. Un dispositivo cliente realiza una solicitud de una experiencia a través del servidor.
  2. Your server sends that request to Target.
  3. Target devuelve la respuesta al servidor.
  4. El servidor toma la decisión sobre la experiencia que se debe ofrecer al dispositivo cliente para que se represente.
La experiencia no necesita mostrarse en un navegador; puede mostrarse en un correo electrónico o quiosco, a través de un ayudante de voz o a través de algún otro dispositivo no visual o no basado en explorador. Because your server sits between the client and Target, this type of implementation is also ideal if you need greater control and security or have complex backend processes that you want to run on your server.
En la siguiente sección se enumeran las distintas API y el SDK de NodeJS, y se proporciona información adicional:

API de envío del servidor

/rest/v1/mbox
Target permite que su aplicación realice llamadas de mbox desde cualquier navegador, dispositivo móvil o incluso otro servidor. The Server Side delivery API is specifically designed to integrate Target with any server-side platform that makes HTTP/HTTPS calls.
Puede utilizar la API para integrar su aplicación personalizada con Target. Es especialmente útil para las organizaciones que deseen ofrecer segmentación para un dispositivo IoT no basado en navegador, como un televisor, un quiosco o una pantalla digital.
Este extremo solo puede devolver ofertas para mboxes normales. También puede obtenerse contenido para un solo mbox.
Esta API implementa funciones existentes de mbox al modo RESTful.
Esta API no procesa cookies ni redirige llamadas.

API de envío por lotes del servidor

/rest/v2/batchmbox
La API de envío por lotes permite que su aplicación solicite contenido para varios mboxes mediante una sola llamada. It also has a prefetch mode that enables clients like mobile apps, servers, and so forth to fetch content for multiple mboxes in one request, cache it locally, and later notify Target when the user visits those mboxes.
Este extremo solo puede devolver ofertas para mboxes normales. Como es posible recuperar contenido para varios mboxes, si desea mejorar el rendimiento es conveniente utilizar la API de mbox por lotes. De este modo evita la ejecución de varias solicitudes HTTP, lo que puede resultar costoso.

SDK de NodeJS

En cuanto a SDK, en este momento tenemos uno solo: el SDK de NodeJS.
El SDK de NodeJS es un envoltorio delgado que rodea el módulo central HTTP/HTTPS de NodeJS. En segundo plano, las API del SDK de NodeJS utilizan las mismas API de entrega del servidor.
Esta es la asignación:
  • MarketingCloudClient.getOffer() *- invokes */res/v1/mbox endpoint
  • MarketingCloudClient.getOffers() *- invokes */res/v2/batchmbox endpoint

Target Recommendations API

Las API de Recommendations le permiten interactuar mediante programación con los servidores de recomendaciones de Target. Estas API se pueden integrar con distintas pilas de aplicaciones para llevar a cabo funciones que normalmente se realizan a través de la interfaz de usuario.

Target Classic API

The Target Classic UI and APIs have been decommissioned. Para obtener más información sobre cómo dar el salto a las API modernas de Target, consulte Transición de las API anteriores de Target a Adobe I/O .
Las API de creación (en las que se crean actividades, ofertas, audiencias, etc.) no admiten el intercambio de recursos de origen cruzado (CORS).

Diferencias entre las API de entrega del servidor y el SDK de NodeJS

Muchos clientes no entienden bien las diferencias entre las API de entrega del servidor y el SDK de NodeJS. Este problema se da especialmente en lo que respecta al rendimiento.
Las siguientes preguntas más frecuentes le ayudarán a decidir cuál debe utilizar:
¿Cuándo se deben utilizar las API del servidor “en bruto” y cuándo el SDK de NodeJS?
Si está utilizando NodeJS como tecnología de back-end, el SDK de NodeJS es la opción evidente. El SDK se ocupa de muchos detalles, como las cookies, los encabezados, las cargas útiles, etcétera. De este modo, usted puede concentrarse en el núcleo de su aplicación.
¿Debería percibir mejoras de rendimiento al utilizar el SDK de NodeJS?
Lamentablemente, carecemos de cifras sobre rendimiento. Sin embargo, y en general, el SDK de NodeJS debería ofrecer un buen rendimiento gracias a la arquitectura orientada a eventos de NodeJS. Be aware that most of the time is spent on the Target backend. El SDK de NodeJS realiza muy poco procesamiento. The SDK is basically responsible for packaging a Target request and parsing a Target response.