Gebruik de OneSignal-koppeling met MailBlue om pushmeldingen naar web, mobiele apparaten en apps te sturen. Je kunt ook OneSignal-events naar MailBlue synchroniseren zodra er een event plaatsvindt.
Waar moet ik rekening mee houden?
Dit heb je nodig om de koppeling in te stellen:
MailBlue-account met rechten voor automatiseringen
OneSignal-account ingesteld en geconfigureerd om pushmeldingen te versturen
Web-app in OneSignal ingesteld en geconfigureerd
Pushmelding-templates (als je die gebruikt) in OneSignal. Ondersteunde platformen:
Apple iOS (APNs)
Google Android (FCM)
Web
OneSignal User Auth Key
OneSignal REST API-key voor elke web-app
Per Subscription-record is het OneSignal-veld 'Externe ID' gevuld met de unieke identificatie voor MailBlue (e-mailadres)
E-mailadressen die je via een MailBlue-formulier vastlegt, vullen automatisch het OneSignal-veld 'Externe ID'
Je web- of mobiele app-ontwikkelaar kan een manier inrichten om het e-mailadres van een MailBlue-contact naar het OneSignal-veld 'Externe ID' te sturen
OneSignal stuurt het e-mailadres dat is vastgelegd via de e-mail- of telefoonprompt in de 'Permission Prompt Setup' niet door
Voor web pushmeldingen ondersteunt OneSignal geen nieuwe apps meer voor Blogger, Squarespace, Webflow, Weebly, Wix, HTTP-sites en websitebouwers die geen service workers naar een server kunnen uploaden (dit is vereist voor web push).
Ben je Wix Studio klant? Upload dan het service worker-bestand van OneSignal naar je root-directory.
Hoe werkt de koppeling?
De koppeling heeft twee losse synchronisatie-opties. Met de ene optie synchroniseer je data naar je MailBlue-account. Met de andere optie verstuur je pushmeldingen via een automatisering. Je kunt een of beide opties gebruiken, maar ze werken los van elkaar.
OneSignal Event Streams synchroniseren naar MailBlue
Na het instellen worden Event Streams naar MailBlue gesynchroniseerd zodra er een event plaatsvindt. Dit gebeurt via een webhook.
Pushmeldingen versturen
Om pushmeldingen te versturen configureer je de koppeling via een of twee automatiseringsacties. Je kunt een van de acties gebruiken, of allebei:
'OneSignal - Tag toewijzen'-actie - hiermee kun je mobiele in-app pushmeldingen versturen
'OneSignal - Pushmelding versturen'-actie - hiermee kun je web- en mobiele pushmeldingen versturen
Rapportage
Je vindt rapportage over deze koppeling in je OneSignal-account. In MailBlue kun je ook een 'Geavanceerde zoekopdracht' maken van alle contacten die je OneSignal-automatisering zijn binnengekomen.
Hoe synchroniseer ik OneSignal event streams naar MailBlue?
Met deze synchronisatie worden events vanuit OneSignal naar MailBlue gestuurd zodra er een event plaatsvindt.
Wat kun je verwachten?
Je stelt de koppeling in binnen zowel je MailBlue- als OneSignal-account. Je voegt JSON-code toe in OneSignal. Daarna maakt de koppeling nieuwe contactrecords aan of werkt bestaande contactrecords bij in MailBlue en synchroniseert het de juiste eventdata.
Ons supportteam kan je niet helpen met het implementeren van code of het oplossen van problemen in code.
Ondersteunde events
De volgende events worden ondersteund:
In-app impressie
In-app geklikt
In-app pagina weergegeven
Push verzonden
Push ontvangen
Push geklikt
Push mislukt
Push uitgeschreven
OneSignal-data op contactrecords
Voor elk contact wordt een record in een aangepast object aangemaakt. Dit record bevat onder andere:
Externe ID
Tijdstempel
Event-ID
Eventtype
Bericht-ID
Berichtnaam
Berichttitel
Berichtinhoud
Abonnementstype apparaat
Stappenplan
MailBlue-configuratie:
Klik in je MailBlue-account op je profiel > 'Apps'.
Gebruik de zoekbalk om de OneSignal-koppeling te vinden.
Klik op de knop 'Account toevoegen'.
Er verschijnt een pop-up. Vul de User Auth Key in uit je OneSignal-account en klik op de knop 'Verbinden'.
Als je de OneSignal-koppeling al via een automatiseringsactie hebt ingesteld, kun je op dit scherm je bestaande verbinding selecteren.
Koppel de binnenkomende OneSignal-velden aan de gewenste velden in MailBlue en klik op 'Voltooien'.
Let op: Koppel het OneSignal-veld 'Externe ID' aan het MailBlue-veld 'E-mailadres contact'. Als je dit niet doet, mislukt de synchronisatie.
Klik op het pijltje naast de knop 'Bewerken' voor de resource die je hebt gemaakt en klik op 'Webhook-URL kopiëren'. Bewaar deze URL; je hebt hem nodig voor de OneSignal-configuratie.
OneSignal-configuratie:
Log in op je OneSignal-account, selecteer 'Alle apps' en kies de app die je wilt koppelen.
Klik in het menu 'Data' op 'Event Streams'.
Klik op 'Nieuwe event stream'.
Geef de event stream een naam en klik op 'Events selecteren'. Selecteer in het pop-upvenster alle events in de onderdelen 'In-appbericht' en 'Pushmelding' en klik op 'Klaar'.
Plak de webhook-URL die je in de laatste stap van de MailBlue-configuratie hebt gekopieerd in het veld 'URL'.
Voeg onder 'Headers' een regel toe met key 'Content-Type' en value 'application/json'.
Kies onder 'Body' in de dropdown 'Aangepaste body'. Vervang de inhoud door de volgende JSON:
{
"event.kind": "##{{ event.kind }}",
"event.id": "##{{ event.id }}",
"event.timestamp": "##{{ event.timestamp }}",
"event.datetime": "##{{ event.datetime }}",
"event.app_id": "##{{ event.app_id }}",
"event.subscription_device_type": "##{{ event.subscription_device_type }}",
"event.subscription_id": "##{{ event.subscription_id }}",
"event.onesignal_id": "##{{ event.onesignal_id }}",
"event.external_id": "##{{ event.external_id }}",
"message.id": "##{{ message.id }}",
"message.name": "##{{ message.name }}",
"message.title": "##{{ message.title.en }}",
"message.contents": "##{{ message.contents.en }}",
"template_id": "##{{ message.template_id }}",
"message.template_id": "##{{ message.template_id }}",
"message.url": "##{{ message.url }}",
"message.app_url": "##{{ message.app_url }}",
"message.web_url": "##{{ message.web_url }}"
}Let op: Kopieer de JSON-code hierboven exact zoals die er staat. Anders werkt de koppeling niet goed.
Klik op 'Activeren' om de event stream op te slaan en in te schakelen.
Hoe koppel ik OneSignal aan MailBlue met de 'OneSignal - Tag toewijzen'-actie?
Met deze automatiseringsactie kun je segmenten in OneSignal maken. Zodra het segment is ingesteld, kun je in-appmeldingen voor je mobiele app direct vanuit OneSignal versturen. MailBlue kan geen in-app pushmeldingen rechtstreeks vanuit automatiseringen versturen.
Wat kun je verwachten?
Deze setup bestaat uit drie hoofdonderdelen:
Maak een segment in OneSignal met het filter 'UserTags' voor het key/value-paar dat je gebruikt bij het instellen van de automatiseringsactie.
Stel in OneSignal de in-appmelding in voor mobiele apps.
Voeg de actie 'OneSignal - Tag toewijzen' toe aan je automatisering. Daarbij vul je je OneSignal API-key in en maak je een key/value-paar aan. Dit key/value-paar moet overeenkomen met het segment dat je in OneSignal hebt gemaakt. Zet je automatisering daarna op 'Actief'.
Wanneer een contact je automatisering doorloopt, wordt het key/value-paar als tag naar OneSignal gestuurd. Elke tag die je via deze actie naar OneSignal stuurt, wordt in OneSignal aangemaakt als die nog niet bestaat, en bijgewerkt als die al bestaat.
Je vindt de key/value-tags in OneSignal via 'Audience' > 'Users'.
Stappenplan
Maak een segment in OneSignal:
Log in op je OneSignal-account.
Ga naar 'Audience' > 'Segment' > 'Nieuw segment'.
Maak je segment door het filter 'User Tags' toe te voegen voor het key/value-paar dat je in je automatisering gaat gebruiken.
Maak het bericht dat je naar je segment wilt sturen.
Verzamel de OneSignal API-key op app-niveau en bewaar deze voor later. Je vindt deze onder 'ActiveCampaign App' > 'Keys & IDs'.
Maak in MailBlue een automatisering aan of bewerk een bestaande automatisering.
Sleep de actie 'OneSignal - Tag toewijzen' naar je automatisering. Je vindt deze onder het onderdeel 'Apps' in het actiemenu. Vul daarna de velden in:
OneSignal API-key
Datatag-sleutel
Datatag-waarde
Tip: gebruik een consistente key/value-opbouw voor tags, zodat je segmenten in OneSignal makkelijk beheert.
Rond je automatisering af en zet deze op 'Actief'.
Hoe koppel ik OneSignal aan MailBlue met de 'OneSignal - Pushmelding versturen'-actie?
Met deze automatiseringsactie kun je pushmeldingen naar web en mobiele apparaten versturen.
Wat kun je verwachten?
Als je de actie 'OneSignal - Pushmelding versturen' toevoegt aan je automatisering, doorloop je in de actie de OneSignal-authenticatie- en configuratiestappen. Je kunt een OneSignal-template gebruiken voor je pushmelding of je bericht handmatig maken in de configuratie.
Zodra je de koppeling hebt gemaakt en je automatisering op 'Actief' zet, ontvangen contacten die deze actie bereiken een pushmelding op web of mobiel. In de activiteitsstream op het contactrecord zie je ook dat het contact je automatisering is binnengekomen en heeft afgerond.
Je vindt rapportage in je OneSignal-account. In MailBlue kun je ook een 'Geavanceerde zoekopdracht' maken van alle contacten die je OneSignal-automatisering zijn binnengekomen.
Deze koppeling voegt geen tags toe aan contacten. Wil je tags toevoegen aan contacten die een pushmelding hebben ontvangen? Voeg dan na de OneSignal-actie de actie 'Tag toevoegen' toe aan je automatisering.
Stappenplan
Zorg dat je in OneSignal het volgende hebt ingesteld: een OneSignal-account dat pushmeldingen kan versturen, de ActiveCampaign App en (aanbevolen) templates.
Verzamel in OneSignal de volgende gegevens en bewaar ze voor later:
User Auth Key - dit is de key op accountniveau en staat onder 'Account & API Keys'.
OneSignal - dit is de API-key op app-niveau en staat onder 'ActiveCampaign App' > 'Keys & IDs' voor de ActiveCampaign App.
Maak in MailBlue een automatisering aan of bewerk een bestaande automatisering.
Sleep de OneSignal-actie naar je automatisering. Je vindt deze onder het onderdeel 'CX Apps' in het actiemenu.
Rond in de OneSignal-actie de volgende stappen af om de koppeling te maken:
Plak je OneSignal User Auth Key in het veld en klik op 'Verbinden'.
Kies de web-app die je wilt gebruiken in de dropdown.
Plak de API-key van je web-app.
Kies de pushmelding-template die je wilt gebruiken (aanbevolen). Wil je geen template gebruiken, maak je pushmelding dan handmatig in de actie.
Voor handmatige opbouw vul je je URL, kopregel (onderwerpregel) en content in.
Je kunt personalisatietags gebruiken voor Contact, Account, Deal, Ecommerce en aangepaste objecten.
De personalisatietags van MailBlue werken niet met templates van OneSignal.
Klik op de knop 'Voltooien'.
Hoe leg ik e-mailadressen vast voor OneSignal met MailBlue-formulieren?
Let op: Dit is een optie voor gevorderde gebruikers. Je moet je prettig voelen met code. Ons supportteam kan je niet helpen met implementatie of troubleshooting van code.
Met de OneSignal Web SDK kun je eigen code toevoegen aan je MailBlue-formulieren om bij het verzenden het e-mailadres van een contact vast te leggen en het contact als abonnee toe te voegen in OneSignal.
Installeer eerst de OneSignal Web SDK op je website volgens de OneSignal-documentatie. Voeg daarna je MailBlue-formulier toe aan je site.
In MailBlue:
Klik links in het menu op 'Website' > 'Formulieren'.
Maak een nieuw formulier en kies de optie 'Inline formulier'.
Klik na het ontwerpen van je formulier rechtsboven op de knop 'Integreren'.
Zoek de code voor 'Volledige embed', selecteer deze en kopieer hem.
In de HTML van je website (waar het MailBlue-formulier zichtbaar wordt):
Plak de gekopieerde formuliercode.
Zoek in de meegeleverde javascript naar de functie 'form_submit'. De eerste regel in deze functie moet 'e.preventDefault()' zijn. Dit is belangrijk.
Plaats de OneSignal-code na de regel 'e.preventDefault()' in de functie 'form_submit'.
Voeg op een nieuwe regel onder 'e.preventDefault()' de volgende code toe:
var userEmail = document.getElementById("email").value;
OneSignalDeferred.push(async function(OneSignal) {
await OneSignal.User.addEmail(userEmail);
await OneSignal.login(userEmail);
});
Wanneer je MailBlue-formulier wordt verzonden, wordt het e-mailadres doorgestuurd naar het OneSignal-veld 'Externe ID'.
Hoe los ik problemen op?
Controleer je template-instellingen zodat pushmeldingen op verschillende apparaten zijn toegestaan.
Problemen oplossen voor web push
Problemen oplossen voor mobiele push
Veelvoorkomende redenen waarom web pushmeldingen niet op je apparaat worden weergegeven
Veelvoorkomende redenen waarom mobiele pushmeldingen niet op je apparaat worden weergegeven
Veelgestelde vragen
Vanaf welk abonnement is deze koppeling beschikbaar?
Vanaf welk abonnement is deze koppeling beschikbaar?
Deze functionaliteit is beschikbaar vanaf het Starter-abonnement.
Moet ik het OneSignal-veld 'Externe ID' koppelen aan e-mailadres?
Moet ik het OneSignal-veld 'Externe ID' koppelen aan e-mailadres?
Ja. Koppel 'Externe ID' aan het MailBlue-veld 'E-mailadres contact', anders mislukt de synchronisatie.
Kan MailBlue in-app pushmeldingen rechtstreeks vanuit automatiseringen versturen?
Kan MailBlue in-app pushmeldingen rechtstreeks vanuit automatiseringen versturen?
Nee. Gebruik de actie 'OneSignal - Tag toewijzen' om segmenten in OneSignal aan te sturen en verstuur de in-appmeldingen vanuit OneSignal.
Werken personalisatietags met OneSignal-templates?
Werken personalisatietags met OneSignal-templates?
Nee. De personalisatietags van MailBlue werken niet met templates van OneSignal.
Voegt de actie 'OneSignal - Pushmelding versturen' automatisch tags toe?
Voegt de actie 'OneSignal - Pushmelding versturen' automatisch tags toe?
Nee. Wil je tags toevoegen, plaats dan na de OneSignal-actie de actie 'Tag toevoegen' in je automatisering.