Un catalogue avec un signal de performance sur chaque produit
Grupo Zap lit vos produits depuis le flux. Feedance envoie un flux complet et valide, ainsi que les signaux dont Grupo Zap ne dispose pas par lui-même.
Grupo ZapCanal · Marketplaces et applicationsFeedance crée votre flux Grupo Zap et ajoute des libellés au niveau produit pour le score, le segment 4T, le positionnement prix et les tailles manquantes, afin que chaque produit porte son propre signal de performance.
Grupo Zap lit vos produits depuis le flux. Feedance envoie un flux complet et valide, ainsi que les signaux dont Grupo Zap ne dispose pas par lui-même.
Grupo ZAP est la branche immobilière d'OLX Group au Brésil et exploite les deux plus grands portails d'annonces immobilières du pays : ZAP Imóveis et Viva Real. Les agences immobilières, les courtiers et les éditeurs de CRM connectent leur portefeuille de biens à Grupo ZAP afin que les annonces de vente et de location apparaissent sur les deux portails (et, selon la formule souscrite, également sur les petites annonces OLX) à partir d'un seul flux de données plutôt que par une saisie manuelle sur chaque portail.
Au lieu qu'un courtier ou un agent ressaisisse la même annonce séparément sur ZAP Imóveis, Viva Real et OLX, le logiciel de gestion immobilière génère un seul fichier XML standardisé que les robots de Grupo ZAP récupèrent selon un calendrier fixe. Toute modification effectuée une seule fois dans le système source (un nouveau prix, une nouvelle série de photos, une annonce marquée comme vendue ou louée) est automatiquement répercutée sur tous les portails connectés lors du passage suivant du robot : c'est la principale raison pour laquelle les agences automatisent ce processus au lieu de gérer à la main le back-office de chaque portail.
La documentation développeurs de Grupo ZAP mentionne deux schémas XML pris en charge : l'ancien format « ZAP », qu'elle décrit explicitement comme étant en mode maintenance, et VRSync, le standard actuel qui « intègre toutes les nouvelles fonctionnalités ». La documentation indique que les flux non VRSync étaient en cours d'abandon, et l'outil de validation XML de Grupo ZAP n'accepte que les fichiers au format VRSync. Toute nouvelle intégration, y compris réalisée avec un outil de gestion de flux, doit donc cibler VRSync plutôt que l'ancien format.
Grupo ZAP intègre les annonces selon une architecture de récupération périodique : il n'accepte pas les envois poussés, mais télécharge régulièrement un fichier XML VRSync à partir d'une URL que vous fournissez. D'après le Guia de Conexão officiel (guide de connexion), le serveur qui héberge le flux doit répondre à plusieurs exigences techniques concrètes :
VivaRealBot/1.0), faute de quoi les requêtes échouent avec une erreur HTTP 403Le validateur XML officiel limite en outre les fichiers acceptés à 30 Mo et rejette tout fichier qui n'est pas au format VRSync.
Le schéma VRSync est organisé en un bloc Listing et un bloc Details imbriqué. D'après la référence des éléments de Grupo ZAP, les éléments suivants sont documentés comme obligatoires (ou obligatoires selon le type de bien) :
| Attribut | Élément | Exigence |
|---|---|---|
| Identifiant de l'annonce | ListingID | Obligatoire, 1 à 50 caractères, unique par bien |
| Titre | Title | Obligatoire, 10 à 100 caractères, sans balises HTML |
| Type de transaction | TransactionType | Obligatoire : For Sale, For Rent ou Sale/Rent |
| Adresse / localisation | Location (Country, State, City, Neighborhood, PostalCode) | Obligatoire ; PostalCode obligatoire sur toutes les annonces |
| Photos | Media / Item | Obligatoire, 5 images minimum par annonce |
| Contact du courtier | ContactInfo (Name, Email) | Obligatoire |
| Type de bien | PropertyType | Obligatoire, avec des valeurs standardisées |
| Description | Description | Obligatoire, 50 à 3 000 caractères, en CDATA, sans balises HTML |
| Surface habitable | LivingArea | Obligatoire pour la plupart des types de biens, unit="square metres" |
| Chambres / salles de bains | Bedrooms, Bathrooms | Obligatoire pour les biens résidentiels ; non requis pour les terrains ou les entrepôts |
| Prix de vente ou loyer | ListPrice / RentalPrice | ListPrice obligatoire pour les annonces de vente ; RentalPrice obligatoire pour les annonces de location ; attribut currency="BRL" obligatoire |
| Surface du terrain | LotArea | Obligatoire à la place de LivingArea pour les terrains, fermes et ranchs |
Feedance peut générer et héberger le fichier XML VRSync que le robot de Grupo ZAP récupère, en associant les fiches de biens de votre système source (CRM, ERP ou tableur) à la structure Header, Listing et Details qu'impose le standard.
Comme il s'agit d'un schéma immobilier spécialisé et fortement imbriqué plutôt que d'un catalogue produits à plat, prévoyez davantage de travail initial de mapping des champs qu'avec un flux Shopping e-commerce standard.
La documentation de Grupo ZAP indique que les fichiers XML sont traités deux fois par jour, à environ 12 heures d'intervalle. Il s'agit d'une récupération par robot, et non d'un envoi poussé : régénérer le flux plus souvent que ce cycle n'apporte donc aucun bénéfice. Ce qui compte, c'est que le flux reflète la réalité (prix, disponibilité, statut vendu/loué) avant chaque fenêtre de passage, car un flux obsolète laissera un bien indisponible en ligne, ou un prix mis à jour non synchronisé, jusqu'à la récupération suivante 12 heures plus tard.
La documentation de Grupo ZAP et son validateur XML signalent plusieurs causes récurrentes de rejet d'annonces :
currency="BRL" sur les éléments de prix, ou de l'attribut unit="square metres" sur les éléments de surface<Description/>), ou descriptions en dehors de la plage de 50 à 3 000 caractèresBonnes pratiques générales de qualité de flux (et non affirmations propres à Grupo ZAP) qui tendent à améliorer la performance des annonces sur les portails immobiliers :
Feedance prend-il spécifiquement en charge le format VRSync ? Feedance peut générer des flux XML associés à la structure d'éléments VRSync définie par la documentation de Grupo ZAP ; l'ancien format ZAP est obsolète et ne doit pas être utilisé pour les nouvelles intégrations.
Puis-je envoyer le même flux à ZAP Imóveis, Viva Real et OLX ? La documentation de Grupo ZAP décrit un seul flux XML distribué sur les portails inclus dans votre formule, sans flux distinct pour chaque portail.
Comment saurai-je si une annonce a été rejetée ? Grupo ZAP indique envoyer des rapports d'intégration et, pour les erreurs qui persistent plus de trois jours, des notifications directes par e-mail détaillant ce qui a échoué.
S'agit-il du même type de flux qu'un flux produits Google Merchant Center ou Meta ? Non : VRSync est un schéma propre à l'immobilier, avec des structures imbriquées Location, Media, ContactInfo et Details et des champs obligatoires qui dépendent du type de bien. Sa structure diffère donc de celle d'un flux produits e-commerce à plat, même si l'objectif de fond (un flux source, plusieurs destinations) est similaire.
Grupo ZAP est l'activité immobilière d'OLX Group au Brésil. Il exploite deux des plus grands portails immobiliers du pays, ZAP Imóveis et Viva Real, sur lesquels les internautes recherchent des maisons, des appartements et des locaux commerciaux à acheter ou à louer.
Les agences immobilières, les courtiers et les éditeurs de logiciels immobiliers envoient leurs annonces à Grupo ZAP afin que les biens apparaissent sur les deux portails et, selon l'offre souscrite, également sur les petites annonces OLX. Une seule source de données remplace la saisie manuelle de la même annonce dans le back-office de chaque portail.
Les annonces sont transmises sous forme de flux XML au format VRSync, que Grupo ZAP désigne comme sa norme actuelle ; l'ancien format ZAP XML est en mode maintenance. Grupo ZAP n'accepte pas les imports envoyés activement. Son robot télécharge le flux depuis une URL HTTPS selon un calendrier régulier : le serveur doit donc autoriser le robot, répondre rapidement et fournir le fichier de manière fiable.
Pour les agences, la qualité du flux influe sur les performances des annonces. Des prix, adresses, types de biens, surfaces, nombres de pièces et caractéristiques corrects aident les annonces à apparaître dans les bonnes recherches, de bonnes photos attirent davantage de demandes, et retirer rapidement les biens vendus ou loués préserve la fiabilité du portefeuille et évite des leads perdus.
Connectez votre flux et GA4. Nous affichons Product Score, 4T, Price War et Broken Size sur votre propre catalogue.