Mautic voor developers: Drupal-content verbinden met Mautic e-mailmarketing

Blog
Gepost op
Mautic voor devs

Het combineren van Drupal (CMS) en Mautic (Marketing Automation Software) is een uitstekende keuze voor het beheren van je omnichannel digitale ervaringen. Veel organisaties beheren hun content al in Drupal. Maar het handmatig dupliceren ervan in Mautic - bijvoorbeeld voor een nieuwsbrief - kost te veel tijd en moeite. Dat is nu verleden tijd. We hebben een plugin ontwikkeld waarmee je automatisch gepersonaliseerde Mautic-e-mails kunt verzenden met content direct vanuit je Drupal CMS. De voordelen zijn duidelijk: tijd besparen, handmatige fouten voorkomen en een consistente ervaring voor je eindgebruikers garanderen.

In deze blog leg ik uit welke plugin we hebben gebouwd en hoe je deze kunt gebruiken in jouw organisatie.

  1. Consistente contentervaringen over je websites en e-mails
  2. De functionele plugin voor marketeers
  3. Een praktijkvoorbeeld: Inagro
  4. De technische plugin voor ontwikkelaars

1. Consistente contentervaring op website en e-mail

Een belangrijk aspect van je algehele communicatie is consistente contentpersonalisatie op je website en in je e-mails. Waarom? Om je gebruikers een consistente ervaring te bieden, ongeacht het touchpoint dat ze gebruiken. Tegelijkertijd wil je dat je marketingteam deze content zo efficiënt mogelijk beheert om het volgende te vermijden:

  • Gedupliceerde content (één keer in je CMS, één keer in Mautic)
  • Het risico op fouten, typefouten en onjuiste links
  • Handmatige ingrepen om terugkerende e-mails te versturen
  • Het herhalen van taken zoveel mogelijk in plaats van automatisering te gebruiken

Een ander voordeel is het gebruiksgemak voor je content editors. Zij hoeven alleen maar te weten hoe ze één systeem moeten gebruiken: het CMS, omdat de content automatisch naar Mautic wordt gedupliceerd. Daarnaast maak je gebruik van de geavanceerde functies in Drupal die niet beschikbaar zijn in Mautic. Bijvoorbeeld de mediatheek, waarmee je dezelfde middelen kunt hergebruiken voor zowel je website als je e-mailmarketing, moderatietools, geavanceerde gebruikersrechten, ...

2. De functionele plugin voor marketeers

Om ervoor te zorgen dat je een consistente contentervaring kunt bieden over al je digitale kanalen, hebben we de External Content Plugin ontwikkeld.

Wat doet de plugin?

Het stelt marketeers in staat om geautomatiseerde gepersonaliseerde nieuwsupdates te verzenden met Mautic. De inhoud van de e-mails komt rechtstreeks uit het Drupal CMS. Dit kan zonder terugkerende betrokkenheid van ontwikkelaars en handmatige acties in Mautic.

Hoe werkt de plugin?

  1. Creëer content in Drupal: nieuws, blogs en andere contenttypes.
  2. Label deze contenttypes met interessecategorieën.
  3. Gebruik dezelfde interessecategorieën in je nieuwsbriefabonnementproces.
  4. Koppel je Drupal aan je Mautic via een API en de Mautic-plugin.
  5. Voeg e-mailtokens toe in je e-mails om de juiste gepersonaliseerde content rechtstreeks uit je Drupal op te nemen en automatiseer het verzenden van e-mails.


Een wat diepgaandere uitleg:

Op je Drupal-website heb je doorgaans nieuwsartikelen, blogs, producten, evenementen en soortgelijke contenttypes die gekoppeld zijn aan bepaalde tags of interesses. Wanneer bezoekers zich abonneren op je nieuwsbrieven (via een Mautic-formulier), kun je hen vragen naar hun interesses om relevante en gepersonaliseerde updates te sturen. Deze categorieën op je aanmeldingsformulier zijn dezelfde als de tagging van de content in je Drupal. Je Drupal-site wordt uitgebreid met een API om de nieuwste content naar de External Content Plugin te sturen. De zakelijke logica bevindt zich in deze API. Deze bepaalt welke content naar Mautic wordt gestuurd en voor welk publiek. De External Content Plugin moet in Mautic worden ingeschakeld en verbonden met de Drupal API. Deze plugin koppelt de content die van de Drupal API wordt ontvangen aan de e-mailtokens.

Je voegt dynamische content toe aan de e-mail met tokens. Marketeers kunnen een of meerdere versies van de token toevoegen aan de e-mailinhoud op elke gewenste positie waar ze dynamische content willen toevoegen. Ze kunnen de token dynamisch creëren. Dit betekent dat ze nieuwe gepersonaliseerde content per e-mailcampagne kunnen aanpassen of creëren zonder dat een ontwikkelaar nodig is.

Last but not least, je kunt het verzenden van e-mails naar wens automatiseren met Mautic. Je kunt ze dagelijks, wekelijks of maandelijks versturen. Of gebruik een Mautic Preference Center om nieuwsupdates te sturen op het interval van keuze van elke ontvanger. Et voilà, je bent klaar om te gaan. Je bezoekers ontvangen automatisch gepersonaliseerde nieuwsupdates zonder dat er handmatige ingrepen nodig zijn na de eerste installatie.

Inagro - mobile newsletter

3. Een praktijkvoorbeeld: Inagro

De External Content Plugin is niet zomaar een abstract concept. We hebben deze al gebruikt voor onze klanten. Voor Inagro hebben we bijvoorbeeld een volledig autonoom, gepersonaliseerd e-mailsysteem gebouwd met Drupal en Mautic. Inagro voegt kalenderevenementen en globale en gepersonaliseerde nieuwsitems toe aan hun wekelijkse nieuwsupdates. Hun content editors verliezen geen tijd met het opzetten van alle unieke e-mails. Dankzij volledige automatisering ontvangt elke gebruiker een hyper-gepersonaliseerde wekelijkse nieuwsbrief die relevant is voor hun profiel.

4. De technische plugin voor developers

De functies van de plugin

Configuratieformulier

waar je API-instellingen en inloggegevens kunt configureren

Logica om een configureerbare token om te zetten

naar daadwerkelijke gegevens op basis van de voorkeuren van een contactpersoon

Configureerbare tokens

die in e-mailsjablonen kunnen worden gebruikt

Logica om die gegevens op te halen

van een extern eindpunt en deze in de gepersonaliseerde e-mail in te voegen

Meerdere tokenversies

Je kunt meerdere versies van de token in één e-mail gebruiken.

Caching van gerenderde HTML

aan de kant van Mautic waar mogelijk

De 3 componenten van de plugin

1. Configuratieformulier 

Configuratieformulier waar je API-instellingen en inloggegevens kunt configureren. Deze worden gebruikt wanneer we de API aanroepen. Je kunt de volgende zaken configureren:

  • Endpoint: de URL van het API-eindpunt.
  • Authenticatie: geen (Basic Authentication, Bearer Token of elke geavanceerde autorisatieheader).
  • Methode: GET of POST. Mogelijkheid om zeer geavanceerde resultaten aan te vragen door POST-verzoeken te kunnen versturen, in plaats van alleen GET-verzoeken met een beperkte lengte van querystring-parameters.
  • Als je een testomgeving hebt voor de website en/of Mautic, kan de URL van de API dynamisch of per omgeving worden gewijzigd.
2. ExternalContentEmailSubscriber

Dit is een Event Subscriber die wordt geactiveerd wanneer een e-mail wordt verzonden:

  • Wanneer een e-mail wordt verzonden, wordt de inhoud van de e-mail gescand op het gebruik van onze custom token {external_content:[key=value]}.
  • Als de token wordt gevonden, wordt onze custom build “TokenReplacer”-service aangeroepen.
3. TokenReplacer

Dit zal de gebruikte token in de e-mail (ingesteld door de marketeer) vertalen naar een verzoek dat door de API kan worden begrepen. De reactie van de API wordt geretourneerd om in de e-mail te worden weergegeven.

  • De gebruikte e-mailtoken wordt opgesplitst voor elk sleutel-waarde-paar.
  • Elk paar wordt gecontroleerd op gereserveerde sleutels. Dit zijn specifieke instellingen die worden gebruikt om het verzoek aan de server te manipuleren, inclusief het eindpunt, de methode (GET / POST).
  • De resterende paren worden omgezet in filters die naar het API-eindpunt worden gestuurd. Deze kunnen hardcoded zijn of opgehaald worden uit contactvelden in Mautic. Zo kan elke e-mail worden gevuld met sterk gepersonaliseerde content, afhankelijk van de waarden die zijn opgeslagen in het contactprofiel in Mautic.
  • Het hele verzoek wordt naar de API verzonden. Wanneer we een antwoord ontvangen, slaan we het op in de cache. De geretourneerde HTML-uitvoer wordt in de e-mail gerenderd voordat deze naar de contactpersoon wordt verzonden.
     

Buiten het bereik van deze plugin

  • De synchronisatie van de voorkeuren van een contactpersoon vanuit een externe bron naar Mautic.
  • Elke filtering of verwerking van externe gegevens. Dit betekent dat de externe bron volledig verantwoordelijk is voor de verwerking van het inkomende verzoek van deze plugin.
     

Het verschil tussen deze plugin en Mautic's ingebouwde Dynamic Web Content (DWC)

  • Dynamic Web Content (DWC) stelt je in staat om gepersonaliseerde content in te voegen in een externe webpagina.
  • Deze plugin stuurt een gepersonaliseerd verzoek naar een extern eindpunt. Het gepersonaliseerde antwoord wordt vervolgens gerenderd in de e-mail die naar de contactpersoon wordt verzonden.

Heb je dezelfde behoefte? Voel je vrij om onze plugin te gebruiken, hij is open!

Meer informatie, een demo, of hulp bij het maken van een aangepaste plugin om aan je behoeften te voldoen?