Triggerregels vormen de kern van MagicAI Engage: ze bepalen wie er wordt gecontacteerd, op welke kanalen, en hoe de outreach wordt gemeten. Dit artikel behandelt de negen standaardregels, hoe u een regel aanmaakt en bewerkt, de voorwaardevelden en operatoren, de bezorgkanalen en -paden, de A/B-test, opslaan en activeren, de berichtbeveiligingen, en hoe prioriteit bepaalt wat er gebeurt met leden die tegelijk aan meerdere regels voldoen.
Inhoud
- De negen standaard triggerregels
- Een triggerregel aanmaken en bewerken
- Voorwaarden: wie wordt bereikt
- Referentie van voorwaardevelden
- Operatoren
- Filter op contracttype
- Kanalen: hoe leden worden bereikt
- Bezorgpad: eenrichting of via de AI-agent
- A/B-test
- Berichtbeveiligingen
- Opslaan en activeren
- Prioriteit en oplossing bij meerdere matches
- Koppeling met MagicAI Chat
De negen standaard triggerregels
Er worden automatisch negen standaardregels aangemaakt wanneer u een configuratie aanmaakt, geordend op prioriteit (positie 0 draait eerst). Ze starten allemaal inactief.
| Prioriteit | Regel | Categorie | Standaardvoorwaarde | Cooldown |
|---|---|---|---|---|
| 0 | Churn Risk | Churn Risk | Churn risk band ≥ High | 30 dagen |
| 1 | New Joiner Churn 3M | New Joiner Churn | New joiner churn band 3M ≥ High | 30 dagen |
| 2 | New Joiner Churn 6M | New Joiner Churn | New joiner churn band 6M ≥ High | 30 dagen |
| 3 | New Joiner Churn 12M | New Joiner Churn | New joiner churn band 12M ≥ High | 30 dagen |
| 4 | Dormancy | Dormancy | Days since last visit > 15 | 30 dagen |
| 5 | Attendance Drop | Attendance Drop | Is driften = Yes | 14 dagen |
| 6 | Contract Expiry | Contract Expiry | Days until contract end ≤ 30 | 14 dagen |
| 7 | New Member | New Member | Days since contract start < 14 | 7 dagen |
| 8 | Custom | Custom | Geen (voeg uw eigen toe) | 7 dagen |
In de live build zijn regels 0 tot en met 3 van het type AI Model; regels 4 tot en met 8 zijn van het type Custom Rule. Deze standaardwaarden zijn uitgangspunten. U kunt voorwaarden, kanalen, cooldowns en prioriteiten vrij bewerken.
Bij go-live is er één ingebouwde Custom-regel (prioriteit 8, regel #9), die u net als elke andere regel configureert. In een latere release kunnen exploitanten daarnaast hun eigen custom-regels aanmaken, tot 5 per Members-doelgroep, als eenmalige berichttriggers (geen dynamische opvolgingsworkflows).
De negen regels hierboven horen allemaal bij de doelgroep Members. Twee andere triggers draaien op hun eigen gebeurtenisgestuurde doelgroepen. Op de doelgroep Leads vuurt een New-Lead welcome-trigger af wanneer er een nieuwe lead wordt aangemaakt en neemt deze één keer contact op. Op de doelgroep Former Members benadert een win-back-trigger een lid dat heeft opgezegd één keer, op het moment van opzegging plus een configureerbaar aantal dagen (standaard 30), en altijd slechts één keer per lid. Beide zijn gebeurtenisgestuurd in plaats van ingepland in de dagelijkse batch, en beide vallen buiten de A/B-splitsing.
Wat de categorieën betekenen:
- Churn Risk: leden met een verhoogde algemene churn risk-band. Dit is de breedste retentieregel.
- New Joiner Churn: leden in hun eerste jaar wier vroege gedrag wijst op een verhoogd churnrisico. Beoordeeld door speciale modellen 42 dagen (6 weken) nadat het contract is ingegaan, over drie opzeghorizonnen (3, 6 en 12 maanden). Zie ook: Het churn risk-signaal.
- Dormancy: leden die helemaal gestopt zijn met bezoeken. De standaarddrempel is 15 dagen sinds het laatste bezoek. Dit is uw "we missen u"-regel.
- Attendance Drop: leden die nog steeds bezoeken maar merkbaar minder vaak. Anders dan dormancy: het lid is actief maar neemt af, wat vaak het vroegere en beter aanpakbare signaal is.
- Contract Expiry: leden wier contract binnenkort afloopt. Gebruik dit om opnieuw contact te maken voordat er een opzegbeslissing wordt genomen. Een contract in de opzegtermijn is nog steeds actief tot de einddatum.
- New Member: leden die net lid zijn geworden. Gebruik dit om hen welkom te heten en de onboarding te begeleiden tijdens de kritieke eerste twee weken.
- Custom: geen standaardvoorwaarde. Bouw elke gewenste targetinglogica op uit de beschikbare voorwaardevelden.
Een triggerregel aanmaken en bewerken
Klap een regelrij uit in het tabblad Configuration om deze te bewerken. De editor is ingedeeld in WHO (targetingvoorwaarden), HOW (bezorgkanalen), WHEN (trigger-cooldown) en A/B testing. Een samenvattingsbanner bovenaan vertaalt de regel naar gewone taal, de kaart Rule Info toont het type, de categorie, de prioriteit en het aantal kanalen, en de kaart Audience toont hoeveel leden momenteel matchen.
De regeleditor (Churn Risk): WHO-voorwaarden, HOW-kanalen, WHEN-cooldown en A/B-test op één plek, met een live doelgroepteller.
Voorwaarden: wie wordt bereikt
Voeg ten minste één voorwaarde toe. Wanneer een regel meerdere voorwaarden heeft, moet een lid aan alle voorwaarden voldoen. Voorwaarden worden geëvalueerd tegen een ledendata-snapshot die eenmaal per dag wordt ververst, dus een regel ziet altijd de staat van elk lid vanaf de meest recente verversing.
Referentie van voorwaardevelden
De onderstaande voorwaardevelden kunnen in elke regel worden gecombineerd; de velden worden niet beperkt door categorie en verschijnen als één platte lijst in de vervolgkeuzelijst. De bepalende voorwaarde van een standaardregel is bewerkbaar en verwijderbaar, niet vergrendeld.
| Veld | Wat het bevat en hoe het wordt berekend |
|---|---|
| Churn risk | De algemene churn risk-band: Very Low, Low, Medium, High of Very High. Leeg wanneer het lid geen band heeft (geen marketingtoestemming, geen actief contract, jonger dan 18, of onvoldoende data). Vergelijkingen zijn geordend, dus "≥ High" matcht High en Very High. |
| New joiner churn risk (3M) | Risicoband van het speciale model voor nieuwe leden op de opzeghorizon van 3 maanden, met dezelfde vijf banden. Beschikbaar zodra het lid is beoordeeld; daarvoor leeg. |
| New joiner churn risk (6M) | Risicoband van het model voor nieuwe leden op de opzeghorizon van 6 maanden, met dezelfde vijf banden. |
| New joiner churn risk (12M) | Risicoband van het model voor nieuwe leden op de opzeghorizon van 12 maanden, met dezelfde vijf banden. |
| Days Until Contract End | Volledige dagen tussen vandaag en de geplande einddatum van het contract. Leeg voor contracten voor onbepaalde tijd. De standaardregel Contract Expiry gebruikt "≤ 30". |
| Days Since Last Visit | Volledige dagen sinds de meest recente check-in van het lid. 0 betekent dat ze vandaag hebben bezocht. Leeg als het lid de afgelopen 12 maanden niet heeft bezocht. De standaardregel Dormancy gebruikt "> 15". |
| Days Since Contract Start | Volledige dagen tussen de contractstartdatum en vandaag. De standaardregel New Member gebruikt "< 14". |
| Days Since Cancellation | Volledige dagen sinds de opzegging werd geregistreerd. Alleen opgezegde contracten hebben een waarde. |
| Visits (Last 14 Days) | Aantal check-ins in het voortschrijdende venster van 14 dagen dat vandaag eindigt. |
| Visits (Last 60 Days) | Aantal check-ins in het voortschrijdende venster van 60 dagen dat vandaag eindigt. |
| Contract Type | Het type van het hoofdlidmaatschapscontract van het lid. Werkt met =, ≠ en contains. Dit is ook beschikbaar als het regelbrede insluit/uitsluit-filter op contracttype. |
| Contract price | Prijs die in rekening wordt gebracht voor de huidige betaalperiode van het contract. |
| Payment frequency | Hoe vaak het contract wordt gefactureerd, zoals maandelijks, per kwartaal of jaarlijks. |
| Contract extension | Verlengingsmodel voor het contract, zoals bepaalde duur of automatisch verlengend. |
| Payment method | De geconfigureerde betaalmethode van het lid, zoals automatische incasso, kaart of contant. |
| Payment type | Type betalingsregeling dat aan het contract is gekoppeld. |
| Payment interval unit | Tijdseenheid die voor facturering wordt gebruikt, zoals dag, week, maand of jaar. |
| Payment interval length | Aantal betaalintervaleenheden tussen incasso's. Bijvoorbeeld: 3 maanden betekent facturering per kwartaal. |
| Pre-use type | Configuratie voor de periode voordat het contract kan worden gebruikt. |
| Contract term | Lengte van de contractduur in maanden. Termijnen die in weken of dagen zijn opgeslagen, worden omgerekend met een gemiddelde maandlengte. |
| Days since contract created | Volledige dagen sinds het huidige contract in het systeem is aangemaakt, wat kan verschillen van de contractstartdatum. |
| Days since last collection | Aantal dagen sinds de laatste incassodatum. |
| Last payment amount | Totaal verwacht bedrag van de laatste incasso. |
| Last payment paid amount | Bedrag dat daadwerkelijk is betaald voor de laatste incasso na aanpassingen. |
| Attendance trend | Recente richting van het bezoek. Waarden zijn onder meer very high increase, slight increase, normal, slight decrease, very high decrease en no data. |
| Is drifting | Of het lid zijn trainingsgewoonte verliest: Yes wanneer ze 3 of meer check-ins hadden in de voorlaatste twee weken (dag 15–28) en slechts 1 of 2 check-ins in de laatste twee weken (dag 1–14), anders No. De standaardregel Attendance Drop gebruikt "= Yes". |
| Origin type | De acquisitiebron die de lead heeft aangemaakt, zoals een landingspagina, een gepersonaliseerde aanbiedingspagina of MySports. Gebruik contains MySports om MySports, MySports App en MySports Web in één regel te dekken; is MySports omvat de waarden App en Web niet. Wordt voornamelijk gebruikt door de leadtriggers; zie De New lead-trigger in Engage configureren. |
De WHO-voorwaardevelden die in de vervolgkeuzelijst worden aangeboden.
Operatoren
Welke operatoren worden aangeboden, hangt af van het veldtype. Een risicoband-veld biedt er vier (≥, ≤, =, ≠). Een numeriek veld biedt er vijf (>, ≥, <, ≤, =, zonder ≠). Het veld contract type biedt =, ≠ en contains.
| Operator | Werkt met | Betekenis |
|---|---|---|
| > | Numerieke velden | De ledenwaarde is strikt groter dan de drempel |
| ≥ | Numerieke velden, risicobanden | De ledenwaarde is groter dan of gelijk aan de drempel |
| < | Numerieke velden | De ledenwaarde is strikt kleiner dan de drempel |
| ≤ | Numerieke velden, risicobanden | De ledenwaarde is kleiner dan of gelijk aan de drempel |
| = | Numerieke velden, risicobanden, contract type | De ledenwaarde is exact gelijk aan de drempel |
| ≠ | Risicobanden, contract type | De ledenwaarde is niet gelijk aan de drempel |
| contains | Contract type | De ledenwaarde bevat de drempel als subtekenreeks (niet hoofdlettergevoelig) |
Risicobanden vergelijken in deze volgorde: Very Low < Low < Medium < High < Very High.
Filter op contracttype
Onafhankelijk van voorwaarden kunt u specifieke contracttypes voor de hele regel insluiten of uitsluiten. Gebruik dit om bijvoorbeeld proef- of bedrijfscontracten buiten retentiecampagnes te houden.
Kanalen: hoe leden worden bereikt
Voeg ten minste één kanaal toe. Elk kanaal vereist een berichtsjabloon (aangemaakt in het tabblad Templates). Alleen WhatsApp biedt een AI-agentpad; Email, SMS en de MySports App-push zijn directe, eenrichtingsverzendingen.
| Kanaal | Sjabloon | Agent |
|---|---|---|
| Vereist ("WhatsApp requires a template"). Gebruikt de Meta-verbinding en een door Meta goedgekeurd sjabloon. Zie ook: WhatsApp instellen voor Engage. | AI Chatbot (tweerichting). Bezorgd via de MagicAI Chat-agent, zodat het lid kan antwoorden. | |
| Vereist. Verzonden naar het geregistreerde e-mailadres van het lid; leden zonder e-mailadres worden voor dit kanaal overgeslagen. | Geen (direct) | |
| SMS | Vereist. Verzonden naar het geregistreerde mobiele nummer van het lid; leden zonder nummer worden voor dit kanaal overgeslagen. | Geen (direct) |
| MySports App | Vereist. Pushmelding via de MySports App; vereist dat de app is geactiveerd voor de studio. | Geen (direct) |
Kanalen en het agentpad in de HOW-stap: alleen WhatsApp kan agent-gebaseerd zijn (via de MagicAI Chat AI-agent); Email, SMS en de MySports App-push zijn eenrichting.
Voor elke trigger en elk kanaal wordt een standaardsjabloon geleverd, zodat elke regel vanaf het begin iets heeft om te verzenden. Bewerk deze of maak uw eigen sjablonen aan in het tabblad Templates.
Bezorgpad: eenrichting of via de AI-agent
Elke bezorging wordt vastgelegd met een van twee paden, weergegeven in de kolom Path van het tabblad Delivery:
- Enkele reis: het bericht gaat rechtstreeks naar het lid via de kanaalprovider (e-mailprovider, SMS-gateway, enzovoort).
- Agent: het bericht wordt bezorgd via de MagicAI Chat-agent. De outreach landt als een chatgesprek, het lid kan antwoorden en de AI-agent handelt de opvolging af.
U kiest het pad niet met een aparte selector. Het wordt bepaald door of u een agent op het kanaal configureert in de regeleditor: als het WhatsApp-kanaal in een regel een agent geconfigureerd heeft, gebruikt de bezorging het Agent-pad; anders is het eenrichting.
Voorwaarde: bezorging via de AI-agent vereist een actieve MagicAI Chat-configuratie. Zonder deze gaat het bericht uit als een gewone eenrichtingsverzending. De MySports App-push is altijd een eenrichtingsmelding.
A/B-test
A/B-testen wordt eenmalig, globaal, voor de doelgroep Members geconfigureerd, bovenaan het tabblad Configuration. Het is optioneel en standaard uitgeschakeld; zolang het uitgeschakeld is, ontvangen alle matchende leden berichten.
- Wanneer ingeschakeld, stelt u de splitsing in tussen de treatmentgroep (Groep A, gecontacteerd) en de controlgroep (Groep B, achtergehouden). Er worden drie presets aangeboden: 90/10, 80/20 en 50/50. 80/20 is een goede standaard voor de meeste studio's.
- De splitsing is globaal voor de doelgroep Members: elk lid behoudt dezelfde groep over elke trigger en elke uitvoering. Een lid in de controlegroep ontvangt geen berichten van welke Members-trigger dan ook en verschijnt in het bezorglogboek als control (niet aangeschreven).
- Eén globale splitsing, in plaats van een aparte splitsing per trigger, houdt de meting zuiver. Een splitsing per trigger zou hetzelfde lid onder de ene trigger in treatment en onder een andere in control kunnen plaatsen, wat de waarde van de impactanalyse teniet zou doen.
- Leads en Former Members vallen buiten de splitsing: hun gebeurtenisgestuurde triggers verzenden altijd naar iedereen die matcht.
De afweging is bewust: de controlegroep ontvangt geen outreach, dus u geeft wat kortetermijnbereik op in ruil voor de wetenschap of de outreach werkt. Zie ook: Impact Analysis.
Globaal A/B-testen, alleen Members, met presets 90/10, 80/20 en 50/50 en live treatment/control-tellingen.
Berichtbeveiligingen
Engage heeft ingebouwde bescherming tegen te veel berichten. Twee beveiligingen worden op elke triggerregel en via prioriteit geconfigureerd; twee andere zijn globale instellingen op het tabblad Delivery.
- Cooldown per regel. Op elke triggerregel in dagen geconfigureerd. Als een lid binnen de laatste N dagen een verzonden bericht van deze specifieke regel heeft ontvangen, wordt het overgeslagen. Standaarden: 30 dagen voor Churn Risk, New Joiner Churn en Dormancy; 14 dagen voor Attendance Drop en Contract Expiry; 7 dagen voor New Member en Custom. De cooldown op 0 zetten schakelt deze uit voor die regel.
- Dedup bij meerdere matches. Binnen één dagelijkse uitvoering kan een lid maar door één regel worden gecontacteerd (zie Prioriteit en oplossing bij meerdere matches, hieronder).
- Rusturen (quiet hours) en dagelijkse en wekelijkse frequentielimieten zijn globale instellingen die op het tabblad Delivery worden geconfigureerd en worden gedeeld door alle studio's die aan de configuratie zijn gekoppeld. Zie ook: Triggers uitvoeren (planning, voorbeeld en uitvoeringslogboek) voor hoe deze worden geconfigureerd en zich gedragen.
Opslaan en activeren
- Bij het opslaan moet elke regel ten minste één voorwaarde en één kanaal hebben, en elke voorwaarde moet een waarde hebben. De Custom-regel wordt geleverd zonder voorwaarde, dus u moet er een toevoegen voordat deze kan worden geactiveerd.
- Zet elke regel op actief of inactief. Alleen actieve regels draaien in de dagelijkse batch.
- Stel de prioriteit in door regels omhoog of omlaag te verplaatsen in de lijst. Prioriteit bepaalt welke regel wint wanneer een lid aan meerdere voldoet (zie hieronder).
Prioriteit en oplossing bij meerdere matches
Een lid kan gemakkelijk aan meerdere regels tegelijk voldoen: iemand met een hoog churnrisico die drie weken niet is geweest, voldoet zowel aan de regel Churn Risk als aan de regel Dormancy. Engage lost dit op met een eenvoudige regel.
Eerste claim wint. Als een lid aan meerdere actieve regels voldoet, contacteert de regel met de hoogste prioriteit (laagste positienummer) het lid als eerste. Regels met een lagere prioriteit slaan dat lid voor dezelfde dagelijkse uitvoering over, zodat geen lid meer dan één bericht per dagelijkse uitvoering ontvangt.
Hoe het in de praktijk werkt:
- Regels draaien in volgorde van prioriteit, positie 0 eerst. U stelt de volgorde in door regels omhoog of omlaag te verplaatsen in het tabblad Configuration.
- Wanneer een regel een lid contacteert, is dat lid voor de rest van de dagelijkse uitvoering geclaimd. Regels met een lagere prioriteit loggen het lid als "Skipped (dedup)".
- De dedup geldt binnen één dagelijkse uitvoering van één studio. De volgende dag kan het lid opnieuw matchen (afhankelijk van cooldowns en frequentielimieten).
- Handmatige uitvoeringen ("Run now") dedupen niet tegen de andere regels van de dagelijkse uitvoering; een handmatige uitvoering staat op zichzelf.
Zet uw belangrijkste regels bovenaan. Als retentie uw prioriteit is, houd Churn Risk dan op positie 0 zodat risicoleden altijd de retentieboodschap krijgen in plaats van een algemene.
Koppeling met MagicAI Chat
Wanneer een kanaal bezorgt via de AI-agent, landt de outreach als een chatgesprek in plaats van een eenrichtingsbericht. Het lid kan antwoorden en de MagicAI Chat-agent zet het gesprek voort. Dit maakt van een retentieduwtje een dialoog: het lid kan vragen naar lesroosters, een sessie boeken of een zorg direct in het gesprek aankaarten.
- Voorwaarde: een actieve MagicAI Chat-configuratie voor de organisatie.
- Hoe u het inschakelt: configureer een AI-agent op het WhatsApp-kanaal van een triggerregel. Er is geen apart MagicAI Chat-tabblad in Engage; de koppeling is simpelweg het agent-bezorgpad van een kanaal.
- Zonder chatconfiguratie: het bericht gaat uit als een gewone eenrichtingsverzending. Leden kunnen niet in een gesprek terugantwoorden.
Zie ook: MagicAI Chat instellen. Zie ook: WhatsApp instellen voor Engage.