Syndication Script-PAG

Qu’est-ce la syndication

La syndication d’annonces permet à un producteur de contenu extérieur, ou un autre site de petites annonces, de mettre à disposition automatiquement ses annonces, sans ressaisie par l’utilisateur, pour une intégration dans votre site.

Un site construit avec Script-PAG peut exporter ses annonces via un flux XML accessible via une URL ou un fichier XML qui peut être copié sur votre site.

Pour plus d’information sur la syndication

Paramétrages initiaux et tests

Pour démarrer, il faut renseigner l'URI de votre flux. Saisir cette URI dans ADMIN > CONFIGURATION > SYNDICATION

Vous pouvez alors vérifier le bonne connection à cette URI et le format en cliquant sur lire les tags. Cette action provoque le lecture de l'URI renseignée et décode la première annonce pour en afficher les tags XML.

Annonces importées

Les annonces importées sont indiquées avec une marque d'origine visible pour l'administrateur et le propriétaire de l'annonce

Gestion des annonceurs

Le flux est multi-annonceurs.

Vous pouvez donc choisir :

• soit de créer des usagers à partir des données du flux

  $parsedXml[$i]['mainKeys']['phone'] = (string)$xml['phone']; 
  $parsedXml[$i]['mainKeys']['email'] = (string)$xml['email']; 
  $parsedXml[$i]['mainKeys']['username'] =  (string)$xml['name'];
  $parsedXml[$i]['mainKeys']['usertype'] =  (int)$xml['status']==2 ?  "pro" : "par";
  $parsedXml[$i]['mainKeys']['user_company'] =  (string)$xml['comp_name'];   

• soit d'affecter les annonces à un utilisateur unique crée à l'avance sur votre site.

Gestion des catégories

Le flux est multi-catégories. Il est donc nécessaire de faire correspondre les catégories (IDs) issues du flux avec les catégories (IDs) de votre site.
Un fichier de traduction (au format JSON) devra être indiqué dans le champ suivant. Si auncun fichier, alors les IDs des catégories des annonces seront strictement égales aux IDs du flux. Assurez vous bien de l'existance des ces IDs sur votre site.

[
    { "from_id" : 1, "from_name" : "Voiture-Berline", "to_id" : 21 }, 
    { "from_id" : 2, "from_name" : "Voiture-Coupé", "to_id" : 21 }
]

Il est possible de tester le fichier de traduction par le bouton suivant.

Le site va anayser le fichier et vérifier l'existance de catégories destination pour chaque entrée. Il va compléter le fichier avec des commentaires et des erreurs.

Vous pouvez alors consulter le fichier texte et rechercher les erreurs indiquées comme suit :

{
        "from_id": 5,
        "from_name": "Voiture-Break",
        "to_id": 0,
        "to_name": "?",
        "to_error": "ERROR - does not exist"
    },

Géolocalisation des annonces

Le flux de Script-PAG fournit des information de localisation suivantes : la ville, code postal, coordonnées GPS. Ce sont ces informations qui sonbt utilisées directement pour la localisation des annonces.

La pays est encodé dans un champ id_reg, On devra faire alors une traduction.

Le fichier de traduction (au format JSON) devra être indiqué dans le champ suivant.

[
{
        "from_id": 15,
        "to_name": "France",
        "to_iso_code": "fr"
}
]

Modes de synchronisation

Il est possible pour l’annonceur que l’administrateur de forcer la synchronisation manuellement à tout moment.

Résultat aprés un certain temps d'attente (compter environ 1 seconde par annonce si importation des images)

On peut indiquer le nombre d'annonce max à importer dans le champ général :

Les annonces crées auraont un nouvel ID (celui du site) sauf si vous souhaitez conserver l'Id du site original. Dans ce cas ilfaudra activer l'option suivante :

Formatage des annonces

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

• Les titre, descriptions, prix ... 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 hérités du flux
• La localisation des annonces (ville, code postal, pays) est celle du flux

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.

Indication de l'origine

Modification d'une annonce par un utilisateur

Formatage des champs de l'annonce

Pour une syndication de type, le titre est égal au champ titre du flux, la desc est égal au champ content. Le prix est connecté au champ price.

Envoi d'emails aux annonceurs

Gestion des images

Les paramétres généraux de la syndication s'appliquent. On peut :

• soit cloner/copier les images du site distant vers voyre site. Avantage : le copie locale évite des latences lors de la récupération distante des images et permet de garder une copie si la photo est supprimée à distance entre 2 synchronisations.
• soit garder l'URI de l'image distante . Avantage : pas de consommation de votre espace de stockage.

Annonces existantes

Le flux XML n'indique pas si une annonce est nouvelle ou juste modifiée.

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).

Effacer les annonces / annonceurs

Il est possible d'effacer toutes les annonces importées ou tous les annonceurs crées automatiquement. Ceci peut être utile pendant des phase de mise au point.

Statistiques

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

Journal pour l'administrateur

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)