Vous disposez de trois options d'intégration courantes, lesquelles peuvent être légèrement modifiées pour satisfaire vos propres besoins. Il est important de noter que CitrusAd est intégré via le back-end du détaillant.

Intégration standard

L'intégration standard de CitrusAd garantit la meilleure expérience utilisateur final possible dans la mesure où les résultats sont diffusés rapidement sur le navigateur du client.

📘
Les listings ne sont pas visibles par les utilisateurs finaux tant qu'ils n'ont pas été fusionnés.

Workflow

Avant la diffusion des annonces :

Vous synchronisez votre catalogue de produits avec CitrusAd par l'API ou quotidiennement par fichier
(Facultatif) Vous synchronisez vos données client avec CitrusAd par l'API ou quotidiennement par fichier.

Lors de la diffusion des annonces :

Votre client charge le site Web, puis navigue vers une page comportant une intégration CitrusAd
Votre site Web sollicite des données auprès de votre serveur back-end selon le contexte interne de la page, ici une page de catégorie (customerId, sessionId, productFilters)
Votre serveur back-end appelle l'API CitrusAd et émet une requête d'annonces correspondant au « contexte » de la page du client et à l'emplacement publicitaire
CitrusAd renvoie les annonces qui répondent le mieux aux critères de la requête à votre back-end sous la forme d'un code produit et d'une URL pour les bannières publicitaires
Votre back-end fusionne la réponse de CitrusAd avec le contenu organique
Votre serveur envoie le contenu organique de l'annonce au site Web en une seule réponse
Votre site Web diffuse tout le contenu au client en une seule fois.

Après la diffusion des annonces :

Lorsque le client voit une annonce dans la fenêtre de son navigateur, une impression est déclarée à CitrusAd pour l' adId
Lorsque le client clique sur une annonce, un clic est déclaré à CitrusAd pour l' adId
Lorsque le client passe sa commande, celle-ci est transmise à CitrusAd avec les articles commandés, les prix et les quantités, ainsi que les customerId et sessionId.

Variante 1 : requêtes individuelles au navigateur

Dans cette variante, vous appelez individuellement votre serveur back-end pour les produits organiques, et mettez en œuvre un nouveau service back-end pour interroger le serveur CitrusAd avant de fusionner le résultat dans le navigateur. Cette méthode permet de réduire les efforts de développement, car le fait de séparer la requête CitrusAd limitera les modifications à apporter aux requêtes existantes.

📘
Les listings ne sont pas présentés à l'utilisateur final tant qu'ils n'ont pas été fusionnés, même si deux appels distincts ont été effectués à votre serveur back-end et à CitrusAd avant la fusion.
Il vous incombe toujours de récupérer toutes les informations produit pertinentes concernant les codes produit renvoyés dans la réponse de CitrusAd.

Variantes de workflow (1)

Lors de la diffusion des annonces :

Au lieu que votre service back-end existant adresse une requête à CitrusAd, une nouvelle requête est adressée à un nouveau service de détaillant, qui effectue l'appel back-end vers CitrusAd en fournissant les informations d'emplacement appropriées.
Le navigateur fusionne les listings organiques et le contenu CitrusAd, puis diffuse le contenu au client.

Variante 2 : fusion après affichage au client

Dans cette variante, le workflow est similaire à celui décrit ci-dessus. Toutefois, vous diffuserez les résultats organiques de produits au client dès qu'ils seront disponibles. Ensuite, vous fusionnerez et réorganiserez les résultats après avoir reçu le contenu de la part de CitrusAd. Cette méthode d'intégration est sans doute la plus rapide, car elle nécessite le moins d'efforts de développement possible.

📘
Les listings organiques s'afficheront par intermittence à l'utilisateur final avant que les annonces de produits soient fusionnées et réorganisées.
Il vous incombe toujours de récupérer toutes les informations produit pertinentes concernant les codes produit renvoyés dans la réponse de CitrusAd.

Variantes de workflow (2)

Lors de la diffusion des annonces :

Les annonces organiques sont affichées, et la réponse CitrusAd est fusionnée une fois que le navigateur les a reçues.