S integrací Bloomreach se každý, kdo se zaregistruje, vytvoří nebo aktualizuje jako zákazník ve vašem projektu Bloomreach Engagement, identifikovaný podle e-mailové adresy. Můžete mu také udělit souhlas v Bloomreachi, abyste mu směli posílat marketing.
Co budete potřebovat
- Projekt Bloomreach Engagement a uživatele, který může spravovat přístup k API v nastavení projektu (obvykle administrátor projektu).
Krok 1: Vytvořte API klíč v Bloomreachi
- V Bloomreach Engagement otevřete projekt a přejděte do Project settings > Access management > API.
- Zkopírujte Project token a API base URL, které stránka zobrazuje.
- Pod API skupinami vytvořte novou skupinu s Private access a pojmenujte ji například „Scratcher“.
- Ve skupině vytvořte nový API klíč. Zkopírujte API key ID a API secret. Secret se zobrazí jen jednou.
- Dejte skupině oprávnění níže a uložte.
Oprávnění, která klíč potřebuje
V oprávněních skupiny povolte:
- Customer properties: get a set, aby Scratcher mohl hledat zákazníky, vytvářet je nebo aktualizovat a zobrazit vaše vlastnosti zákazníků v mapování polí.
- Events: set, pro událost
consent, aby Scratcher mohl zaznamenávat souhlasy.
Nic dalšího není potřeba. Bez oprávnění set doručení selžou s vlastní chybou přístupu z Bloomreache.
Krok 2: Připojte Bloomreach ke Scratcheru
- Ve Scratcheru přejděte do Nastavení > Integrace a klikněte na Bloomreach.
- Do odpovídajících polí vložte API base URL, project token, API key ID a API secret.
- Klikněte na Nainstalovat integraci. Scratcher údaje ověří u Bloomreache.
Krok 3: Zapněte ho v kampani
- V editoru přejděte do Připojit > Integrace > Bloomreach a klikněte na Aktivovat.
- Pokud máte připojený více než jeden projekt, vyberte ho v Vybrat účet.
- V části Mapování polí klikněte na Přidat mapování pole a přiřaďte každé Pole Scratcheru k vlastnosti zákazníka v Bloomreachi, například „Lead - Jméno“ k first_name.
- Zvolte kategorii souhlasu, kterou mají lidé dostat, například „newsletter“, nebo žádnou.
- V části Filtrovat podle souhlasů (volitelné) vyberte své zaškrtávací políčko se souhlasem s marketingem, aby se posílali jen lidé, kteří ho zaškrtli.
- Klikněte na Uložit a pak na Otestovat.
Dobré vědět: Bloomreach nemá seznamy. Všichni jdou do projektu a v Bloomreachi je seskupíte pomocí segmentů. Scratcher proto začne posílat hned, jak kliknete na Aktivovat. Aktivujte ho dřív, než kampaň spustíte, nebo ho rovnou celý nastavte.
Mapování polí
- E-mailová adresa se posílá vždy a slouží k nalezení zákazníka. Mapovat ji nemusíte.
- Seznam Cílové pole ukazuje vlastnosti zákazníků ve vašem projektu. Pokud vlastnost chybí, vytvořte ji nejdřív v Bloomreachi.
- Chcete-li označit, odkud zákazníci přišli, namapujte Použít vlastní hodnotu, například „Scratcher letní hra“, na vlastnost, kterou používáte pro zdroj.
Souhlas
Pokud zvolíte kategorii souhlasu, Scratcher zaznamená událost consent s akcí accept a názvem kampaně jako zdrojem. Kategorie musí v Bloomreachi existovat (v nastavení souhlasů v Project settings). Použijte Filtrovat podle souhlasů (volitelné), aby souhlas dostali jen lidé, kteří zaškrtli vaše políčko se souhlasem s marketingem.
Co se posílá a kdy
Nové registrace se odešlou do minuty nebo dvou. Když integraci aktivujete, odešlou se i stávající leady kampaně. Když se někdo zúčastní znovu, zákazník se aktualizuje. Každé doručení zkontrolujete v Nastavení > Integrace > Stav doručení. Viz Kontrola stavu doručení a opětovné odeslání leadů.
Řešení problémů
- „Některá nebo všechna pole jsou neplatná...“ při instalaci: zkontrolujte API base URL a project token a znovu zkopírujte key ID a secret.
- Doručení selžou s chybou přístupu: API skupině chybí některé z oprávnění výše. Upravte ji v Bloomreachi.
- Souhlas se u zákazníka nezobrazuje: kategorie souhlasu v Bloomreachi neexistuje, nebo je napsaná jinak.
- Bloomreach má k API klíčům vlastní návody. Pokud nabídky vypadají jinak, vyhledejte v dokumentaci Bloomreache „API access management“.