---
title: "Połącz Bloomreach"
description: "Utwórz klucz API w Bloomreach Engagement, połącz go i twórz lub aktualizuj klientów wraz z ich zgodami."
url: https://scratcher.io/pl/help/integrations/bloomreach
language: pl
---

1. [Centrum pomocy](https://scratcher.io/pl/help)
2. [Integracje](https://scratcher.io/pl/help/integrations)
3. Połącz Bloomreach

# Połącz Bloomreach

Utwórz klucz API w Bloomreach Engagement, połącz go i twórz lub aktualizuj klientów wraz z ich zgodami.

Dzięki integracji z Bloomreach każda osoba, która się zapisze, zostaje utworzona lub zaktualizowana jako klient w twoim projekcie Bloomreach Engagement, rozpoznawany po adresie e-mail. Możesz też nadać jej zgodę w Bloomreach, żeby móc wysyłać do niej treści marketingowe.

## Czego potrzebujesz

- Projektu Bloomreach Engagement i użytkownika, który może zarządzać dostępem do API w ustawieniach projektu (zwykle administratora projektu).

## Krok 1: Utwórz klucz API w Bloomreach

1. W Bloomreach Engagement otwórz projekt i przejdź do **Project settings** > **Access management** > **API**.
2. Skopiuj **Project token** i **API base URL** widoczne na stronie.
3. W sekcji grup API utwórz nową grupę z **Private access** i nazwij ją np. „Scratcher”.
4. Utwórz w grupie nowy klucz API. Skopiuj **API key ID** i **API secret**. Sekret jest pokazywany tylko raz.
5. Nadaj grupie poniższe uprawnienia i zapisz.

## Uprawnienia, których potrzebuje klucz

W uprawnieniach grupy zezwól na:

- **Customer properties**: get i set, aby wyszukiwać klientów, tworzyć ich lub aktualizować oraz pokazywać właściwości klientów w mapowaniu pól.
- **Events**: set, dla zdarzenia `consent`, żeby Scratcher mógł zapisywać zgody.

Nic więcej nie jest potrzebne. Bez uprawnień set dostarczenia kończą się błędem dostępu z Bloomreach.

## Krok 2: Połącz Bloomreach ze Scratcherem

1. W Scratcherze przejdź do **Ustawienia** > **Integracje** i kliknij **Bloomreach**.
2. Wklej API base URL, token projektu, API key ID i API secret w odpowiednie pola.
3. Kliknij **Zainstaluj integrację**. Scratcher sprawdza dane w Bloomreach.

## Krok 3: Włącz integrację w kampanii

1. W edytorze przejdź do **Połącz** > **Integracje** > **Bloomreach** i kliknij **Aktywuj**.
2. Jeśli masz połączonych kilka projektów, wybierz właściwy w polu **Wybierz konto**.
3. W sekcji **Mapowanie pól** kliknij **Dodaj mapowanie pól** i dopasuj każde **Pole Scratcher** do właściwości klienta w Bloomreach, np. „Lead - Imię” do **first\_name**.
4. Wybierz kategorię zgody, którą mają otrzymać osoby, np. „newsletter”, albo żadną.
5. W polu **Filtruj według zgód (opcjonalnie)** wybierz swoje pole wyboru zgody marketingowej, żeby wysyłane były tylko osoby, które je zaznaczyły.
6. Kliknij **Zapisz**, a potem **Testuj**.

> Dobrze wiedzieć: Bloomreach nie ma list. Wszyscy trafiają do projektu, a grupujesz ich za pomocą segmentów w Bloomreach. Dlatego Scratcher zaczyna wysyłać, gdy tylko klikniesz **Aktywuj**. Aktywuj integrację, zanim kampania wystartuje, albo od razu ją skonfiguruj.

## Mapowanie pól

- Adres e-mail jest zawsze wysyłany i służy do wyszukania klienta. Nie musisz go mapować.
- Lista **Pole docelowe** pokazuje właściwości klientów w twoim projekcie. Jeśli jakiejś brakuje, najpierw utwórz ją w Bloomreach.
- Aby oznaczyć, skąd pochodzą klienci, zmapuj **Użyj wartości niestandardowej**, np. „Gra letnia Scratcher”, na właściwość, której używasz do źródła.

## Zgoda

Jeśli wybierzesz kategorię zgody, Scratcher zapisuje zdarzenie `consent` z akcją accept i nazwą kampanii jako źródłem. Kategoria musi istnieć w Bloomreach (w ustawieniach zgód w **Project settings**). Użyj **Filtruj według zgód**, żeby zgodę otrzymywały tylko osoby, które zaznaczyły twoje pole zgody marketingowej.

## Co jest wysyłane i kiedy

Nowe zapisy są wysyłane w ciągu minuty lub dwóch. Gdy aktywujesz integrację, wysyłane są też istniejące leady kampanii. Gdy ktoś weźmie udział ponownie, klient jest aktualizowany. Każde dostarczenie sprawdzisz w **Ustawienia** > **Integracje** > **Status dostarczenia**. Zobacz [Sprawdź status dostarczenia i wyślij leady ponownie](https://scratcher.io/pl/help/integrations/delivery-status).

## Rozwiązywanie problemów

- „Niektóre lub wszystkie pola są nieprawidłowe...” podczas instalacji: sprawdź API base URL i token projektu, a potem skopiuj ponownie key ID i sekret.
- Dostarczenia kończą się błędem dostępu: grupie API brakuje któregoś z powyższych uprawnień. Edytuj ją w Bloomreach.
- Zgoda nie pojawia się u klienta: kategoria zgody nie istnieje w Bloomreach albo jest inaczej zapisana.
- Bloomreach ma własne przewodniki dotyczące kluczy API. Jeśli menu wyglądają inaczej, wyszukaj w dokumentacji Bloomreach „API access management”.

Integracje

- [Jak działają integracje](https://scratcher.io/pl/help/integrations/how-integrations-work)
- [Wszystkie integracje](https://scratcher.io/pl/help/integrations/other-integrations)
- [Sprawdź status dostarczenia i wyślij leady ponownie](https://scratcher.io/pl/help/integrations/delivery-status)
- [Połącz HubSpot](https://scratcher.io/pl/help/integrations/hubspot)
- [Połącz Salesforce Marketing Cloud](https://scratcher.io/pl/help/integrations/salesforce-marketing-cloud)
- [Połącz Microsoft Dynamics 365 przez Zapier](https://scratcher.io/pl/help/integrations/microsoft-dynamics-365)
- [Połącz Emarsys](https://scratcher.io/pl/help/integrations/emarsys)
- [Połącz Klaviyo](https://scratcher.io/pl/help/integrations/klaviyo)
- [Połącz Mailchimp](https://scratcher.io/pl/help/integrations/mailchimp)
- [Połącz ActiveCampaign](https://scratcher.io/pl/help/integrations/activecampaign)
- [Połącz Apsis One](https://scratcher.io/pl/help/integrations/apsis-one)
- [Połącz Drip](https://scratcher.io/pl/help/integrations/drip)
- [Połącz HeyLoyalty](https://scratcher.io/pl/help/integrations/heyloyalty)
- [Połącz Peytz](https://scratcher.io/pl/help/integrations/peytz)
- [Połącz Marketingplatform](https://scratcher.io/pl/help/integrations/marketingplatform)
- [Połącz Campaign Monitor przez Zapier](https://scratcher.io/pl/help/integrations/campaign-monitor)
- [Połącz ActiveTrail przez Zapier](https://scratcher.io/pl/help/integrations/activetrail)
- [Połącz Bloomreach](https://scratcher.io/pl/help/integrations/bloomreach)
- [Połącz Iterable](https://scratcher.io/pl/help/integrations/iterable)
- [Połącz Mapp](https://scratcher.io/pl/help/integrations/mapp)
- [Połącz Agillic](https://scratcher.io/pl/help/integrations/agillic)
- [Połącz Ortto](https://scratcher.io/pl/help/integrations/ortto)
- [Połącz Emarketeer](https://scratcher.io/pl/help/integrations/emarketeer)
- [Połącz Shopify](https://scratcher.io/pl/help/integrations/shopify)
- [Połącz Hello Retail](https://scratcher.io/pl/help/integrations/hello-retail)
- [Połącz ponad 8000 aplikacji przez Zapier](https://scratcher.io/pl/help/integrations/zapier)
- [Połącz monday.com przez Zapier](https://scratcher.io/pl/help/integrations/monday-com)
- [Połącz Asanę przez Zapier](https://scratcher.io/pl/help/integrations/asana)
- [Połącz Podio przez Zapier](https://scratcher.io/pl/help/integrations/podio)
- [Połącz Intercom przez Zapier](https://scratcher.io/pl/help/integrations/intercom)

Dowiedz się więcej

## Powiązane artykuły

- [Jak działają integracje](https://scratcher.io/pl/help/integrations/how-integrations-work): Połącz narzędzie e-mailowe lub CRM raz, włącz je w każdej kampanii, wybierz listę, zmapuj pola i wysyłaj tylko osoby, które wyraziły zgodę.
- [Sprawdź status dostarczenia i wyślij leady ponownie](https://scratcher.io/pl/help/integrations/delivery-status): Zobacz, które leady zostały wysłane do twoich narzędzi, zrozum komunikaty o błędach, napraw problem i wyślij je ponownie.
- [Poproś o zgodę i dodaj regulamin](https://scratcher.io/pl/help/forms/consent-and-permissions): Dodaj pola wyboru zgody na newsletter, podlinkuj regulamin i wysyłaj do narzędzia e-mailowego tylko osoby, które się zgodziły.

Potrzebujesz pomocy?

## Nadal potrzebujesz pomocy?

Prawdziwi ludzie chętnie ci pomogą. Jeśli już korzystasz ze Scratchera, najszybciej skontaktujesz się z nami przez czat na platformie.

- **[Czat z nami](https://platform.scratcher.io/pl/login)**

    Zaloguj się i kliknij przycisk czatu w prawym dolnym rogu. Rex odpowie od razu, a nasz zespół jest o jedno kliknięcie dalej.
- **[Umów spotkanie](https://scratcher.io/pl/book-a-meeting)**

    Bezpłatna 30-minutowa rozmowa wideo z naszym zespołem: prezentacja, pomysły na kampanie lub pomoc w konfiguracji.
- **[Napisz do nas](mailto:contact@scratcher.io)**

    Napisz na contact@scratcher.io, a odezwiemy się do ciebie.
