
Le rapport hebdomadaire : totaux du foyer, votre propre semaine et le classement.
Une requête par foyer, personnalisée pour chaque personne \
La fonction envoie une requête par foyer. Elle transmet toutes les données danscustom_data, y compris un objet users indexé par External ID. Le modèle sélectionne ensuite la bonne entrée pour la personne à qui il est destiné.
supabase/functions/weekly-report/index.ts
email-templates/weekly-report.html
user contient les statistiques de cette personne, et tout ce qui est lu directement dans message.custom_data est commun au foyer.
email-templates/weekly-report.html
Le second exemple Liquid est une version simplifiée du modèle, qui montre la logique sans le balisage du tableau.
Rester sous la limite de taille \
Lecustom_data pour l’e-mail est limité à 10 Ko. Un grand foyer pourrait dépasser cette limite, la fonction mesure donc le payload et raccourcit le classement si nécessaire.
supabase/functions/weekly-report/index.ts
Planification et préférences \
Une planification hebdomadaire appelle la fonction chaque dimanche à 09:00 UTC, avec le même principepg_cron que les rappels push et l’expression 0 9 * * 0. Seuls les utilisateurs ayant activé Weekly Email Summary sont inclus.
Configuration du tableau de bord. Dans Messages > Templates, créez un modèle d’e-mail, collez-y le HTML et copiez l’ID du modèle dans les secrets de votre backend. custom_data ne fonctionne qu’avec un modèle, template_id est donc obligatoire.
L’alternative : les Data Feeds \
Il existe une seconde façon d’intégrer des données propres à chaque personne dans un e-mail, et Clean Beans a choisi de ne pas l’utiliser. Elle mérite d’être comprise, car pour certaines applications elle est plus adaptée. Aveccustom_data, votre backend pousse les données vers OneSignal au moment de l’envoi. Avec un Data Feed, OneSignal récupère les données depuis votre API au moment où chaque e-mail est envoyé. L’envoi lui-même est lancé par un Journey, et non par votre backend.
Les exemples de cette sous-section sont illustratifs. Ils montrent comment le rapport hebdomadaire aurait été construit avec un Data Feed. Ils ne sont pas tirés de l’application.
1
Exposer un endpoint qui renvoie la semaine d'une personne
Une fonction backend reçoit un ID utilisateur et renvoie en JSON les statistiques de cet utilisateur et le classement de son foyer.
Response from your API
2
Créer le Data Feed dans le tableau de bord
Dans Settings > Data feeds, donnez un alias au feed et faites-le pointer vers l’endpoint. L’URL et les en-têtes acceptent le Liquid, l’External ID du destinataire peut donc être transmis.
Data Feed configuration
3
Associer le feed au modèle d'e-mail et y lire les données
Dans le modèle, les valeurs proviennent de
data_feed, suivi de l’alias.Email template
4
L'envoyer depuis un Journey récurrent
Un Journey dont la première étape est une fenêtre horaire le dimanche matin, avec une règle de réentrée, envoie le modèle chaque semaine. Aucun code de planification ni d’envoi ne se trouve dans votre backend.
Laquelle utiliser \
Choisissez
custom_data lorsque votre backend est déjà celui qui décide d’envoyer. C’est le cas du rapport hebdomadaire. Le backend s’exécute selon une planification, sait quels foyers ont donné leur accord et dispose de tous les chiffres, transmettre les données ne coûte donc rien de plus. Une requête couvre tout un foyer, il n’y a aucun endpoint à protéger et une erreur apparaît dans vos propres journaux. La contrepartie est que le moment et l’audience sont définis dans le code, et que le payload a une limite de taille fixe.
Choisissez un Data Feed lorsque l’envoi relève d’un Journey. Un Journey décide lui-même quand envoyer un message à quelqu’un, plusieurs jours après un événement ou une fois une condition d’attente remplie, et votre backend n’est pas là pour fournir les données à ce moment-là. Un Data Feed comble ce manque, et il permet aux personnes qui gèrent la messagerie de modifier la planification, d’ajouter une branche ou de tester des variantes sans déploiement. La contrepartie est que votre API est appelée une fois par destinataire et doit répondre en environ un quart de seconde, que chaque modèle ne peut utiliser qu’un seul feed et qu’un appel en échec signifie que la personne ne reçoit rien, sans avertissement.
Pour Clean Beans, les critères décisifs étaient simples. Le backend disposait déjà des données et de la planification, le classement est commun à un foyer, une seule requête coûte donc bien moins cher qu’un appel par personne, et les préférences sont stockées dans la base de données de l’application, où le backend peut les vérifier directement.
Personnaliser avec custom_data
Limites de taille et modèles d’accès Liquid.
Data feeds
Intégrer des données en temps réel dans les e-mails et SMS des Journeys.
Utiliser la syntaxe Liquid
Filtres, boucles et conditions.