Contacten synchroniseren

Het belangrijkste voordeel van een koppeling is tijdwinst! Een marketeer is zonder een koppeling veel tijd kwijt met het handmatig importeren en exporteren van contactgegevens. Met een automatisch proces, waarbij de contacten (near-) realtime worden gesynchroniseerd naar Spotler, blijft het contactenbestand up-to-date en kan de marketeer op elk gewenst moment een nieuwsbrief versturen.

schema-contacten_Spotler.gifMapping van contactvelden

Om contacten te synchroniseren moet je eerst bepalen welke contacteigenschappen kunnen worden gesynchroniseerd. Om te achterhalen welke contactvelden beschikbaar zijn in het Spotler-account, kan je het beste gebruikmaken van de REST API-methode die deze velden ophaalt. Als resultaat krijg je niet alleen de veldnamen van het Spotler-account te zien, maar ook de formaten waarin deze dienen te worden opgeslagen. We raden aanom de mapping van velden in de koppeling toegankelijk en aanpasbaar te maken voor een gebruiker. Op die manier wordt het mogelijk om de mapping uit te breiden met extra contactvelden zonder dat er daarvoor een developer aan te pas hoeft te komen.

Hieronder een voorbeeld van hoe de mapping van velden getoond zou kunnen worden aan de gebruiker:

mappingfields

 

Verwijzing technische documentatie Technische documentatie
Ophalen van contacteigenschappen

 

Eerste en laatste aankoopdatum

Twee contactvelden verdienen speciale aandacht: firstPurchaseDate en lastPurchaseDate. Deze gegevens kunnen in Spotler eCommerce gebruikt worden voor segmentatiedoeleinden of automatische campagnes. Het gekoppelde systeem (webwinkel) moet deze gegevens bijwerken. De firstPurchaseDate moet eenmalig gezet worden op het moment dat een klant voor de allereerste keer een bestelling plaatst. De lastPurchaseDate moet elke keer bijgewerkt worden op het moment dat iemand een bestelling plaatst.

Permissies

In sommige Spotler-accounts wordt gebruikgemaakt van één of meerdere permissies. Dat wil zeggen dat een contact zich kan inschrijven of juist afmelden voor een specifieke e-mailing. Dat wordt bij contacten opgeslagen in een specifiek lijstveld dat permissions heet.

Contacten toevoegen of wijzigen

Als er een nieuw contact ontstaat in het gekoppelde systeem of er wordt een bestaand contact gewijzigd, dan kan dit direct worden doorgevoerd in Spotler. Hoe meer realtime dit gebeurt hoe fijner het is voor de marketeer.

Er zijn twee manieren om contacten in Spotler te wijzigen. Wij adviseren om de methode om contacten toe te voegen te gebruiken, waarbij update op true wordt gezet. In dat geval hoeft er in de koppeling niet onthouden te worden of het contact mogelijk al eens eerder is ingeschoten. De andere methode is specifiek voor het wijzigen van een contact.

Verwijzing technische documentatie Technische documentatie
Contact toevoegen (met eventueel update=true)
Contact wijzigen


Ontdubbeling vindt plaats in Spotler

Wanneer je via de API contacten inschiet, gelden de ontdubbelregels die in het Spotler-account staan ingesteld. Standaard betekent dit dat er wordt ontdubbeld op het externalId en het emailadres van het contact. Bij het inschieten van een contact waarvan het e-mailadres al bestaat in Spotler, worden de nieuwe gegevens samengevoegd met de gegevens van het bestaande contact in Spotler. Zo worden dubbele contacten voorkomen en ontvangen lezers geen dubbele nieuwsbrieven in hun inbox.

Ontdubbelregels MailPlus

Meertaligheid

Is het gekoppelde systeem meertalig (bijvoorbeeld bij een webwinkel)? Dan moet bij ieder contact de taal worden gesynchroniseerd naar Spotler. Een marketeer wil immers de mailings in de juiste taal versturen naar de juiste doelgroep. Als de structuur van een webwinkel wordt bepaald door de meertaligheid, dan raden we aan om de structuur in zijn geheel in het taalveld op te slaan bij het contact, met bijvoorbeeld SPATIE-SPATIE tussen de niveaus. Deze waarde is uitsluitend bedoelt voor de marketeer in Spotler, niet om getoond te worden in de nieuwsbrief.

Ophalen van gebouncede contacten

Bij het versturen van e-mailings, zal je helaas altijd te maken krijgen met e-mailadressen die bouncen. Dat betekent simpelweg dat de e-mail niet is aangekomen omdat het e-mailadres niet juist is. Soms gaat het om een typefout in het e-mailadres. Maar het kan ook zijn dat iemand van werkgever is veranderd. Bounces zijn dé manier om dit te constateren. En met de API is het mogelijk om gebouncede contacten op te halen uit Spotler en inzichtelijk te maken in het gekoppelde systeem. Het voordeel is dat het bestand in het gekoppelde systeem schoon blijft. Maar het levert ook kansen op! Niet alleen kan er op zoek worden gegaan naar de vervanger van de vertrokken contactpersoon om je klant te behouden. Het biedt ook de mogelijkheid om via andere kanalen contact te leggen met de vertrokken contactpersoon. Zijn of haar nieuwe werkgever kan immers een potentiële nieuwe klant zijn. Op deze manier worden bounces in feite nieuwe leads.

Het ophalen van gebouncede contacten dient periodiek te gebeuren. Bijvoorbeeld 1x per uur of 1x per dag. Is het gekoppelde systeem een CRM-systeem? Dan is het aan te raden om voor de opvolging van de bounce automatisch een ‘taak’ aan te maken bij de juiste accountmanager. Het oplossen van bounces wordt dan niet meer vergeten en is meetbaar geworden.

Verwijzing technische documentatie Technische documentatie
Ophalen van gebouncede contacten


Ophalen van gewijzigde contacten

Het gekoppelde systeem hoeft niet altijd leidend te zijn voor alle contactgegevens. Ontvangers van een e-mailing kunnen hun profielgegevens wijzigen op een landingspagina van MailPlus. Dit wordt dan direct bijgewerkt in Spotler. Om het gekoppelde systeem up-to-date te houden, kan je deze wijzigingen periodiek ophalen. Bijvoorbeeld 1x per uur of 1x per dag.

Soms wordt het gesynchroniseerde e-mailadres ook gebruikt als gebruikersnaam om in te loggen in het gekoppelde systeem. Dat is bijvoorbeeld bij webwinkels vaak het geval. We raden dan aan om dit veld niet op te nemen op de profielwijzigenpagina van Spotler. Contacten kunnen hun e-mailadres (gebuikersnaam) dan uitsluitend wijzigen in het gekoppelde systeem.

Verwijzing technische documentatie Technische documentatie
Ophalen van gewijzigde contacten


Ophalen van afmeldingen

Elke e-mail uit Spotler heeft een link naar een landingspagina van Spotler waarop de ontvanger zichzelf kan afmelden voor toekomstige e-mailings . In feite is een afmelding hetzelfde als een contactwijziging, omdat een afmelding een verandering betekent van één of meerdere permissies van het contact. Met het ophalen van gewijzigde contacten haal je dus gelijk ook de afmeldingen op.

Specifieke segmentaties gebruiken in Spotler

Het gekoppelde systeem is meestal het bronsysteem en beschikt vaak over veel meer gegevens dan alleen de directe contactgegevens. Deze gegevens synchroniseer je waarschijnlijk (bewust) niet allemaal naar Spotler. Toch wil een marketeer soms op basis van deze gegevens gesegmenteerd e-mail marketing kunnen toepassen. Bijvoorbeeld om een  een uitnodiging van een evenement te sturen naar een specifieke lijst genodigden.

Met de API is het mogelijk om specifieke selecties van contacten in Spotler in te schieten. In Spotler worden deze selecties Statische lijsten genoemd. In feite is het niets anders dan een verzameling van contactId’s met een logische naam, zodat de marketeer in Spotler ook weet waar de lijst voor bedoeld is. Er kunnen maximaal 30 statische lijsten worden in geschoten. Het is daarom handig om ook het verwijderen van statische lijsten mogelijk te maken in de koppeling. Er kunnen via de API alléén statische lijsten worden verwijderd die door het systeem zelf zijn ingeschoten.

Verwijzing technische documentatie Technische documentatie
Inschieten van een tijdelijke lijst
Contacten toevoegen aan een tijdelijke lijst
Ophalen van alle tijdelijke lijsten
Verwijderen van een tijdelijke lijst


Inschrijvingen inschieten

Er is een aparte methode om contacten die zichzelf hebben aangemeld voor een nieuwsbrief in te schieten in Spotler. Bij de aanroep moet minimaal het ingevulde e-mailadres én de juiste permissie worden meegegeven. Het is puur bedoeld om nieuwe aanmeldingen te registreren in Spotler. Denk bijvoorbeeld aan een eigen aanmeldformulier op een website. De methode is niet bedoeld om twee systemen met elkaar synchroon te houden. Daarom hoef je ook geen contactId mee te geven bij de aanroep.

Verwijzing technische documentatie Technische documentatie
Inschieten van nieuwsbriefinschrijvers

 

Contacten zoeken op basis van een eigenschap

Met de API is het mogelijk om contacten op basis van een bepaalde eigenschap of een combinatie van meerdere eigenschappen op te zoeken in Spotler. Een voorbeeld waarbij deze methode wordt gebruikt is een webformulier waarin een bezoeker alleen een kortingscode kan invoeren. Hiermee kan in Spotler worden opgezocht welk contact bij de kortingscode hoort. Als het contact wordt gevonden, kan er een gepersonaliseerde landingspagina worden getoond. Bijvoorbeeld een geprefilled formulier. Als het contact niet wordt gevonden, kan er op een landingspagina gemeld worden dat er geen geldige code is ingevoerd.

Verwijzing technische documentatie Technische documentatie
Contacten zoeken op basis van een eigenschap