Spotler

Met de Spotler koppeling kun je data synchroniseren tussen Squeezely en de Email Service Provider (ESP) Spotler. Via de koppeling kunnen audiences, profielen, triggers en productsets uit Squeezely worden verstuurd naar Spotler.

Implementatie

Voor het implementeren van de Spotler koppeling:

🔗 Implementeren Spotler

Door het afronden van de volledige implementatie worden eenmalig e-mailadressen en consent gesynchroniseerd tussen Spotler en Squeezely. Daarnaast worden de standaard profielvelden en product catalog van Squeezely naar Spotler gesynchroniseerd. Na het leggen van de koppeling wordt de volgende data gesynchroniseerd:

E-mailadressen: nieuwe e-mailadressen worden realtime gesynchroniseerd van Squeezely naar Spotler. Vanuit Spotler worden nieuwe e-mailadressen uurlijks gesynchroniseerd naar Squeezely.
Consent: wijzigingen van consent worden realtime gesynchroniseerd van Squeezely naar Spotler. Vanuit Spotler worden de wijzigingen uurlijks gesynchroniseerd naar Squeezely.

Let op: pas niet de description ‘Nieuwsbrief’ aan in Spotler! De consent wordt dan niet correct gesynchroniseerd.

Profielvelden: met elke API call worden de standaard profielvelden vanuit Squeezely verstuurd en opgeslagen in Spotler. Squeezely haalt middels een uurlijkse import ook de profielvelden uit Spotler op. Voor een synchronisatie van (custom) profielvelden tussen Squeezely en Spotler:

(Custom) profielvelden synchronisatie tussen Squeezely en Spotler

Productvelden: de producten en standaard productvelden worden na elke product import gesynchroniseerd van Squeezely naar Spotler. Voor het opslaan van custom productvelden in Spotler:

Custom productvelden aanmaken in Spotler

Spotler Forms data: als je Spotler Forms data naar Squeezely wilt sturen, kun je dat doen met onze nieuwe Spotler Forms Webhook

Spotler Forms

Wat zijn de standaard profielvelden die worden opgeslagen in Spotler?

De volgende profielvelden uit Squeezely worden standaard opgeslagen in de Spotler velden:

Squeezely profielveld	Spotlerveld
Birthdate	Geboortedatum
City	Woonplaats
Customer Phase	Squeezely - Customer Phase
Email	E-mailadres
Fav. Category 1	Squeezely - Fav. Category 1
Fav. Category 2	Squeezely - Fav. Category 2
Fav. Category 3	Squeezely - Fav. Category 3
Favorite Brand	Squeezely - Favorite Brand
First Name	Voornaam
Gender	Geslacht
Last Name	Achternaam
Last purchase date	Squeezely - Last purchase date
Last visit date	Squeezely - Last visit date
Phone	Telefoon nr.
Postal Code	Postcode

Wat zijn de standaard productvelden die worden opgeslagen in Spotler?

De volgende productvelden uit Squeezely worden standaard opgeslagen in de Spotler velden:

Squeezely productveld	Spotlerveld
SKU (met language code)	SKU
Name	Naam
Description	Omschrijving
Url	Link
Brand	Merk
Price (of Sale Price indien aanwezig)	Prijs
Language	Taal

Let op: Squeezely synchroniseert de laagste waarde van de velden price en sale price naar het veld price in Spotler. Voor het legen van de sale price in Squeezely dient (eenmalig) sale price doorgestuurd te worden als leeg, 0 of null.

Audiences & Profielen

In de Audience Builder kun je Audiences naar Spotler versturen door Spotler als Channel aan te vinken:

Voor de profielen in de audience verstuurt Squeezely twee API calls naar Spotler:

Contacten: met deze API call worden de profielvelden van het profiel naar Spotler verstuurd en in Spotler opgeslagen. Voor het opslaan van custom profielvelden, dienen deze gemapt te worden.

Hoe wordt de API call 'Contacten' verwerkt in Spotler?

In Spotler wordt de API call ‘Contacten’ verwerkt onder ‘Contacten’:

Ga in Spotler naar Contacten
Zoek het profiel op en klik op ‘Bekijken’

Bekijk onder ‘Persoonlijke gegevens’ de gesynchroniseerde data van het profiel:

Dynamische lijsten: met deze API call worden de audiences naar Spotler verstuurd.

Hoe wordt de API call 'Dynamische lijsten' verwerkt in Spotler?

In Spotler wordt de API call ‘Dynamische lijsten’ verwerkt onder ‘Dynamische lijsten’:

Ga in Spotler naar Dynamische lijsten
Zoek de audience

Klik op ‘Bekijken’

In dit overzicht zie je de profielen die tot de audience behoren en informatie over de audience.

Wanneer je een audience verwijdert in Squeezely, blijft deze standaard aanwezig in Spotler. Dit is een bewuste keuze vanuit Spotler’s kant zodat je geen audience verwijdert die je mogelijk op dat moment nog aanspreekt in je Spotler omgeving. In Spotler kun je de audience handmatig verwijderen.

Triggers & Productsets

In de Journey Builder kun je triggers naar Spotler versturen met de E-mail trigger:

In de E-mail trigger heb je twee verschillende opties voor automatische berichten te versturen, je kiest een van beide:

Automation trigger

Maak een automation aan in Spotler en gebruik deze vervolgens in een publication. Deze bevat een sequentie aan events die in Spotler uitgevoerd worden, vaak een e-mail verzenden maar je kan ook iemands profiel updaten.

Campaign trigger

Maak een campaign aan in Spotler. Deze bevat een campaign flow welke uit stappen bestaat die je wenst uit te voeren nav de trigger, bijvoorbeeld het versturen van een specifieke (product) template.

Zorg ervoor dat je automations, publications en campaigns allemaal live zijn. Een automation moet final zijn en aangeroepen worden in een publication die running is. Een campaign hoort active te zijn.

Extra opties

Products: de productset die wordt meegestuurd met de trigger
Campaign Fields: indien beschikbaar, stuurt Squeezely ook campaign fields van het Journey entry event door

Wat zijn campaign fields en hoe stel ik deze in?

Het is mogelijk om in je campagnebericht in Spotler personalisatievelden toe te voegen die gevuld worden vanuit Squeezely, in plaats vanuit Spotler. Dit noemt Spotler ‘campaignfields’.

In het geval van Squeezely kun je velden van het journey entry event als campaign fields doorsturen naar Spotler, dus o.a.

visit_event
visit_url
visit_orderid
visit_email
visit_firstname
visit_lastname
visit_total_value
visit_value
visit_checkin_date
visit_checkout_date
visit_amount_nights
visit_custom_{...}

Hoe werken campaignfields?

In je bericht of template in Spotler zet je placeholders neer. Dit houdt in dat je aangeeft waar en welke informatie getoond moet worden.

Bijvoorbeeld:

Order:

Order ID: [campaignfield:visit_orderid]
Voornaam: [campaignfield:visit_firstname]
Schoenmaat:[campaignfield:visit_custom_schoenmaat]

Een voordeel van het gebruik van campaignfields is dat deze data niet opgeslagen wordt in de Spotler database. Op het moment van verzending worden de velden met de API gevuld vanuit Squeezely. Zo heb je altijd de meest up-to-date gegevens voor handen.

De placeholder namen worden door middel van [campaignfield:name] in een bericht geplaatst.

Let op: In een bericht kun je meerdere campaignfields toevoegen. Er zijn drie aandachtspunten:

De campaignfield name moet uniek zijn
De campaignfield name mag geen spaties bevatten
De campaignfield name is hoofdlettergevoelig

Voor de standaard productsets van Squeezely, is de taal van het account leidend voor de taal van de productset in Spotler

📢 Campagne maken

Voor de profielen die de E-mail trigger bereiken en voldoen aan de voorwaarden, verstuurt Squeezely een API Call naar Spotler:

Squeezely Trigger: met deze API call wordt een trigger verstuurd voor het profiel en eventueel de productset van het profiel meegestuurd.

Hoe kan ik controleren of de trigger naar Spotler is verstuurd?

In Squeezely kun je de status van de trigger als volgt inzien:

Ga in Squeezely naar 360° Profiles
Zoek het profiel op dat de E-mail trigger in de journey heeft bereikt
Ga in het profiel naar ‘Automations’

In dit overzicht zie je het volgende:
- Created at: het tijdstip waarop de trigger is bereikt
- Contact id: het ID van het betreffende profiel
- Campaign/Journey ID: het ID van de betreffende journey
- Buffer endtime: het tijdstip waarop de trigger naar Spotler is verstuurd
- Handled: of de trigger is afgehandeld in Squeezely
- Sent: of de trigger is verzonden naar Spotler
- Channel: het kanaal dat getriggerd is

Hoe kan ik de API call 'Squeezely Trigger' in Spotler bekijken?

In Spotler kun de getriggerde campagne als volgt bekijken:

Ga in Spotler naar Contacten
Zoek het profiel op en klik op ‘Bekijken’
Klik op ‘Campagne interacties’

In dit overzicht zie je de campagnes die getriggerd zijn voor het profiel.

Hoe kan ik e-mail hash toevoegen aan campagnes?

In het profielveld email_hash is de versleutelde versie van het e-mailadres verwerkt. De e-mail hash kan als volgt worden toegevoegd aan campagnes:

Ga in Spotler naar Webanalytics
Selecteer ‘Extra Parameters’ en zet de status op 'actief
Klik op ‘Bewerken’ en voer het volgende in:

Klik op ‘OK’

✅ De e-mail hash wordt toegevoegd aan de URL’s van alle campagnes, bijvoorbeeld www.mijnwebsite.nl?email_hash={email_hash}

Wil jij een Items you may like of Recommended for you sets tonen in een nieuwsbrief? Stuur een bericht naar het Squeezely Help Center met als onderwerp ‘Ik wil graag deelnemen aan de Mailplus Spotler Beta versie voor recommendations’ en doe mee aan het Beta programma!