Passer au contenu principal
Toutes les collectionsQuestions générales
Intégration du magasin – Facebook
Intégration du magasin – Facebook

Utilisez Facebook pour vendre des produits dans votre application

Paul Winterhalder avatar
Écrit par Paul Winterhalder
Mis à jour cette semaine

Dans ce didacticiel, nous verrons comment configurer l'intégration du magasin entre Facebook et votre application brainCloud.

Flux d'achat

  • L'application demande l'inventaire des produits "Facebook" à brainCloud, en transmettant éventuellement la devise de l'utilisateur. Elle renvoie une liste de produits, leurs prix de référence (tels que configurés dans le portail brainCloud) et leurs paires devise/prix Facebook configurées.

  • L'application présente une liste de produits avec le prix/la monnaie la plus appropriée.

  • L'utilisateur sélectionne un article à acheter

  • L'application envoie une demande à Facebook pour acheter un article.

  • Facebook communique avec brainCloud pour déterminer le catalogue de produits et leurs prix.

  • Facebook présente une boîte de dialogue de confirmation d'achat à l'utilisateur.

  • Un reçu est renvoyé par Facebook, en supposant que l'utilisateur procède à l'achat.

  • L'application demande à brainCloud de vérifier le reçu Facebook. En supposant qu'il s'agisse d'un reçu valide, brainCloud attribuera toutes les monnaies virtuelles associées à ce produit.

  • Notez que Facebook enverra un événement de mise à jour asynchrone en temps réel à brainCloud lorsqu'un produit est acheté. Il s'agit d'un mécanisme de sécurité permettant de garantir que l'article approprié est attribué à l'utilisateur (que l'application ait envoyé le reçu au serveur ou non). brainCloud n'attribuera la monnaie qu'une seule fois, quelle que soit la notification reçue en premier (le reçu de l'application ou la notification de paiement de mise à jour en temps réel de Facebook). Le comportement et le JSON renvoyé de l'appel d'API pour confirmer un reçu sont identiques quel que soit l'ordre dans lequel ces deux événements se produisent.

Configuration du portail

Prérequis

Configurer les données de prix Facebook

Une fois vos produits configurés sur la place de marché brainCloud, vous devrez remplir une liste de monnaies et de prix pour chaque produit.

  • Connectez-vous au portail brainCloud

  • Accédez à la page "Marché | Produits" dans l’onglet Conception

  • Sélectionnez le produit que vous souhaitez configurer

  • Cliquez sur le bouton "+ Modifier le produit"

  • Trouvez votre prix (ou créez-en un) et cliquez sur l'icône de modification

  • Dans la boîte de dialogue Modifier le prix, cliquez sur l'icône + pour ajouter une entrée pour Facebook

  • Cliquez sur le bouton "+ Ajouter" et configurez les informations de prix/monnaie. Vous pouvez saisir des prix distincts pour plusieurs monnaies si vous souhaitez conserver le prix du produit pour cette monnaie. Notez que Facebook convertira automatiquement les prix dans la monnaie de l'utilisateur si nécessaire.

  • À ce stade, vous souhaiterez peut-être définir votre prix comme prix par défaut s'il n'est pas déjà sélectionné. Vous pouvez le faire dans la page Modifier le produit.

  • Vous pouvez maintenant vérifier que votre produit revient avec les informations de prix Facebook correctes. Voici le résultat de l'appel API Explorer "Product.GetInventory" pour "Facebook".

Portail des développeurs Facebook

Afin de traiter les mises à jour de paiement en temps réel, vous devrez effectuer les étapes de configuration suivantes dans le portail des développeurs Facebook.

  • Sélectionnez votre application et accédez à la section "Paiements Canvas"

  • Saisissez votre URL dynamique (et tous les testeurs Facebook avec lesquels vous souhaitez tester vos achats). Notez que le format de l'URL de rappel de tarification dynamique doit être: "https://api.braincloudservers.com/fbcreditservice?app_id=YOUR_FB_APP_ID" où "YOUR_FB_APP_ID" doit être remplacé par un numéro tel que 1234567890.

  • Saisissez les URL de rappel pour les abonnements en temps réel. Notez que les deux URL doivent avoir ce format: "https://api.braincloudservers.com/fbupdateservice?gameId=YOUR_BRAINCLOUD_GAME_ID" où "YOUR_BRAINCLOUD_GAME_ID" doit être remplacé par l'ID de jeu/d'application brainCloud trouvé dans la section "Informations sur l'application principale | ID d'application" du portail brainCloud.

  • Si vous souhaitez tester l'URL de rappel, configurez un jeton de vérification sur le portail des développeurs Facebook ainsi que dans la section Facebook "Informations sur l'application principale | ID d'application" de brainCloud. Vous pouvez utiliser n'importe quelle chaîne de caractères à condition qu'elles soient identiques. Une fois configuré, le bouton "Tester l'URL de rappel" doit afficher une boîte de dialogue de réussite similaire à celle-ci.

Vous devriez maintenant être configuré pour effectuer des achats sur Facebook. Les prochaines étapes à suivre consistent à implémenter les appels API vers Facebook + brainCloud.

Avez-vous trouvé la réponse à votre question ?