Med integrationen för Bloomreach skapas eller uppdateras alla som registrerar sig som en kund i ditt Bloomreach Engagement-projekt, identifierad via sin e-postadress. Du kan också ge dem ett samtycke i Bloomreach, så att du får skicka marknadsföring till dem.
Det här behöver du
- Ett Bloomreach Engagement-projekt och en användare som kan hantera API-åtkomst i projektinställningarna (oftast en projektadministratör).
Steg 1: Skapa en API-nyckel i Bloomreach
- Öppna projektet i Bloomreach Engagement och gå till Project settings > Access management > API.
- Kopiera Project token och API base URL som visas på sidan.
- Under API-grupperna skapar du en ny grupp med Private access och ger den ett namn, till exempel "Scratcher".
- Skapa en ny API-nyckel i gruppen. Kopiera API key ID och API secret. Din secret visas bara en gång.
- Ge gruppen behörigheterna nedan och spara.
Behörigheter som nyckeln behöver
I gruppens behörigheter tillåter du:
- Customer properties: get och set, för att hitta kunder och skapa eller uppdatera dem, och för att visa dina kundegenskaper i fältmappningen.
- Events: set, för händelsen
consent, så att Scratcher kan registrera samtycken.
Inget annat behövs. Utan set-behörigheterna misslyckas leveranserna med Bloomreachs eget åtkomstfel.
Steg 2: Anslut Bloomreach till Scratcher
- Gå till Inställningar > Integrationer i Scratcher och klicka på Bloomreach.
- Klistra in API base URL, project token, API key ID och API secret i motsvarande fält.
- Klicka på Installera integration. Scratcher kontrollerar uppgifterna med Bloomreach.
Steg 3: Slå på den i en kampanj
- I redigeraren går du till Anslut > Integrationer > Bloomreach och klickar på Aktivera.
- Om du har anslutit mer än ett projekt väljer du det under Välj konto.
- Under Fältmappningar klickar du på Lägg till fältmappning och kopplar varje Scratcher-fält till en kundegenskap i Bloomreach, till exempel "Lead - Förnamn" till first_name.
- Välj den samtyckeskategori som personerna ska få, till exempel "newsletter", eller ingen.
- Under Filtrera på samtycken (valfritt) väljer du din kryssruta för marknadsföringssamtycke, så att bara personer som har kryssat i den skickas.
- Klicka på Spara och sedan på Testa.
Bra att veta: Bloomreach har inga listor. Alla hamnar i projektet, och du grupperar dem med segment i Bloomreach. Därför börjar Scratcher skicka så fort du klickar på Aktivera. Aktivera integrationen innan kampanjen blir live, eller ställ in den direkt.
Fältmappning
- E-postadressen skickas alltid och används för att hitta kunden. Du behöver inte mappa den.
- Listan Målfält visar kundegenskaperna i ditt projekt. Skapa först en egenskap i Bloomreach om den saknas.
- Om du vill markera var kunderna kom ifrån mappar du ett Använd anpassat värde, till exempel "Scratcher sommarspel", till en egenskap som du använder för källan.
Samtycke
Om du väljer en samtyckeskategori registrerar Scratcher en consent-händelse med åtgärden accept och kampanjens namn som källa. Kategorin måste finnas i Bloomreach (under samtyckesinställningarna i Project settings). Använd Filtrera på samtycken så att bara personer som har kryssat i din kryssruta för marknadsföring får samtycket.
Vad som skickas och när
Nya registreringar skickas inom en minut eller två. När du aktiverar integrationen skickas även kampanjens befintliga leads. När någon deltar igen uppdateras kunden. Kontrollera varje leverans under Inställningar > Integrationer > Leveransstatus. Läs mer i Kontrollera leveransstatus och skicka leads igen.
Felsökning
- "Några eller alla fält är ogiltiga …" vid installationen: kontrollera API base URL och project token, och kopiera key ID och secret igen.
- Leveranser misslyckas med ett åtkomstfel: API-gruppen saknar en av behörigheterna ovan. Redigera den i Bloomreach.
- Samtycket syns inte på kunden: samtyckeskategorin finns inte i Bloomreach, eller är stavad på ett annat sätt.
- Bloomreach har egna guider för API-nycklar. Sök efter "API access management" i Bloomreachs dokumentation om menyerna ser annorlunda ut.