Hay tres opciones de integración de uso común disponibles, que pueden admitir variaciones menores para adaptarse a sus necesidades individuales. Es importante tener en cuenta que CitrusAd se integra a través del backend del minorista.

Integración estándar

La integración estándar de CitrusAd garantiza la mejor experiencia del usuario final, ya que los resultados se entregan rápidamente al navegador del cliente.

📘
Los anuncios no se muestran al usuario final hasta que se han fusionado.

Flujo de trabajo

Antes de mostrar anuncios:

Se sincroniza su catálogo de productos con CitrusAd a través de API o de una sincronización diaria de archivos
(Opcional) se sincronizan los datos de sus clientes con CitrusAd a través de API o de una sincronización de archivos diaria.

Cuando se muestran anuncios:

Su cliente carga el sitio web y luego navega a una página con integración de CitrusAd
Su sitio web solicita datos de su servidor backend en función del contexto interno de la página; en este caso, una página de categoría (customerId, sessionId, productFilters)
Su servidor backend llama a la API de CitrusAd y solicita anuncios para el "contexto" de la página del cliente y la ubicación de anuncios.
CitrusAd devuelve los anuncios más relevantes para la solicitud a su backend en forma de código de producto y URL para los anuncios de banner
Su backend fusiona la respuesta de CitrusAd con contenido orgánico
Su servidor envía el contenido orgánico del anuncio al sitio web en una única respuesta
Su sitio web muestra todo el contenido al cliente de una vez.

Después de mostrar los anuncios:

Cuando el cliente ve un anuncio en el visor de su navegador, se informa de una impresión a CitrusAd para la adId
Cuando el cliente hace clic en un anuncio, se informa de un clic a CitrusAd para la adId
Cuando el cliente finaliza su pedido, se informa de este a CitrusAd con información sobre los artículos, precios y cantidades del pedido y la customerId y sessionId.

Variación 1: solicitudes de navegador individuales

En esta variación, se llama individualmente a su servidor backend para productos orgánicos y se aplica un nuevo servicio backend para consultar al servidor de CitrusAd antes de fusionar el resultado en el navegador. Esto puede reducir los recursos de desarrollo, ya que se deberán realizar menos cambios en las solicitudes existentes al garantizar que la solicitud de CitrusAd sea independiente.

📘
Los anuncios no se muestran al usuario final hasta que se hayan fusionado, aunque se hayan realizado dos llamadas independientes a su servidor backend y a CitrusAd antes de la fusión.
Aún debe obtener toda la información relevante del producto para los códigos de producto devueltos en la respuesta de CitrusAd.

Variaciones del flujo de trabajo (1)

Cuando se muestran anuncios:

En lugar de que el servicio de backend existente realice una solicitud a CitrusAd, se realiza una nueva solicitud a un nuevo servicio minorista que hace la llamada de backend a CitrusAd con la información de ubicación relevante.
El navegador fusiona los anuncios orgánicos y los de CitrusAd y luego muestra el contenido al cliente.

Variación 2: fusión después de mostrar al cliente

En esta variación, se sigue un flujo de trabajo similar al anterior; sin embargo, se mostrarán los resultados orgánicos del producto al cliente cuando estén disponibles. Después de esto, se fusionarán y reordenarán los resultados después de recibir contenido de CitrusAd. Este método de integración es probablemente el que menos tiempo requiere, ya que los recursos de desarrollo necesarios son mínimos.

📘
Los anuncios orgánicos se mostrarán de forma intermitente al usuario final antes de que los anuncios de productos se fusionen y se reordenen.
Aún debe obtener toda la información relevante del producto para los códigos de producto devueltos en la respuesta de CitrusAd.

Variaciones del flujo de trabajo (2)

Cuando se muestran anuncios:

Se muestran los anuncios orgánicos y la respuesta de CitrusAd se fusiona una vez que el navegador los recibe.