Forbind Bloomreach

Med integrationen til Bloomreach bliver alle, der tilmelder sig, oprettet eller opdateret som kunde i dit Bloomreach Engagement-projekt, identificeret ud fra deres e-mailadresse. Du kan også give dem et samtykke i Bloomreach, så du må sende dem markedsføring.

Det skal du bruge

• Et Bloomreach Engagement-projekt og en bruger, der kan administrere API-adgang i projektindstillingerne (som regel en projektadministrator).

Trin 1: Opret en API-nøgle i Bloomreach

1. Åbn projektet i Bloomreach Engagement, og gå til Project settings > Access management > API.
2. Kopiér Project token og API base URL, som står på siden.
3. Under API-grupperne opretter du en ny gruppe med Private access og giver den et navn, fx "Scratcher".
4. Opret en ny API-nøgle i gruppen. Kopiér API key ID og API secret. Secret bliver kun vist én gang.
5. Giv gruppen rettighederne nedenfor, og gem.

Rettigheder, nøglen skal have

Tillad følgende i gruppens rettigheder:

• Customer properties: get og set, til at finde kunder og oprette eller opdatere dem og til at vise dine kundeegenskaber i felttilknytningen.
• Events: set, for eventet consent, så Scratcher kan registrere samtykker.

Der skal ikke bruges andet. Uden set-rettighederne mislykkes leveringerne med Bloomreachs egen adgangsfejl.

Trin 2: Forbind Bloomreach med Scratcher

1. Gå til Indstillinger > Integrationer i Scratcher, og klik på Bloomreach.
2. Indsæt API base URL, project token, API key ID og API secret i de tilsvarende felter.
3. Klik på Installér integration. Scratcher tjekker oplysningerne hos Bloomreach.

Trin 3: Slå det til i en kampagne

1. Gå til Forbind > Integrationer > Bloomreach i editoren, og klik på Aktivér.
2. Har du forbundet mere end ét projekt, vælger du det under Vælg konto.
3. Under Felttilknytninger klikker du på Tilføj felttilknytning og matcher hvert Scratcher-felt med en kundeegenskab i Bloomreach, fx "Lead - Fornavn" med first_name.
4. Vælg den samtykkekategori, folk skal have, fx "newsletter", eller ingen.
5. Under Filtrér efter samtykker (valgfrit) vælger du dit afkrydsningsfelt til samtykke til markedsføring, så kun dem, der har sat flueben, bliver sendt.
6. Klik på Gem og derefter på Test.

Godt at vide: Bloomreach har ingen lister. Alle kommer ind i projektet, og du grupperer dem med segmenter i Bloomreach. Derfor begynder Scratcher at sende, så snart du klikker på Aktivér. Aktivér den, før kampagnen går live, eller sæt den op med det samme.

Felttilknytning

• E-mailadressen bliver altid sendt og bruges til at finde kunden. Du behøver ikke at tilknytte den.
• Listen Destinationsfelt viser kundeegenskaberne i dit projekt. Opret egenskaben i Bloomreach først, hvis den mangler.
• Vil du markere, hvor kunderne kom fra, så tilknyt en Brug brugerdefineret værdi som "Scratcher sommerspil" til en egenskab, du bruger til kilden.

Samtykke

Vælger du en samtykkekategori, registrerer Scratcher et consent-event med handlingen accept og kampagnens navn som kilde. Kategorien skal findes i Bloomreach (under samtykkeindstillingerne i Project settings). Brug Filtrér efter samtykker, så kun dem, der har sat flueben i dit afkrydsningsfelt til markedsføring, får samtykket.

Hvad bliver sendt, og hvornår

Nye tilmeldinger bliver sendt inden for et minut eller to. Når du aktiverer integrationen, bliver kampagnens eksisterende leads også sendt. Når nogen deltager igen, bliver kunden opdateret. Tjek hver levering under Indstillinger > Integrationer > Leveringsstatus. Se Tjek leveringsstatus, og send leads igen.

Fejlfinding

• "Nogle eller alle felterne er ugyldige ..." ved installationen: tjek API base URL og project token, og kopiér key ID og secret igen.
• Leveringer mislykkes med en adgangsfejl: API-gruppen mangler en af rettighederne ovenfor. Redigér den i Bloomreach.
• Samtykket vises ikke på kunden: samtykkekategorien findes ikke i Bloomreach eller er stavet anderledes.
• Bloomreach har sine egne guides til API-nøgler. Søg efter "API access management" i Bloomreachs dokumentation, hvis menuerne ser anderledes ud.