Catégories
Start-up et applications

Western Union montre comment les cas d'utilisation permettent une excellente expérience de développeur

Si votre organisation fournit des API, le succès de ces API dépend de la façon dont votre portail de développeur d'API les met en évidence et les explique. Les parties prenantes actuelles et futures se rendront sur votre portail de développeur d'API pour en savoir plus sur vos API et même votre entreprise, à la fois d'un point de vue technique et tout aussi important, d'un point de vue commercial. Comment vous assurez-vous que votre portail de développeur est le meilleur de sa catégorie? Il existe un certain nombre de facettes qui entrent dans les principaux portails d'API et ProgrammableWeb a écrit une série d'articles pour vous aider à comprendre quelles sont les meilleures pratiques utilisées par les principaux fournisseurs.

L'article initial de cette série fournit une liste de contrôle complète des critères nécessaires pour créer un portail de développeur d'API de classe mondiale. Les articles suivants du Choix de l'éditeur, y compris celui-ci, fourniront un aperçu plus approfondi de la façon dont les fournisseurs d'API individuels ont exécuté les différents critères.

Aujourd'hui, nous examinons la société de services de transfert d'argent et de paiements Western Union et comment elle tire parti des cas d'utilisation pour améliorer l'expérience développeur (DX) pour les visiteurs de son portail API.

Dans notre article sur la liste de contrôle, nous avons discuté de l'importance d'expliquer l'analyse de rentabilisation de votre API à un décideur qui pourrait en apprendre davantage sur votre API pour la première fois. Au-delà de cela, une méthode éprouvée pour interagir avec ce public consiste à montrer des exemples de cas d'utilisation qui traitent de la façon dont vos API peuvent résoudre les problèmes spécifiques d'un développeur. Des cas d'utilisation soigneusement pensés ont la capacité de fonctionner non seulement pour un public de niveau exécutif, mais aussi pour les visiteurs qui travaillent au niveau d'un produit et qui espèrent comprendre toutes les possibilités offertes par vos API. Les descriptions des cas d'utilisation n'ont pas besoin d'être longues, mais elles doivent se concentrer sur les résultats plutôt que sur la liste d'un ensemble de fonctionnalités. Si un utilisateur visite votre portail pour la première fois et ne sait pas exactement ce que fait votre API ou pourquoi il devrait l'utiliser, vous devez pouvoir lui raconter une histoire courte qui le convainc que vous comprenez bien l'espace et que vous êtes les mieux placés pour les aider.

Nous devrions prendre un moment pour discuter de la différence entre un cas d'utilisation et une étude de cas. Un cas d'utilisation doit être de nature générale. Il doit indiquer comment l'API peut aider les développeurs à résoudre leurs problèmes et les résultats qui peuvent être activés par l'API. Elle ne doit cependant pas être spécifique à l'expérience API d'un client. Les études de cas, d'autre part, visent à donner vie aux histoires des clients, y compris les défis auxquels ils étaient confrontés, les solutions vers lesquelles ils se sont tournés et les résultats commerciaux (qualitatifs ou quantitatifs). Nous avons précédemment expliqué comment les études de cas de Twilio sont les meilleures de leur catégorie.

Le portail des développeurs de Western Union met en évidence la disponibilité de ses cas d'utilisation directement sur sa page d'accueil. Sous une bannière et une déclaration qui fait l'analyse de rentabilisation de l'API se trouve un graphique offrant des liens vers trois cas d'utilisation complets, puis deux autres liens qui couvrent des cas d'utilisation supplémentaires. Au total, Western Union propose sept cas d'utilisation différents à explorer. Le fait que Western Union ait consacré autant de biens immobiliers à ses cas d'utilisation est un signe qu'elle comprend la nécessité de sensibiliser les décideurs à son API.

Figure 1 La page de destination du portail des développeurs Western Union met en évidence cinq cas d'utilisation de son API

Les deux façons de présenter les cas d'utilisation sont de fournir un résumé ou une liste à puces sur la page d'accueil du portail qui aborde les façons dont votre API peut résoudre les problèmes auxquels un développeur peut être confronté, ou de préférence d'écrire un récit plus détaillé qui réside sur son propre page. Si vous choisissez la deuxième méthode, vous devrez donner à l'utilisateur un moyen clair de les trouver, soit via des liens sur la page, soit dans la navigation du portail.

La figure 2 de Western Union fournit un bref et précis résultat pour des cas d'utilisation réels de l'API avec des graphiques attrayants.

Western Union présente chaque cas d'utilisation avec un format cohérent et basé sur des modèles. En haut de chaque page se trouve une image de bannière, le nom du cas d'utilisation et une brève description. La description décrit l'expérience qui est activée pour les clients grâce à l'utilisation de l'API en utilisant un langage concis et clair, ce qui permet aux décideurs de comprendre facilement la valeur.

Sous la bannière se trouve plus de texte, reformulant le cas d'utilisation si l'utilisateur l'a manqué dans la bannière. Sous le texte se trouve l'une des caractéristiques les plus uniques que nous ayons rencontrées. Western Union a choisi de montrer le parcours du client en utilisant un ensemble de graphiques étape par étape attrayant avec le texte qui l'accompagne. Ce traitement simplifie le cas d'utilisation en un flux de travail facile à suivre qui pourrait facilement ressembler au même processus commercial dans n'importe quelle autre entreprise. En conséquence, les cas d'utilisation prennent vie d'une manière que nous avons rarement, voire jamais, vue.

Figure 3 Chaque cas d'utilisation est résumé avec les principaux avantages et un lien vers la façon dont les partenaires ont été activés par eux

Chaque cas d'utilisation se termine par un résumé des principaux avantages. Ici, nous commençons à voir plus de mention des fonctionnalités au lieu des résultats client, mais à ce stade, cela semble approprié. Certains des cas d'utilisation sont également liés à une histoire client avec plus de détails sur la façon dont les partenaires ont été activés par l'API. C'est une bonne idée et devrait être standard pour un portail API. Idéalement, un fournisseur devrait avoir une étude de cas pour chaque cas d'utilisation.

Les cas d'utilisation sont une partie souvent négligée des portails de développement d'API. Mais ils peuvent être un moyen rapide et efficace de dialoguer avec les décideurs. Au minimum, tous les portails devraient avoir un ensemble de cas d'utilisation, même s'ils ne sont guère plus que des résumés. Western Union a créé l'un des meilleurs ensembles de cas d'utilisation que nous ayons rencontrés. Il a pris le temps de présenter clairement les scénarios du monde réel permis par son API qui permet aux décideurs de voir comment leurs problèmes sont traités. Pour ces raisons, ProgrammableWeb souhaite décerner un prix Choix de l'éditeur pour l'excellence de son expérience de développeur (DX) à Western Union.

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *