Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Version History

« Previous Version 67 Current »

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

Implementatie

Voor het implementeren van de Mail+ koppeling:

🔗 Implementeren Mail+

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

  • E-mailadressen: nieuwe e-mailadressen worden realtime gesynchroniseerd van Spotler Activate naar Mail+. Vanuit Mail+ worden nieuwe e-mailadressen uurlijks gesynchroniseerd naar Spotler Activate.

  • Consent: wijzigingen van consent worden realtime gesynchroniseerd van Spotler Activate naar Mail+. Vanuit Mail+ worden de wijzigingen uurlijks gesynchroniseerd naar Spotler Activate.

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

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

(plus) (Custom) profielvelden synchronisatie tussen Activate en Mail+

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

(plus) Custom productvelden aanmaken in Spotler Mail+

  • Mail+ Forms data: als je Mail+ Forms data naar Spotler Activate wilt sturen, kun je dat doen met onze nieuwe Mail+ Forms Webhook

(plus) Spotler Forms

 Wat zijn de standaard profielvelden die worden opgeslagen in Spotler Mail+?

De volgende profielvelden uit Spotler Activate worden standaard opgeslagen in de Mail+ velden:

Spotler Activate profielveld

Mail+veld

Birthdate

Geboortedatum

City

Woonplaats

Customer Phase

Spotler Activate - Customer Phase

Email

E-mailadres

Fav. Category 1

Spotler Activate - Fav. Category 1

Fav. Category 2

Spotler Activate - Fav. Category 2

Fav. Category 3

Spotler Activate - Fav. Category 3

Favorite Brand

Spotler Activate - Favorite Brand

First Name

Voornaam

Gender

Geslacht

Last Name

Achternaam

Last purchase date

Spotler Activate - Last purchase date

Last visit date

Spotler Activate - Last visit date

Phone

Telefoon nr.

Postal Code

Postcode

 Wat zijn de standaard productvelden die worden opgeslagen in Spotler Mail+?

De volgende productvelden uit Spotler Activate worden standaard opgeslagen in de Mail+ velden:

Spotler Activate productveld

Mail+veld

SKU (met language code)

SKU

Name

Naam

Description

Omschrijving

Url

Link

Brand

Merk

Price (of Sale Price indien aanwezig)

Prijs

Language

Taal

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

Audiences & Profielen

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

image-20240212-095843.png

Voor de profielen in de audience verstuurt Spotler Activate twee API calls naar Mail+:

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

In Mail+ wordt de API call ‘Contacten’ verwerkt onder ‘Contacten’:

  • Ga in Mail+ 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 Mail+ verstuurd.

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

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

  • 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 Spotler Activate, blijft deze standaard aanwezig in Mail+. Dit is een bewuste keuze vanuit Mail+’s kant zodat je geen audience verwijdert die je mogelijk op dat moment nog aanspreekt in je Mail+ omgeving. In Mail+ kun je de audience handmatig verwijderen.

Triggers & Productsets

In de Journey Builder kun je triggers naar Mail+ 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 Mail+ en gebruik deze vervolgens in een publication. Deze bevat een sequentie aan events die in Mail+ uitgevoerd worden, vaak een e-mail verzenden maar je kan ook iemands profiel updaten.

Campaign trigger

Maak een campaign aan in Mail+. 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 Spotler Activate 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 Mail+ personalisatievelden toe te voegen die gevuld worden vanuit Spotler Activate, in plaats vanuit Mail+. Dit noemt Mail+ ‘campaignfields’.

In het geval van Spotler Activate kun je velden van het journey entry event als campaign fields doorsturen naar Mail+, 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 Mail+ 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 Mail+ database. Op het moment van verzending worden de velden met de API gevuld vanuit Spotler Activate. 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

(warning) Voor de standaard productsets van Spotler Activate, is de taal van het account leidend voor de taal van de productset in Mail+

📢 Campagne maken

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

  • Spotler Activate 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 Mail+ is verstuurd?

In Spotler Activate kun je de status van de trigger als volgt inzien:

  • Ga in Spotler Activate 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 Mail+ is verstuurd

    • Handled: of de trigger is afgehandeld in Spotler Activate

    • Sent: of de trigger is verzonden naar Mail+

    • Channel: het kanaal dat getriggerd is

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

In Mail+ kun de getriggerde campagne als volgt bekijken:

  • Ga in Mail+ 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 Mail+ 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}

  • No labels