Transmission des annonces via l'API Ubiflow

Cet article vous présente le fonctionnement de la transmission des annonces en API avec Ubiflow, une interconnexion plus rapide et personnalisable que le format FTP.

FTP ou API : quelles différences ?

La plupart des annonces sont aujourd'hui transmises à Ubiflow au format FTP. L'interconnexion en API offre plusieurs avantages :

• Transmission immédiate de l'annonce à Ubiflow (contre une fois par jour, la nuit, en FTP)
• Modifications et corrections transmises immédiatement (contre le lendemain en FTP)
• Choix des sites annonceurs directement sur UP, pour chaque annonce
• Tableau de suivi détaillé des transmissions

Bon à savoir : même en API, un délai subsiste toujours entre la transmission à Ubiflow et la mise en ligne effective sur les sites annonceurs.
Ce délai varie selon le site (par exemple, LeBoncoin se met à jour toutes les 30 minutes).

Passer du mode FTP au mode API ne génère aucun coût supplémentaire côté UP. Nous vous invitons toutefois à vérifier ce point auprès d'Ubiflow.

Consignes à respecter pour une bonne transmission

Si vous êtes en API, plusieurs éléments doivent impérativement être vérifiés pour que la transmission d'une annonce fonctionne :

• La campagne de diffusion doit être active
• Au moins un site internet doit être sélectionné dans le tableau des médias de diffusion
• Un titre d'annonce doit être renseigné
• Un contenu d'annonce doit être renseigné
• Une date de début ET une date de fin de transmission doivent être indiquées
• La transmission doit être activée (bouton « Activer transmission »)

Astuce : vous pouvez indiquer une date de fin de transmission très éloignée dans le temps. La transmission s'interrompt automatiquement dès que le lot passe en offre à valider ou en ventes en cours.

Si une campagne active nécessite une modification, il n'est pas possible de modifier une campagne en cours de transmission : il faut d'abord interrompre la transmission, effectuer la modification (activer la campagne ou modifier les sites annonceurs), puis la réactiver.

Il reste possible de modifier le titre et texte d'annonce ainsi que les photos sans interrompre la transmission.

Choisir les sites annonceurs

Contrairement au FTP, l'API vous permet de sélectionner, pour chaque annonce, les sites annonceurs sur lesquels elle sera diffusée.

• Des médias de diffusion peuvent être paramétrés par défaut (par lot ou par résidence), ce paramétrage se fait généralement lors du déploiement
• Vous pouvez retirer un média du tableau à l'aide de l'icône de suppression en fin de ligne
• Vous pouvez ajouter un média via le bouton « Ajouter publicité », puis double-cliquer sur la ligne pour choisir l'annonceur parmi ceux déjà paramétrés

Suivre et contrôler les transmissions

Un tableau de bord permet de suivre la bonne transmission de chaque annonce :

• Dans l'ancien : Commercialisation > Liste des lots libres > Suivi Ubiflow
• Dans le neuf : Commercialisation > Programmes > Suivi Ubiflow

Ce tableau affiche un indicateur par site annonceur :

• Point vert : transmission réussie
• Point orange ou rouge : problème de transmission

En cliquant sur un point orange ou rouge, une fenêtre technique s'affiche avec le détail de l'erreur.

Lorsqu'une explication en français apparaît (exemple : absence de prix ou de titre), elle vous permet de corriger rapidement l'annonce.

Si l'information n'est pas exploitable, n'hésitez pas à nous transmettre une capture d'écran via un ticket : cela nous aide à identifier le problème plus rapidement.

Spécificité LeBoncoin : lorsque la transmission est réussie, l'URL de l'annonce est directement accessible depuis le tableau de suivi, sans avoir besoin de la rechercher sur le site.

Passer en API

Le passage au mode API ne nécessite qu'une seule action de votre part :

1. Contactez-nous pour nous indiquer votre souhait de passer en API
2. Nous demandons l'activation de l'API auprès d'Ubiflow
3. Nous finalisons le paramétrage et activons l'API de notre côté

Le paramétrage de vos médias de diffusion étant généralement déjà en place, notre intervention se limite le plus souvent à faire correspondre vos libellés avec ceux transmis par l'API Ubiflow. Nous vous contacterons en cas de difficulté lors de ce paramétrage.