Notification de relance pour les joueurs réguliers qui décrochent pour la 1re fois (J+5, environ 1 envoi par jour) #5037

Objectif

Chaque jour, détecter les joueurs en train de décrocher mais encore récupérables, et leur envoyer une notification personnalisée qui leur donne une raison concrète de revenir.

Critères « perdu mais récupérable » (stricts, anti-spam)

Cible : un joueur régulier qui casse son habitude pour la première fois depuis longtemps. Les joueurs qui alternent souvent pauses et reprises sont exclus : ils reviennent d'eux-mêmes.

Un joueur est éligible le jour où toutes ces conditions sont vraies :

Garde-fous supplémentaires :

• Pas d'envoi rétroactif au lancement : la condition 5 ne vise que le jour J+5 exact, donc les joueurs déjà partis ne reçoivent rien.
• Plafond global : au maximum 20 envois par exécution quotidienne (sécurité en cas de bug de requête ; le volume attendu est d'environ 1 par jour).
• Si le DM échoue (DMs fermés), ne pas réessayer et marquer quand même la notification comme envoyée.

Volume et intérêt (calculé sur les 12 derniers mois)

→ Avec ces critères, on envoie environ 1 notification tous les 1 à 2 jours, en pratique une seule fois par joueur, et uniquement aux joueurs les plus à risque.

Pourquoi J+5 : avant, la plupart reviennent d'eux-mêmes. Après J+10, les retours tiennent mal (part des joueurs qui rejouent au moins 5 jours dans les 30 jours suivant le retour : 73 % après 3-4 j d'absence, 61 % après 5-7 j, 49 % après 8-10 j, 37 % après 11-21 j).

Contenu de la notification

Une seule notification, dont la phrase d'accroche est choisie selon l'état du joueur, par ordre de priorité (la première qui s'applique) :

1. Objectif de campagne en cours (lien avec Afficher l'objectif de campagne en cours (avec la commande à utiliser) dans /report #5036) : « Votre prochain objectif vous attend : {mission} ({command}). »
2. Voyage terminé : « Vous êtes arrivé à {destination} depuis plusieurs jours, de nouvelles aventures vous y attendent. »
3. Familier : « {familier} attend votre retour pour repartir en expédition. »
4. Guilde : « Votre guilde {guilde} a continué de progresser en votre absence. »
5. Par défaut : « Vos jetons sont rechargés et de nouvelles rencontres vous attendent sur les routes. »

Règles de rédaction : uniquement en FR (les autres langues via Crowdin), pas de discours direct, emojis via {emote:…}, commande cliquable via {command:…}.

Implémentation proposée

• Core : nouvelle tâche dans CrowniclesDaily qui :
  1. sélectionne dans la base de logs (players_commands) les joueurs dont la dernière commande date d'exactement 5 jours et qui vérifient les critères 2, 3 et 4 ; puis filtre par niveau ≥ 4 et non banni dans la base de jeu ;
  2. exclut les joueurs déjà relancés dans les 180 derniers jours (nouvelle colonne lastComebackNotificationAt sur players, ou petite table dédiée, via migration), puis applique le plafond global ;
  3. détermine l'accroche (hook) et envoie un ComebackNotificationPacket via PacketUtils.sendNotifications.

  Ne pas s'appuyer sur players.lastActivityAt : elle ne reflète pas la dernière commande, et la base de jeu contient des valeurs aberrantes.

• Lib : ComebackNotificationPacket (keycloakId, hook : union typée dérivée d'un objet as const, plus les paramètres de l'accroche : id de mission, id de lieu, nom du familier ou de la guilde).
• Discord : nouveau NotificationsTypes.COMEBACK (activé par défaut, envoi en DM) + colonnes comebackEnabled / comebackSendType / comebackChannelId dans NotificationsConfiguration (migration), visible et désactivable dans /notifications ; traitement dans NotificationsHandler.

Mesure de l'effet

• Groupe témoin : 20 % des joueurs éligibles, tirés au hasard, ne reçoivent pas la notification. Logguer chaque envoi, en distinguant envoyé et témoin. Sans ce groupe, l'effet est impossible à mesurer, puisque 63 % des éligibles reviennent déjà d'eux-mêmes sous 35 jours.
• Indicateurs, envoyés contre témoin :
  • % de retours sous 7 j et sous 30 j (référence : ~63 % sous 35 j) ;
  • % qui rejouent au moins 5 jours dans les 30 jours suivant le retour (référence : 61 %) ;
  • taux de désactivation de la notification.

Hors périmètre

• Cadeau / bonus de retour (à envisager dans un second temps si l'effet est faible).
• Relances multiples, joueurs absents depuis plus de 5 jours au lancement, joueurs occasionnels ou habitués des pauses.
• Joueurs n'ayant pas atteint le niveau 4 (cf. tutoriel, Refonte du système de tutoriel / onboarding #4125).