Firebase Invites fournit à la fois un mécanisme pour recevoir Firebase Dynamic Links dans votre application et une fonctionnalité permettant de partager ce lien par SMS ou par e-mail. Nous avons développé Firebase Invites pour vous aider à augmenter le nombre d'utilisateurs de votre application grâce au bouche-à-oreille. Cependant, au fil du temps, nous avons constaté que vous aviez trouvé de meilleurs moyens d'encourager les utilisateurs à partager leurs applications préférées avec leurs amis, au-delà de ce que Firebase Invites propose aujourd'hui.
Nous avons également constaté que, bien que l'utilisation de Firebase Invites ait diminué, beaucoup d'entre vous utilisaient toujours Firebase Dynamic Links comme ingrédient clé de leur solution de partage entre utilisateurs. Nous allons donc redoubler d'efforts pour faire de Firebase Dynamic Links le meilleur moyen d'intégrer des fonctionnalités de partage entre utilisateurs dans votre application. Dans le cadre de cette transition, nous avons abandonné la fonctionnalité Firebase Invites et nous cesserons de la prendre en charge à partir du 24 janvier 2020.
Qu'est-ce que cela signifie et quel est l'impact pour moi ?
À partir du 24 janvier 2020, vos utilisateurs ne pourront plus envoyer ni recevoir de Firebase Invites. Le service backend d'invitations commencera à renvoyer des réponses d'erreur lors des appels pour envoyer et recevoir un lien d'invitation. Les SDK actuels incluent la gestion des erreurs pour garantir des cas d'échec élégants pour ces réponses du serveur. Vos utilisateurs pourront donc continuer à utiliser votre application sans plantage. Toutefois, nous vous recommandons de ne plus utiliser Firebase Invites et de passer à une solution alternative utilisant Firebase Dynamic Links avec une solution de partage personnalisée.
Voici comment procéder :
Créer des liens d'invitation avec Firebase Dynamic Links
Commencez par créer un Dynamic Link que vos utilisateurs pourront partager avec leurs amis. Bonne nouvelle : vous connaissez probablement déjà cette étape, car elle est semblable à la configuration de Firebase Invites. Toutefois, vous pouvez également ajouter des paramètres spécifiques à votre lien dynamique, par exemple ajouter des métadonnées sociales à vos liens si vos utilisateurs partagent votre application sur un réseau social, afin de personnaliser l'apparence de l'URL partagée.
Créer une solution de partage
Ensuite, créez votre solution de partage pour que vos utilisateurs puissent partager ce lien avec leurs amis. Ce que vous souhaitez créer ici variera en fonction de la façon dont vous souhaitez fournir la fonctionnalité de partage qui remplacera la précédente dans Firebase Invites, mais pour la plupart des applications mobiles, vous pouvez profiter des fonctionnalités déjà intégrées à la plate-forme.
Pour Android, une solution simple qui couvre le partage par SMS et par e-mail, ainsi que d'autres applications de messagerie et réseaux sociaux populaires, consiste à utiliser une intention générique avec une action définie sur Intent.ACTION_SEND. Cela permet de partager facilement des données de votre application avec n'importe quelle application installée par l'utilisateur et capable de gérer une intention de partage.
Une chaîne semblable à l'exemple suivant devrait fonctionner ici (nous vous recommandons d'utiliser des ressources de chaîne constante dans votre propre code) :
Intent sendIntent = new Intent(); sendIntent.setAction(Intent.ACTION_SEND); sendIntent.putExtra(Intent.EXTRA_TEXT, "Here's a new lesson for" + " learning more Miwok vocabulary:\n\n" + dynamicLink); sendIntent.putExtra(Intent.EXTRA_SUBJECT, "Let's Learn Miwok!"); sendIntent.setType("text/plain"); startActivity(Intent.createChooser(sendIntent, getResources().getText(R.string.send_to)));
Pour obtenir un exemple plus complet et plus de détails, consultez ce guide sur l'envoi de données simples à d'autres applications.
L'extrait de code ci-dessus générera un flux d'invitation semblable à celui illustré dans les écrans ci-dessous :
Pour les développeurs iOS, vous pouvez utiliser un UIActivityViewController en transmettant le lien créé dans les données au VC personnalisé. Cette méthode fournirait un flux de partage semblable aux écrans ci-dessous :
Recevoir un Dynamic Link dans votre application
Enfin, la dernière étape pour permettre le partage entre utilisateurs dans votre application après l'arrêt consiste à recevoir un Dynamic Link dans votre application.
Pour Android, ce processus reste le même. Vous n'aurez donc pas besoin de modifier grand-chose ici. La seule différence est qu'en l'absence de Firebase Invites, il n'y aura plus d'ID d'invitation. Vous devrez donc supprimer l'appel pour extraire l'ID d'invitation via FirebaseAppInvite invite = FirebaseAppInvite.getInvitation(data), si votre application effectue cet appel. Pour en savoir plus sur cet élément, consultez le guide Recevoir des liens dynamiques dans votre application Android.
Pour iOS, cela nécessiterait de passer de l'objet FIRReceivedInvite à l'objet FIRDynamicLink, qui contiennent tous deux des données similaires. Pour en savoir plus, consultez le guide sur la réception de liens dynamiques dans votre application iOS.
Pour les développeurs Unity, il existe un certain nombre de bibliothèques Open Source et de solutions équivalentes à celles décrites ci-dessus pour migrer votre fonctionnalité de partage entre utilisateurs. Si vous avez besoin d'aide pour trouver une solution adaptée, veuillez contacter les ressources d'assistance dont les liens sont fournis ci-dessous.
Firebase Invites est un excellent outil que nous sommes fiers d'avoir créé. À l'avenir, nous souhaitons améliorer Firebase Dynamic Links pour vous offrir plus de flexibilité et de contrôle sur la façon dont vous encouragez les utilisateurs à inviter d'autres personnes à rejoindre votre application. Si vous avez des questions sur la configuration de Firebase Dynamic Links et des solutions de partage personnalisées, veuillez nous contacter sur Stack Overflow ou sur l'un de nos forums d'assistance supplémentaires.