Thématiques
Catégories d'abonnement : le destinataire quitte un type d'e-mail et reste abonné aux autres. Une thématique peut être liée à un domaine d'envoi.
Une thématique est une catégorie d’e-mails, comme « Product updates », « Newsletter » ou « Promotions ». Les destinataires peuvent quitter une thématique et rester abonnés aux autres. Gérez les thématiques dans le tableau de bord sous Contacts → Thématiques, ou par l’API.
Chaque thématique a un default_subscription, défini à sa création et non modifiable ensuite :
opt_in: chaque contact est abonné sauf s’il se désinscrit.opt_out: un contact n’est abonné qu’après avoir donné son accord.
Une thématique a aussi une visibility. Une thématique public est listée sur la page de désinscription, et une thématique private n’apparaît que par son propre lien.
Comment les thématiques s’appliquent
- Campagnes. Une campagne peut cibler une thématique. Elle part aux contacts abonnés à cette thématique (par leur propre choix ou par la valeur par défaut de la thématique). Les contacts désinscrits pour toute l’équipe, ou qui ont quitté le domaine d’envoi, sont toujours exclus.
- E-mails individuels. Envoyez un e-mail avec un
topic_idet il respecte cette thématique. Si chaque adresse detos’est désinscrite, l’envoi renvoie422 all_recipients_suppressed. - Page de désinscription. La page liste les thématiques publiques, pour qu’un destinataire puisse en désactiver une ou quitter tous les e-mails marketing de ce domaine. Les e-mails envoyés sans
topic_idet hors campagne ne sont jamais concernés. Voir Désinscriptions.
Une thématique utilisée par une campagne, ou par un e-mail encore en attente d’envoi, ne peut pas être supprimée : l’appel renvoie 409 conflict tant que ces envois ne sont pas partis ou annulés.
curl -X POST "https://api.billionsend.com/topics" \
-H "Authorization: Bearer bs_..." \
-H "Content-Type: application/json" \
-d '{ "name": "Product updates", "default_subscription": "opt_in" }'
Vous définissez les choix d’un contact avec PATCH /contacts/{id}/topics, en passant des entrées comme { "id": "<topic-id>", "subscription": "opt_in" }. GET /contacts/{id}/topics liste toutes les thématiques avec le subscription du contact et un indicateur explicit (false quand c’est la valeur par défaut de la thématique).
Une thématique par marque
Si chacun de vos domaines est une marque à part, liez une thématique au domaine auquel elle appartient en définissant domain_id, à la création ou plus tard avec PATCH /topics/{id}, ou en choisissant le domaine dans le tableau de bord.
- Une thématique liée n’est listée que sur la page de désinscription de ce domaine. La page d’aucun autre domaine n’en affiche le nom.
- Un envoi avec ce
topic_iddoit partir de ce domaine. Depuis tout autre domaine,POST /emailset les appels de campagne renvoient422. - Une thématique sans domaine est listée sur la page de chaque domaine et peut être envoyée depuis n’importe quel domaine.
"domain_id": nullrend à une thématique liée sa portée d’équipe. - Un domaine ne peut pas être supprimé tant que des thématiques lui sont liées (
409).
Les segments peuvent être liés de la même façon.
Clés API limitées à un domaine
Une clé API limitée à un domaine ne peut créer que des thématiques liées à ce domaine, et ne peut pas en créer une pour toute l’équipe.