Zodra uw triggerregels zijn ingesteld, vindt alles rond het uitvoeren ervan plaats op het tabblad Delivery. Dit artikel behandelt de dagelijkse planning, handmatige uitvoeringen en tests op één lid, de beveiligingen voor rusturen en frequentielimieten, hoe Preview werkt, en de volledige referentie van het uitvoeringslogboek inclusief kolommen, statuswaarden en backend-skipredenen.
Inhoud
- Plannen en uitvoeren
- Rusturen en frequentielimieten
- De volledige geschiktheidsketen
- Preview
- Referentie van het uitvoeringslogboek
- Kolommen
- Statuswaarden
- Backend-skipredenen
Plannen en uitvoeren
Alles rond het uitvoeren van triggers vindt plaats op het tabblad Delivery: de dagelijkse planning, rusturen, frequentielimieten en het paneel Execute Triggers. Sommige elementen binnen het tabblad behouden de bewoording Execution (bijvoorbeeld Execution Results, Execution Run en Executed At).
Het tabblad Delivery: dagelijkse planning, rusturen, frequentielimieten en handmatige uitvoeringen op één plek.
Dagelijkse planning
- Stel een tijdstip en tijdzone in op de configuratie en zet de planning aan of uit.
- De planning wordt gedeeld door alle studio's die de configuratie gebruiken.
- De scheduler controleert elke minuut op configuraties die aan de beurt zijn en voert alle actieve regels uit voor alle gekoppelde studio's.
- Een regel draait niet twee keer op dezelfde kalenderdag (in de lokale tijdzone van de studio). Als een regel vandaag al heeft gedraaid, of dat nu automatisch of handmatig was, wordt deze niet opnieuw uitgevoerd.
Handmatige uitvoering ("Run now")
- Voert de regel onmiddellijk uit voor de huidige studio. Dit verstuurt echte berichten. Er is geen ongedaan maken voor een verzonden bericht.
- Een handmatige uitvoering staat op zichzelf: deze dedupt niet tegen andere regels van de dagelijkse uitvoering.
- Als de regel vandaag al heeft gedraaid (automatisch of handmatig), wordt de handmatige uitvoering geblokkeerd om dubbele berichten te voorkomen.
Testen met één lid
- Voert de regel uit tegen één specifiek lid dat u kiest.
- U kiest het lid op basis van de customer ID, niet het ledennummer. Kopieer deze van het ledenprofiel: open het profiel en neem het nummer in de pagina-URL, bijvoorbeeld
.../#/customermanagement/1562839240/overviewbetekent customer ID 1562839240. - Omzeilt het matchen van voorwaarden: het lid wordt verwerkt ongeacht of het aan de voorwaarden voldoet.
- Verzendt altijd als Groep A, zonder het lid vast te zetten in een control-bucket, zodat de test nooit stilzwijgend in de controlegroep belandt.
- Gebruik dit om de kanaalopzet en sjablonen end-to-end te verifiëren voordat u een regel activeert.
Rusturen en frequentielimieten
Twee van de berichtbeveiligingen zijn globale instellingen, geconfigureerd op het tabblad Delivery en gedeeld door alle studio's die aan de configuratie zijn gekoppeld. (De andere twee beveiligingen, de cooldown per regel en de dedup bij meerdere matches, worden behandeld in Triggerregels aanmaken en bewerken.)
Rusturen. Stel een begin- en eindtijd in de tijdzone van de studio in. Bereiken die over nacht lopen werken (22:00 tot 07:00 loopt over middernacht heen). Rusturen zijn uitgeschakeld als slechts een van de twee tijden is ingesteld, of als begin en einde identiek zijn.
Wat er gebeurt tijdens rusturen. Berichten die aan de beurt komen terwijl het venster open is, worden niet weggegooid: ze worden in de wachtrij geplaatst en verzonden zodra het rusturenvenster openstaat voor verzending (dat wil zeggen zodra het venster eindigt). De trigger-editor waarschuwt u wanneer een geconfigureerd uitvoeringstijdstip binnen een actief rusturenvenster valt, en het paneel voor de dagelijkse planning toont dezelfde waarschuwing voor de dagelijkse uitvoering. Gebeurtenisgestuurde leadtriggers (de New-Lead welcome) zijn niet onderhevig aan rusturen en worden onmiddellijk verzonden.
Volgorde van beveiligingen. Voor elke uitvoering worden de beveiligingen in een vaste volgorde geëvalueerd: rusturen, vervolgens de dagelijkse limiet, vervolgens de wekelijkse limiet, en vervolgens de cooldown per regel.
Dagelijkse en wekelijkse frequentielimieten. Voortschrijdende limieten per lid: een maximaal aantal Engage-berichten per dag (voortschrijdend venster van 24 uur) en per week (voortschrijdend venster van 7 dagen). Elke limiet heeft een eigen aan/uit-schakelaar op het tabblad Delivery. Als een lid een limiet al heeft bereikt, worden verdere berichten overgeslagen.
De limieten zijn globaal per lid over alle Engage-triggers, niet per trigger geteld, dus een lid dat eerder in het venster al een bericht van een andere regel ontving, kan voor deze regel worden weggefilterd door de limiet. Eén uitvoering telt als één bericht, ook als het over meerdere kanalen uitgaat. De vensters zijn voortschrijdend (de laatste 24 uur en de laatste 7 dagen), geen kalenderdagen of -weken.
Zie ook: Triggerregels aanmaken en bewerken (Berichtbeveiligingen, Prioriteit en oplossing bij meerdere matches).
De volledige geschiktheidsketen
Een lid kan aan elke voorwaarde voldoen die u hebt geschreven en toch niets ontvangen, omdat voorwaarden slechts één stap zijn. Voor elke uitvoering past Engage deze keten in volgorde toe:
- Doelgroep — actief lid, voormalig lid of lead.
- Communicatiestop — leden die zich hebben afgemeld (geen Nieuwsbrief-toestemming) worden verwijderd.
- Contracttype — het insluit/uitsluit-filter op contracttype van de regel.
- Uw voorwaarden — de voorwaardevelden op de regel.
- Bereikbaarheid op het geselecteerde kanaal — WhatsApp en SMS hebben een telefoonnummer nodig, Email heeft een e-mailadres nodig.
Ontbrekende contactgegevens op het geselecteerde kanaal is de meest voorkomende reden waarom een matchend lid niets krijgt. Eén kanttekening bij de voorwaardestap: een voorwaarde matcht alleen leden die daadwerkelijk een waarde voor dat veld hebben. Een lid zonder waarde wordt door elke operator uitgesloten, inclusief negaties, dus een lid zonder betaalmethode matcht niet met "payment method is not Direct Debit". Om leden zonder waarde te bereiken, gebruikt u een expliciete "is empty"-voorwaarde waar het veld die aanbiedt.
Preview
Preview controleert het bereik van een regel voordat er iets wordt verzonden.
- Preview evalueert het huidige concept van de regel zoals u het in de editor hebt, niet de laatst opgeslagen versie.
- Het geeft het totale aantal matchende leden terug en een voorbeeldlijst met naam, churn risk-band en belangrijkste bezoekmetrieken.
- Preview is een realtime-momentopname: het toont alleen wie op dit moment aan de voorwaarden voldoet, op basis van de datasnapshot van de huidige dag (ledenmetrieken verversen eenmaal per dag).
- U kunt de volledige gepagineerde lijst met matchende leden laden, wat helpt in grote studio's.
Een telling van 0 is geen probleem. Als Preview 0 leden toont, betekent dat alleen dat er vandaag niemand matcht. Het betekent niet dat de regel defect is of dat er morgen niemand zal matchen: leden komen in en uit de voorwaarden naarmate hun data verandert, bijvoorbeeld wanneer een drempel voor contractafloop 's nachts wordt overschreden of een lid de dormancy-drempel overschrijdt.
Gebruik Preview om drempels af te stemmen voordat u activeert. Als een Dormancy-regel de helft van de studio matcht, is de drempel waarschijnlijk te strak voor een nuttige campagne; verhoog de waarde voor dagen sinds het laatste bezoek en bekijk het voorbeeld opnieuw.
Preview toont wie aan de voorwaarden voldoet. Het simuleert de beveiligingen niet, dus het werkelijke aantal berichten dat in een uitvoering wordt verzonden, kan lager liggen zodra cooldowns, frequentielimieten, rusturen, dedup en de A/B-controlegroep worden toegepast. Behandel het voorbeeld als "wie is geschikt", niet "wie wordt aangeschreven".
Referentie van het uitvoeringslogboek
Elk beoordeeld lid krijgt een regel, zodat u altijd kunt reconstrueren waarom iemand wel of niet is gecontacteerd. Het tabblad Delivery toont overzichtskaarten (Totaal gematcht, Groep A, Groep B) en een resultatentabel per lid. Resultaten kunnen worden gefilterd op datumbereik, uitvoering, trigger, kanaal en A/B-groep, en geëxporteerd naar CSV.
Delivery-resultaten: één regel per beoordeeld lid, met Path (One-way of Agent), kanaal, A/B-groep en uitkomst.
Kolommen
| Kolom | Wat het toont |
|---|---|
| Member | Ledennaam, als momentopname vastgelegd op het moment van verzending. Historische logs blijven leesbaar, ook als de data van het lid later verandert. |
| Trigger | De triggerregel die dit lid heeft geëvalueerd. |
| Path | Bezorgpad: One-way (rechtstreeks verzonden), of Agent (bezorgd via de MagicAI Chat-agent). Leeg voor overgeslagen leden. |
| Channel | Het kanaal waarop het bericht is verzonden (of geprobeerd). Leeg voor leden die vóór kanaalselectie zijn overgeslagen, zoals de controlegroep. |
| Group | A (treatment, aangeschreven) of B (control, niet aangeschreven). |
| Churn risk | De churn risk-band van het lid op het moment van uitvoering (Very Low tot Very High). Nuttig om te beoordelen wie er is getarget. |
| Status | De uitkomst van deze verzendpoging. Zie de statusreferentie hieronder. |
| Datum/tijd | Wanneer dit logboekitem is aangemaakt. |
Statuswaarden
Elke verzendpoging eindigt in precies een van de onderstaande uitkomsten, weergegeven in de kolom Status. De kolom Path ernaast toont Agent (bezorgd via de MagicAI Chat-agent) of Enkele reis (rechtstreeks verzonden), en is leeg voor overgeslagen en control-rijen.
| Status | Wat er gebeurde |
|---|---|
| Sent | Het bericht is overgedragen en door de backend bevestigd als verzonden. De daadwerkelijke bezorgbevestiging hangt af van de downstreamprovider (bijvoorbeeld WhatsApp of de SMS-gateway). |
| Failed | De verzending is mislukt door een runtimefout. |
| Control (no message) | Het lid zit in controlegroep B en is bewust niet gecontacteerd, zodat de treatmentgroep in Impact Analysis tegen een zuivere basislijn kan worden vergeleken. Er wordt één regel per lid vastgelegd, zonder kanaal. |
| Skipped (quiet hours) | De studio bevindt zich binnen het geconfigureerde rusturenvenster. Het bericht wordt niet weggegooid: het wordt in de wachtrij geplaatst en verzonden zodra het venster opent. |
| Skipped (cooldown) | Het cooldownvenster van de regel is voor dit lid nog niet verstreken. |
| Skipped (already contacted) | Een eenmalig-contacttrigger heeft dit lid in een eerdere uitvoering al een bericht gestuurd. |
| Skipped (daily frequency cap) | De voortschrijdende berichtlimiet van 24 uur van de studio is bereikt. |
| Skipped (weekly frequency cap) | De voortschrijdende berichtlimiet van 7 dagen van de studio is bereikt. |
| Skipped (higher-priority trigger) | Een regel met een hogere prioriteit heeft dit lid al geclaimd in dezelfde scheduler-doorloop (zie Prioriteit en oplossing bij meerdere matches in Triggerregels aanmaken en bewerken). |
| Skipped (no channel) | Het lid is onbereikbaar op het kanaal (geen telefoonnummer voor WhatsApp of SMS, geen e-mailadres voor Email). |
| Skipped (not allowlisted) | Het lid staat niet op de geconfigureerde verzend-allowlist. |
| Skipped (backend) | De backend heeft het bericht bewust achtergehouden. Het reden-veld toont de specifieke oorzaak (zie Backend-skipredenen hieronder). |
Dit zijn de bezorglogboekstatussen die door engineering zijn bevestigd (de message-status-set van de ml-backend). Elk beoordeeld lid produceert één regel per uitvoering met zijn uitkomst. De status "Skipped (backend)" draagt een reden-veld op het tweede niveau dat de precieze oorzaak benoemt (zie Backend-skipredenen hieronder). Rijkere bezorgrapporten per verzending (een status Succeeded, Failed of Pending per bericht met de foutreden) zijn gepland voor een latere release, niet voor go-live. De exacte bewoording op het scherm voor de minder voorkomende statussen is geverifieerd tegen de GA-UI.
Backend-skipredenen
Wanneer de status "Skipped (backend)" is, legt het reden-veld uit waarom het bezorgsysteem het bericht heeft achtergehouden:
| Reden | Wat te controleren |
|---|---|
| Engage disabled | De Engage-functie is uitgeschakeld op platformniveau. |
| No channel handler | Er is geen bezorg-handler geregistreerd voor dit kanaal. Neem contact op met support. |
| Channel disabled | Het kanaal is uitgeschakeld voor deze studio. |
| Studio mismatch | De studiocontext kwam niet overeen. Neem contact op met support. |
| Template not found | Het aan dit kanaal toegewezen sjabloon bestaat niet meer. Wijs een sjabloon opnieuw toe. |
| Template archived | Het sjabloon is gearchiveerd nadat de regel was geconfigureerd. Wijs een actief sjabloon opnieuw toe. |
| Template wrong channel | Het sjabloon is voor een ander kanaal aangemaakt. Wijs een passend sjabloon toe. |
| App not activated | Push-kanaal: de MySports App is niet geactiveerd voor deze studio. |
| No default locale | Er is geen standaardlocale ingesteld voor het lid. |
| No phone number | SMS-kanaal: het lid heeft geen telefoonnummer geregistreerd. |
| No chatbot configuration | Chat-bezorgpad: er bestaat geen MagicAI Chat-configuratie. Stel er een in of verwijder de agent van het kanaal. |
| MySports unavailable | Push-kanaal: MySports was niet beschikbaar op het moment van verzending. |
| No WhatsApp Business Account | WhatsApp-kanaal: er is geen Meta WhatsApp Business Account aan deze studio gekoppeld. Zie ook: WhatsApp instellen voor Engage. |
| WhatsApp Business Account mismatch | Het goedgekeurde Business Account van het sjabloon verschilt van het gekoppelde account van de studio. WhatsApp-sjablonen worden per account goedgekeurd; een mismatch betekent dat Meta de verzending zou weigeren. Gebruik een sjabloon dat is goedgekeurd voor het gekoppelde account van de studio. |
Zie ook: WhatsApp instellen voor Engage. Zie ook: Impact Analysis.