---
title: "Yhdistä Bloomreach"
description: "Luo API-avain Bloomreach Engagementissa, yhdistä se ja luo tai päivitä asiakkaita suostumuksineen."
url: https://scratcher.io/fi/help/integrations/bloomreach
language: fi
---

1. [Ohjekeskus](https://scratcher.io/fi/help)
2. [Integraatiot](https://scratcher.io/fi/help/integrations)
3. Yhdistä Bloomreach

# Yhdistä Bloomreach

Luo API-avain Bloomreach Engagementissa, yhdistä se ja luo tai päivitä asiakkaita suostumuksineen.

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

1. Avaa projekti Bloomreach Engagementissa ja siirry kohtaan **Project settings** > **Access management** > **API**.
2. Kopioi sivulla näkyvät **Project token** ja **API base URL**.
3. Luo API-ryhmien alle uusi ryhmä, jolla on **Private access**, ja anna sille nimi, esimerkiksi ”Scratcher”.
4. Luo ryhmään uusi API-avain. Kopioi **API key ID** ja **API secret**. Salaisuus näytetään vain kerran.
5. 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

1. Siirry Scratcherissa kohtaan **Asetukset** > **Integraatiot** ja klikkaa **Bloomreach**.
2. Liitä API base URL, project token, API key ID ja API secret niitä vastaaviin kenttiin.
3. Klikkaa **Asenna integraatio**. Scratcher tarkistaa tiedot Bloomreachista.

## Vaihe 3: Ota se käyttöön kampanjassa

1. Siirry editorissa kohtaan **Yhdistä** > **Integraatiot** > **Bloomreach** ja klikkaa **Aktivoi**.
2. Jos olet yhdistänyt useamman projektin, valitse oikea kohdassa **Valitse tili**.
3. Klikkaa kohdassa **Kenttävastaavuudet** **Lisää kenttävastaavuus** ja yhdistä jokainen **Scratcher-kenttä** Bloomreachin asiakasominaisuuteen, esimerkiksi ”Lead - First name” kenttään **first\_name**.
4. Valitse suostumusluokka, jonka ihmiset saavat, esimerkiksi ”newsletter”, tai ei mitään.
5. Valitse kohdassa **Suodata suostumusten mukaan (valinnainen)** markkinointisuostumuksen valintaruutusi, jotta vain sen valinneet lähetetään.
6. 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](https://scratcher.io/fi/help/integrations/delivery-status).

## 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.

Integraatiot

- [Miten integraatiot toimivat](https://scratcher.io/fi/help/integrations/how-integrations-work)
- [Kaikki integraatiot](https://scratcher.io/fi/help/integrations/other-integrations)
- [Tarkista toimituksen tila ja lähetä liidit uudelleen](https://scratcher.io/fi/help/integrations/delivery-status)
- [Yhdistä HubSpot](https://scratcher.io/fi/help/integrations/hubspot)
- [Yhdistä Salesforce Marketing Cloud](https://scratcher.io/fi/help/integrations/salesforce-marketing-cloud)
- [Yhdistä Microsoft Dynamics 365 Zapierilla](https://scratcher.io/fi/help/integrations/microsoft-dynamics-365)
- [Yhdistä Emarsys](https://scratcher.io/fi/help/integrations/emarsys)
- [Yhdistä Klaviyo](https://scratcher.io/fi/help/integrations/klaviyo)
- [Yhdistä Mailchimp](https://scratcher.io/fi/help/integrations/mailchimp)
- [Yhdistä ActiveCampaign](https://scratcher.io/fi/help/integrations/activecampaign)
- [Yhdistä Apsis One](https://scratcher.io/fi/help/integrations/apsis-one)
- [Yhdistä Drip](https://scratcher.io/fi/help/integrations/drip)
- [Yhdistä HeyLoyalty](https://scratcher.io/fi/help/integrations/heyloyalty)
- [Yhdistä Peytz](https://scratcher.io/fi/help/integrations/peytz)
- [Yhdistä Marketingplatform](https://scratcher.io/fi/help/integrations/marketingplatform)
- [Yhdistä Campaign Monitor Zapierilla](https://scratcher.io/fi/help/integrations/campaign-monitor)
- [Yhdistä ActiveTrail Zapierilla](https://scratcher.io/fi/help/integrations/activetrail)
- [Yhdistä Bloomreach](https://scratcher.io/fi/help/integrations/bloomreach)
- [Yhdistä Iterable](https://scratcher.io/fi/help/integrations/iterable)
- [Yhdistä Mapp](https://scratcher.io/fi/help/integrations/mapp)
- [Yhdistä Agillic](https://scratcher.io/fi/help/integrations/agillic)
- [Yhdistä Ortto](https://scratcher.io/fi/help/integrations/ortto)
- [Yhdistä Emarketeer](https://scratcher.io/fi/help/integrations/emarketeer)
- [Yhdistä Shopify](https://scratcher.io/fi/help/integrations/shopify)
- [Yhdistä Hello Retail](https://scratcher.io/fi/help/integrations/hello-retail)
- [Yhdistä yli 8 000 sovellusta Zapierilla](https://scratcher.io/fi/help/integrations/zapier)
- [Yhdistä monday.com Zapierilla](https://scratcher.io/fi/help/integrations/monday-com)
- [Yhdistä Asana Zapierilla](https://scratcher.io/fi/help/integrations/asana)
- [Yhdistä Podio Zapierilla](https://scratcher.io/fi/help/integrations/podio)
- [Yhdistä Intercom Zapierilla](https://scratcher.io/fi/help/integrations/intercom)

Opi lisää

## Aiheeseen liittyvät artikkelit

- [Miten integraatiot toimivat](https://scratcher.io/fi/help/integrations/how-integrations-work): Yhdistä sähköpostityökalusi tai CRM:si kerran, ota se käyttöön jokaisessa kampanjassa, valitse lista, määritä kentät ja lähetä vain suostumuksen antaneet.
- [Tarkista toimituksen tila ja lähetä liidit uudelleen](https://scratcher.io/fi/help/integrations/delivery-status): Näe, mitkä liidit lähetettiin työkaluihisi, ymmärrä virheilmoitukset, korjaa ongelma ja lähetä liidit uudelleen.
- [Pyydä suostumus ja lisää osallistumisehdot](https://scratcher.io/fi/help/forms/consent-and-permissions): Lisää uutiskirjeiden suostumusvalintaruudut, linkitä ehtosi, valitse mikä valintaruutu tilaa ihmiset ja lähetä sähköpostityökaluusi vain ne, jotka vastasivat kyllä.

Tarvitsetko apua?

## Tarvitsetko vielä apua?

Oikeat ihmiset auttavat sinua mielellään. Jos käytät jo Scratcheria, nopein tapa on alustan sisäinen chat.

- **[Chattaa kanssamme](https://platform.scratcher.io/fi/login)**

    Kirjaudu sisään ja klikkaa chat-painiketta oikeassa alakulmassa. Rex vastaa heti, ja tiimimme on vain yhden klikkauksen päässä.
- **[Varaa tapaaminen](https://scratcher.io/fi/book-a-meeting)**

    Maksuton 30 minuutin videopuhelu tiimimme kanssa: esittely, kampanjaideoita tai apua käyttöönottoon.
- **[Lähetä meille sähköpostia](mailto:contact@scratcher.io)**

    Kirjoita osoitteeseen contact@scratcher.io, niin palaamme asiaan.
