Référence des règles

Un exemple complet

{
  "version": 7,
  "triggers": {
    "session_end": {
      "privateAsk": {
        "minOccurrences": 5,
        "minDaysSinceInstall": 3,
        "cooldownDays": 60,
        "skipIfSubmittedWithinDays": 180
      }
    },
    "workout_completed": {
      "storePrompt": {
        "minOccurrences": 3,
        "minDaysSinceInstall": 7,
        "cooldownDays": 120,
        "maxPerYear": 2,
        "when": {
          "appVersion": { "gte": "2.3.0" },
          "plan": { "in": ["solo", "studio"] }
        }
      }
    }
  }
}

Une personne qui a terminé cinq sessions, trois jours ou plus après le premier lancement du SDK, voit la demande privée — sauf si elle a envoyé une note dans les 180 derniers jours. Une personne qui a terminé trois entraînements, au moins une semaine après, avec la version 2.3.0 ou plus récente et l'un des deux forfaits nommés, se voit proposer l'invite d'évaluation — au plus deux fois sur toute période de 365 jours, et jamais dans les 60 jours suivant une note ni les 7 jours suivant une demande. Ici, appVersion et plan sont des attributs que l'application fixe elle-même dans Attributes ; les conditions ne lisent que ceux-là, pas l'option AppVersion.

Le document

Un produit qui n'a pas encore de règles sert {"version":0,"triggers":{}} : rien ne s'affiche, rien ne part.

Seuils

Les deux blocs acceptent ces champs. Les « occurrences » sont comptées sur l'appareil, une par appel à TrackAsync pour ce déclencheur, et ne sont jamais remises à zéro. L'« installation » est le premier lancement du SDK sur cet appareil.

Un champ propre à privateAsk :

Un champ propre à storePrompt :

Conditions

when associe une clé d'attribut à une condition. Les attributs sont ceux que votre application fixe dans Attributes. Chaque condition a exactement un opérateur :

• Un attribut que l'application n'a pas fixé fait échouer sa condition.
• eq et in comparent le texte exactement, casse comprise. Un attribut numérique ou booléen est comparé sous sa forme texte invariante ; un booléen se lit True ou False.
• gte et lte comparent soit deux versions à points (deux points ou plus, comme 2.3.0), soit deux nombres décimaux (10, 0.75). Une version contre un nombre échoue plutôt que de deviner : écrivez 2.3.0, pas 2.3, pour comparer des versions. Une valeur qui n'est ni l'un ni l'autre est refusée à l'enregistrement.
• Les clés d'attribut sont faites de lettres, de chiffres, de _ et de -, de 1 à 40 caractères.

Comment une décision est prise

Chaque appel à TrackAsync compte une occurrence, puis :

1. Si la boucle a déjà affiché une demande ou lancé une invite d'évaluation, plus rien ne se passe pour le reste de sa vie — une action par session.
2. Si le déclencheur a un privateAsk dont tous les seuils et conditions passent, et qu'aucune note n'a été envoyée dans les skipIfSubmittedWithinDays, la demande est lancée. La demande passe toujours en premier.
3. Sinon, si le déclencheur a un storePrompt dont tous les seuils et conditions passent, le moteur vérifie ensuite ses périodes de silence fixes et le plafond, puis sollicite la plateforme.

Les limites fixes du moteur s'appliquent, quoi que disent les règles :

• Au plus 3 invites d'évaluation sur toute période glissante de 365 jours, sur toutes les plateformes.
• Aucune invite dans les 60 jours suivant une note envoyée par la personne.
• Aucune invite dans les 7 jours suivant une demande affichée à la personne, qu'elle y ait répondu ou non.

Limites

Un enregistrement est refusé, avec chaque problème énuméré, quand le document enfreint l'une de ces règles :

• Au plus 50 déclencheurs, chacun avec un nom valide et au moins un bloc.
• Au plus 10 conditions par bloc, chacune avec une clé valide et exactement un opérateur.
• Chaque seuil dans sa plage permise (plus haut).

Le document enregistré doit aussi compter au plus 65 536 caractères (rules.too_large). Le SDK applique la même validation à un document téléchargé et garde ses règles en cache si le nouveau échoue.

Raisons

Quand rien ne se passe, la Reason de la Decision est l'une de ces chaînes stables, sûres à journaliser :