NouveauProduct Score, 4T Segmentation, Price War et Broken Size sont disponibles.Découvrir les nouveautés
Feedance
Logo Grupo ZapGrupo ZapCanal · Marketplaces et applications
Intégration Grupo Zap

Envoyez à Grupo Zap les produits
qui méritent d’être vus

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

Flux produits Grupo Zap
Généré par Feedance
Export XML, CSV ou JSONMis à jour à chaque synchronisation
<item>
  <id>TS-1042</id>
  <title>T-shirt col rond</title>
  <price>49.90 USD</price>
  <availability>in stock</availability>
  <custom_label_0>score_86</custom_label_0>
  <custom_label_1>top</custom_label_1>
  <custom_label_2>best_price</custom_label_2>
  <custom_label_3>size_ok</custom_label_3>
</item>
Libellés Feedance, inscrits comme libellés personnalisés
Ce que Feedance envoie à Grupo Zap

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.

Product Scorecustom_label_0Un score de 0 à 100 calculé à partir des vues, ajouts au panier et achats sur 1, 7 et 30 jours.
Segment 4Tcustom_label_1Top, Tolerable, Tranquil ou Toxic, selon le trafic et le rendement propres à chaque produit.
Price Warcustom_label_2Moins cher, au même prix ou plus cher que des concurrents identifiés.
Broken Sizecustom_label_3Signale les modèles dont la plupart des tailles sont en rupture de stock.
Visuelsimage_linkVisuels à votre marque issus de Creative Suite, avec le prix et les informations de campagne tirés du flux.
Comment l’utiliser : segmentez vos campagnes, groupes de produits ou ensembles de produits selon ces libellés, par exemple uniquement les produits Top, ou tout sauf les produits Toxic et les séries de tailles incomplètes. Les emplacements des libellés sont configurables. Feedance ne modifie ni vos enchères ni vos budgets.

Qu'est-ce que Grupo ZAP ?

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.

Pourquoi connecter votre flux d'annonces immobilières à Grupo ZAP ?

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.

VRSync remplace l'ancien format XML ZAP

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.

Quel format de flux Grupo ZAP exige-t-il ?

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 :

  1. Autoriser le User-Agent du robot (identifié dans la documentation comme VivaRealBot/1.0), faute de quoi les requêtes échouent avec une erreur HTTP 403
  2. Servir le flux en HTTPS avec un certificat valide et non auto-signé, compatible TLS 1.0 à 1.2
  3. Répondre dans un délai de connexion de 60 secondes et terminer le transfert du fichier dans une fenêtre de téléchargement de 20 minutes
  4. Limiter l'URL du flux à 255 caractères, avec un encodage d'URL correct et sans espaces bruts
  5. Prendre en charge jusqu'à 100 redirections dans le même protocole si la chaîne d'URL redirige

Le validateur XML officiel limite en outre les fichiers acceptés à 30 Mo et rejette tout fichier qui n'est pas au format VRSync.

Quels attributs d'annonce immobilière VRSync exige-t-il ?

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émentExigence
Identifiant de l'annonceListingIDObligatoire, 1 à 50 caractères, unique par bien
TitreTitleObligatoire, 10 à 100 caractères, sans balises HTML
Type de transactionTransactionTypeObligatoire : For Sale, For Rent ou Sale/Rent
Adresse / localisationLocation (Country, State, City, Neighborhood, PostalCode)Obligatoire ; PostalCode obligatoire sur toutes les annonces
PhotosMedia / ItemObligatoire, 5 images minimum par annonce
Contact du courtierContactInfo (Name, Email)Obligatoire
Type de bienPropertyTypeObligatoire, avec des valeurs standardisées
DescriptionDescriptionObligatoire, 50 à 3 000 caractères, en CDATA, sans balises HTML
Surface habitableLivingAreaObligatoire pour la plupart des types de biens, unit="square metres"
Chambres / salles de bainsBedrooms, BathroomsObligatoire pour les biens résidentiels ; non requis pour les terrains ou les entrepôts
Prix de vente ou loyerListPrice / RentalPriceListPrice obligatoire pour les annonces de vente ; RentalPrice obligatoire pour les annonces de location ; attribut currency="BRL" obligatoire
Surface du terrainLotAreaObligatoire à la place de LivingArea pour les terrains, fermes et ranchs

Comment connecter Grupo ZAP à Feedance

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.

  1. Associez vos champs de données immobilières (adresse, prix, chambres, salles de bains, surface, photos, type de transaction) aux éléments VRSync correspondants
  2. Configurez la logique conditionnelle requise, par exemple ne renseigner LotArea que pour les annonces de terrains, ou RentalPrice que pour les annonces Rent/Sale-Rent, car les champs obligatoires de VRSync varient selon le type de bien
  3. Publiez le flux à une URL HTTPS stable qui respecte les exigences de connexion de Grupo ZAP (certificat valide, User-Agent autorisé, URL de moins de 255 caractères)
  4. Enregistrez l'URL de ce flux auprès de Grupo ZAP via Canal Pro ou votre interlocuteur commercial, afin que leur robot commence à le récupérer
  5. Suivez les rapports d'intégration que Grupo ZAP renvoie (via Canal Pro, par e-mail ou par webhook, selon leur documentation) et corrigez à la source les annonces rejetées

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.

À quelle fréquence le flux doit-il être mis à jour ?

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.

Erreurs de flux courantes

La documentation de Grupo ZAP et son validateur XML signalent plusieurs causes récurrentes de rejet d'annonces :

  1. Valeurs monétaires et de surface formatées avec des symboles monétaires, des séparateurs de milliers ou des décimales (par ex. « R$560.000,00 » ou « 32,20 ») au lieu de nombres entiers simples
  2. Absence de l'attribut obligatoire currency="BRL" sur les éléments de prix, ou de l'attribut unit="square metres" sur les éléments de surface
  3. Éléments Description vides ou manquants (<Description/>), ou descriptions en dehors de la plage de 50 à 3 000 caractères
  4. Absence de LivingArea (ou de LotArea pour les annonces de terrains/fermes), que le validateur traite comme une erreur bloquante
  5. Réponses HTTP 403 parce que le serveur d'hébergement bloque le User-Agent du robot
  6. URL de flux de plus de 255 caractères ou contenant des caractères/espaces non encodés
  7. Fichiers qui ne sont pas des XML VRSync valides ou qui dépassent la limite de 30 Mo du validateur

Conseils d'optimisation

Bonnes 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 :

  1. Allez au-delà du minimum de 5 images : davantage de photos, dans un ordre logique avec l'extérieur ou la plus belle pièce en premier, améliorent généralement l'engagement sur les portails d'annonces
  2. Rédigez des descriptions complètes et exactes qui exploitent toute la plage de caractères disponible plutôt que le minimum, car une description succincte de 50 caractères a peu de chances de bien convertir, même si elle passe la validation
  3. Gardez les champs de prix et de statut synchronisés en temps réel avec votre système source de votre côté, afin que le passage suivant du robot récupère toujours des données à jour et non un instantané obsolète
  4. Renseignez les éléments différenciants facultatifs lorsqu'ils sont disponibles (liens de visite virtuelle, latitude/longitude précises, détails sur le quartier ou la zone) pour aider les acheteurs à filtrer et à trouver l'annonce

FAQ

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.

À propos de Grupo Zap

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.

Découvrez quels
produits rapportent.

Connectez votre flux et GA4. Nous affichons Product Score, 4T, Price War et Broken Size sur votre propre catalogue.