Syndication d'annonces et passerelle

Dernière édition : Mai 2020

Qu’est-ce la syndication d’annonces ?

La syndication d’annonces permet à un producteur de contenu extérieur de mettre à disposition automatiquement ses annonces, sans ressaisie par l’utilisateur, pour une intégration dans un autre site comme le votre. Les annonces initiales sont saisies dans un logiciel (comme le gestionnaire de flotte automobile CARGEST ou un autre) qui envoie alors ses annonces vers votre site à des périodes définies.

Cette technique est largement utilisée pour les annonces automobiles ou immobiliéres pour faire de la multi-diffusion d'annonces vers plusieurs sites comme le votre, le bon coin, ...

Bien que les mécanismes soient génériques et applicables à d'autres fournisseurs, ZADS supporte nativement les passerelles CARGEST https://cargest.eu/cargest/ , UBIFLOW https://www.ubiflow.net/ et AllYouCanPost AllYouCanPost

Principes de fonctionnement

Les annonces sont mises à disposition automatiquement par le fournisseur :

  • soit déposées (en FTP) dans un répertoire du site ZADS (cas de CARGEST)
  • soit téléchargées d'une URL définie par le fournisseur, que ZADS vient intérroger (cas de UBIFLOW)

Les annonces sont sous la forme d’un fichier XML unique pour chaque annonceur décrivant toutes les caractéristiques du véhicules ainsi que des liens vers les photos.

Ce fichier est décodé et analysé par ZADS :

  • Pour les véhicules nouveaux, non présent dans ZADS, une nouvelle annonce est créée.
  • Pour les véhicules déjà présents dans ZADS (une annonce existe déjà), l’annonce est mise à jour (contenu est photos).
  • Pour les véhicules qui ne sont plus disponibles, les annonces ZADS sont mise en « effacée » et purgées du site.

Etape 1 : connecter les comptes usagers entre le fournisseur et votre site

Pour connecter votre compte utilisateur il faut :

  1. Contacter le fournisseur pour qu’il vous indique le numéro de compte ou nom de fichier (identifiant de l'annonceur) qui sera utilisé. Celui-ci correspond au nom du fichier personnel qui sera exporté ou téléchargé.
  2. Créer ou modifier un compte usager sur ZADS en indiquant : le type de syndication et l'identifiant de l'annonceur

Cas de CARGEST

site-syndic-cargest

Cas de UBIFLOW

site-syndic-ubiflow

Etape 2 : Vérifier la Connection

Il faut se connecter à son compte et consulter son profil. Si l’étape 1 est faite, le compte indique un panel d’état de la syndication précisant le type de syndication, si la synchronisation est à jour et le nombre d’annonces qui ont été synchronisée lors de la dernière opération.

site-syndic-userstatus

Modes de synchronisation

Il existe 2 modes de synchronisations à paramétrer dans ADMIN > CONFIGURATION > SYNDICATION

  • automatique (toutes le heures ou tous les jours)
  • manuel

La synchronisation automatique utilise les CRON/BATCHES existant journalier et horaires et se produira donc à la même heure.

admin-syndic-syncselect

Il est possible aussi bien pour l’annonceur que l’administrateur de forcer la synchronisation manuellement à tout moment. admin-syndic-force

Formatage des annonces

L’annonce est automatique créée et le contenu est hérité des champs du fournisseur.

  • Les titre, descriptions, prix, caractéristiques sont hérité du fichier XML du fournisseur avec un mapping vers les champs de ZADS.
  • Les nom, numéros de téléphone, email du vendeur sont soit hérité de CARGEST ou hérité de EADS (suivant les paramétrages)
  • La localisation des annonces est celle de la fiche de l'annonceur dans ZADS.

Un tag origin indique que cette annonce provient d’une syndication et un champe référénce indique la référence du fournisseur pour chaque annonce.

admin-syndic-origin

Si on édite cette annonce, une notification nous précise que cette annonce est synchronisée. Les modifications seront perdues à la prochaine synchronisation de cette annonce !

Formatage du titre

Pour une syndication de type CARGEST, le formattage du titre peut être modifiés avec des mots clefs du flux.
admin-syndic-title

Les mots clefs peuvent être obtenus en cliquant sur le bouton suivant depuis l'inteface d'administration. admin-syndic-tags

résultat admin-syndic-tagsres

Pour une syndication de type UBIFLOW, le titre est égal au champ titre du flux.

Formatage de la description

ZADS utilise un principe de modèles (templates) pour la description. Les champs XML vont être insérés sélectivement et ajoutés à du contenu statique pour créer la désignation.

Le modèle peut être édité dans le repertoire indiqué par configuration comme ci-dessous. admin-syndic-path

les fichiers doivent être dans le repertoire indiqué admin-syndic-pathtemplate

exemple de contenu du fichier admin-syndic-template

Le nom du fichier contenant le modèle doit toujours être : cargest_description_template.htmlou ubiflow_description_template.html

Formatage des caracéristiques en champs spéciaux

Si vous avez crée des champs spéciaux dans ZADS (comme type de moteur, carrosserien, puissance fiscale, ....), vous pouvez faire le lien avec les caractéristiques des annonces du fournisseur. Ceci est "codé en dur" et donc non modifiable sans contacter le support de ZADS. Ci-dessous le codage par défaut à titre d'exemple admin-syndic-vfields

Formatage des details de l'annonceur

Les champs username, phoneet email sont soit hérités du flux XML, si ils sont présents, ou hérités de la fiche ZADS de l'annonceur. Ce choix est fonction du paramètre ci-dessous. admin-syndic-usersrc

Dans le cas de CARGEST, ce sont les tags raison_sociale, tel et email qui sont utilisé. Dans le cas de UBIFLOW, ce sont les tas telephone_a_afficher et email_a_afficher qui sont utilisé.

Envoi d'emails aux annonceurs

Les annonces qui sont en issues de la syndication ne sont pas notifiées par email vers les anonceurs en cas d'expiration ou d'effacement.

Annonces existantes

Lors de la synchonisation, le flux XML n'indique pas si une annonce est nouvelle ni la liste des annonces à effacer.

Avant chaque chargement, ZADS procède donc à une mise en mode "effacé" de toutes les annonces puis ensuite les réactive si elles existent dans le flux (en utilisant le tag reference présent dans le flux). Si l'annonce existe déjà, on met à jour les champs titre, description, prix, et images.

On peut aussi choisir de changer la date de modification à la date du moment de la synchro. Ce qui aura pour effet de mettre l'annonce en tête de liste. On peut désactiver cela en ne changeant pas la date (l'annonce reste ainsi dans la liste à la date de première création).

admin-syndic-moddate

Statistiques

Chaque activité de synchronisation est tracée dans un journal qui peut être consulté via le menu ADMIN > SYNDICATION admin-syndic-menu

Journal admin-syndic-logslist

nbindique le nombre d'annonces chargées , nbup indique le nombre d'images chargées sur le site.

Paramétrages génériques

Via le menu ADMIN > CONFIGURATION > SYNDICATION, on peut effectuer les réglages de :

  • Nombre max. d'annonces à charger du flux
  • ID de la catégorie ZADS dans laquelle les annonces vont appartenir
  • Nombre max. d'images à charge
  • Option de charger une copie des images sur le site ou les laisser à distance (url)
  • L'état par défaut de publication des annonces (à valider, publiée ou brouillon)

admin-syndic-settingsgen

Paramétrages spécifiques CARGEST

Via le menu ADMIN > CONFIGURATION > SYNDICATION, on peut effectuer les réglages spécifiques de CARGEST comme :

  • Le chemin du répertoire dans lequel CARGET va injecter en FTP les fichiers
  • Diverses options de tests

admin-syndic-settingscargest

Paramétrages spécifiques UBIFLOW

Via le menu ADMIN > CONFIGURATION > SYNDICATION, on peut effectuer les réglages spécifiques de UBIFLOW comme :

  • L'url source des annonces
  • Diverses options de tests

admin-syndic-settingsubiflow

Qu’est-ce que AllYouCanPost

La syndication d’annonces permet à un producteur de contenu extérieur (ici AllYouCanPost) de mettre à disposition automatiquement ses annonces, sans ressaisie par l’utilisateur, pour une intégration dans votre site. logo-aycp

AllYouCanPost fournit un flux XML en HTTPS, collecté journalièrement par votre script. Les flux sont mis à jour toutes les 24 h.

Pour plus d’information sur la syndication AllYouCanPost