Bloomreach-integraation avulla jokainen ilmoittautuja luodaan tai päivitetään asiakkaaksi Bloomreach Engagement -projektiisi, ja hänet tunnistetaan sähköpostiosoitteen perusteella. Voit myös antaa hänelle Bloomreach-suostumuksen, jotta saat lähettää hänelle markkinointia.
Mitä tarvitset
- Bloomreach Engagement -projektin ja käyttäjän, joka voi hallita API-käyttöä projektin asetuksissa (yleensä projektin ylläpitäjä).
Vaihe 1: Luo API-avain Bloomreachissa
- Avaa projekti Bloomreach Engagementissa ja siirry kohtaan Project settings > Access management > API.
- Kopioi sivulla näkyvät Project token ja API base URL.
- Luo API-ryhmien alle uusi ryhmä, jolla on Private access, ja anna sille nimi, esimerkiksi ”Scratcher”.
- Luo ryhmään uusi API-avain. Kopioi API key ID ja API secret. Salaisuus näytetään vain kerran.
- Anna ryhmälle alla luetellut käyttöoikeudet ja tallenna.
Avaimen tarvitsemat käyttöoikeudet
Salli ryhmän käyttöoikeuksissa:
- Customer properties: get ja set, jotta asiakkaita voidaan etsiä, luoda ja päivittää ja jotta asiakasominaisuutesi näkyvät kenttävastaavuuksissa.
- Events: set,
consent-tapahtumaa varten, jotta Scratcher voi kirjata suostumukset.
Muuta ei tarvita. Ilman set-oikeuksia toimitukset epäonnistuvat Bloomreachin omaan käyttöoikeusvirheeseen.
Vaihe 2: Yhdistä Bloomreach Scratcheriin
- Siirry Scratcherissa kohtaan Asetukset > Integraatiot ja klikkaa Bloomreach.
- Liitä API base URL, project token, API key ID ja API secret niitä vastaaviin kenttiin.
- Klikkaa Asenna integraatio. Scratcher tarkistaa tiedot Bloomreachista.
Vaihe 3: Ota se käyttöön kampanjassa
- Siirry editorissa kohtaan Yhdistä > Integraatiot > Bloomreach ja klikkaa Aktivoi.
- Jos olet yhdistänyt useamman projektin, valitse oikea kohdassa Valitse tili.
- Klikkaa kohdassa Kenttävastaavuudet Lisää kenttävastaavuus ja yhdistä jokainen Scratcher-kenttä Bloomreachin asiakasominaisuuteen, esimerkiksi ”Lead - First name” kenttään first_name.
- Valitse suostumusluokka, jonka ihmiset saavat, esimerkiksi ”newsletter”, tai ei mitään.
- Valitse kohdassa Suodata suostumusten mukaan (valinnainen) markkinointisuostumuksen valintaruutusi, jotta vain sen valinneet lähetetään.
- Klikkaa Tallenna ja sitten Testaa.
Hyvä tietää: Bloomreachissa ei ole listoja. Kaikki menevät projektiin, ja ryhmittelet heidät segmenteillä Bloomreachissa. Siksi Scratcher alkaa lähettää heti, kun klikkaat Aktivoi. Aktivoi se ennen kuin kampanja julkaistaan, tai määritä se saman tien loppuun.
Kenttävastaavuudet
- Sähköpostiosoite lähetetään aina, ja sen avulla asiakas löydetään. Sitä ei tarvitse määrittää.
- Kohdekenttä-lista näyttää projektisi asiakasominaisuudet. Luo ominaisuus ensin Bloomreachissa, jos se puuttuu.
- Jos haluat merkitä, mistä asiakkaat tulivat, yhdistä Käytä mukautettua arvoa -arvo, kuten ”Scratcher summer game”, ominaisuuteen, jota käytät lähteelle.
Suostumus
Jos valitset suostumusluokan, Scratcher kirjaa consent-tapahtuman toiminnolla accept ja lähteenä kampanjan nimen. Luokan on oltava olemassa Bloomreachissa (suostumusasetuksissa kohdassa Project settings). Käytä Suodata suostumusten mukaan -asetusta, jotta vain markkinointivalintaruutusi valinneet saavat suostumuksen.
Mitä lähetetään ja milloin
Uudet ilmoittautujat lähetetään minuutin tai kahden kuluessa. Kun aktivoit integraation, myös kampanjan olemassa olevat liidit lähetetään. Kun joku osallistuu uudelleen, asiakas päivitetään. Tarkista jokainen toimitus kohdassa Asetukset > Integraatiot > Toimituksen tila. Katso Tarkista toimituksen tila ja lähetä liidit uudelleen.
Vianmääritys
- ”Jotkin tai kaikki kentät ovat virheellisiä...” asennettaessa: tarkista API base URL ja project token ja kopioi key ID ja salaisuus uudelleen.
- Toimitukset epäonnistuvat käyttöoikeusvirheeseen: API-ryhmältä puuttuu jokin yllä mainituista käyttöoikeuksista. Muokkaa sitä Bloomreachissa.
- Suostumus ei näy asiakkaalla: suostumusluokkaa ei ole Bloomreachissa, tai se on kirjoitettu eri tavalla.
- Bloomreachilla on omat ohjeensa API-avaimille. Hae Bloomreachin dokumentaatiosta ”API access management”, jos valikot näyttävät erilaisilta.