Words Are Flowing

Documentation

Words Are Flowing compte ce que les gens font dans votre application, sur l'appareil, et au moment que vos règles désignent, affiche une demande de rétroaction privée ou demande à la plateforme son invite native d'évaluation.

Démarrages rapides

Ensuite : la référence des règles et la politique des magasins.

Notions

Produit
Une application ou un jeu dans le portail. Les notes, les compteurs et les règles appartiennent tous à un produit.
Clé d'API
La clé d'un produit (elle commence par waf_live_). Le SDK l'envoie avec chaque requête ; le portail l'affiche une seule fois, à sa création, et vous pouvez la renouveler.
Déclencheur
Un moment de comportement que votre code nomme, comme level_completed ou trip_finished. Lettres minuscules, chiffres et traits de soulignement, 40 caractères au plus. Vous le signalez avec TrackAsync ; le SDK compte les occurrences sur l'appareil.
Règles
Un document JSON que vous modifiez dans le portail : pour chaque déclencheur, quand afficher la demande privée et quand demander l'invite d'évaluation. Le SDK le télécharge dans InitializeAsync, donc un changement ne demande aucune mise à jour de l'application.
Demande privée
Une petite carte, « Quelque chose à corriger ? », avec une note facultative de 1 à 5 et une zone de texte. Ce que la personne écrit va dans votre portail, jamais dans un magasin.
Invite d'évaluation
L'invite d'avis propre à la plateforme : Google Play In-App Review sur Android, StoreKit sur iOS. La plateforme décide si elle apparaît vraiment, et ne le dit pas. Il n'y en a pas sur le Web.
Décision
Ce qu'un appel à TrackAsync a décidé : rien (avec une raison que vous pouvez journaliser), une demande ou une invite d'évaluation. Elle est retournée, et aussi émise par l'événement DecisionMade.

Deux actions, jamais une barrière

La demande privée et l'invite d'évaluation sont deux actions indépendantes. Le SDK ne pose jamais de question devant l'invite d'évaluation, et il n'expose aucun appel qui ouvre directement l'invite d'évaluation : elle part seulement de TrackAsync, que vous appelez depuis le comportement, jamais depuis un bouton. Vos règles peuvent ordonner les deux — la demande d'abord, l'invite d'évaluation plus tard, sautée pour qui vous a écrit récemment. Cet ordre est défendable, pas approuvé par les magasins ; la page sur la politique des magasins explique pourquoi.