---
title: "Bloomreach 연결하기"
description: "Bloomreach Engagement에서 API 키를 만들어 연결하고, 고객을 동의 정보와 함께 생성하거나 업데이트하세요."
url: https://scratcher.io/ko/help/integrations/bloomreach
language: ko
---

1. [도움말 센터](https://scratcher.io/ko/help)
2. [통합](https://scratcher.io/ko/help/integrations)
3. Bloomreach 연결하기

# Bloomreach 연결하기

Bloomreach Engagement에서 API 키를 만들어 연결하고, 고객을 동의 정보와 함께 생성하거나 업데이트하세요.

Bloomreach 통합을 사용하면 가입한 모든 사람이 이메일 주소로 식별되어 Bloomreach Engagement 프로젝트에 고객으로 생성되거나 업데이트됩니다. 마케팅 메시지를 보낼 수 있도록 Bloomreach 동의를 부여할 수도 있습니다.

## 준비 사항

- Bloomreach Engagement 프로젝트와 프로젝트 설정에서 API 액세스를 관리할 수 있는 사용자(보통 프로젝트 관리자).

## 1단계: Bloomreach에서 API 키 만들기

1. Bloomreach Engagement에서 프로젝트를 열고 **Project settings** > **Access management** > **API**로 이동합니다.
2. 페이지에 표시된 **Project token**과 **API base URL**을 복사합니다.
3. API 그룹에서 **Private access** 그룹을 새로 만들고 이름을 지정합니다(예: “Scratcher”).
4. 그룹에서 새 API 키를 만듭니다. **API key ID**와 **API secret**을 복사하세요. Secret은 한 번만 표시됩니다.
5. 그룹에 아래 권한을 부여하고 저장합니다.

## 키에 필요한 권한

그룹 권한에서 다음을 허용하세요.

- **Customer properties**: get 및 set. 고객을 찾고 생성하거나 업데이트하며, 필드 매핑에 고객 속성을 표시하는 데 필요합니다.
- **Events**: `consent` 이벤트에 대한 set. Scratcher가 동의를 기록하는 데 필요합니다.

그 외에는 필요하지 않습니다. set 권한이 없으면 Bloomreach의 액세스 오류와 함께 전송이 실패합니다.

## 2단계: Bloomreach를 Scratcher에 연결하기

1. Scratcher에서 **설정** > **통합**으로 이동해 **Bloomreach**를 클릭합니다.
2. API base URL, Project token, API key ID, API secret을 해당 필드에 붙여 넣습니다.
3. **통합 설치**를 클릭합니다. Scratcher가 Bloomreach에서 정보를 확인합니다.

## 3단계: 캠페인에서 켜기

1. 편집기에서 **연결** > **통합** > **Bloomreach**로 이동해 **활성화**를 클릭합니다.
2. 프로젝트를 두 개 이상 연결했다면 **계정 선택**에서 프로젝트를 고릅니다.
3. **필드 매핑**에서 **필드 매핑 추가**를 클릭하고 각 **Scratcher 필드**를 Bloomreach 고객 속성과 연결합니다(예: “리드 - 이름”을 **first\_name**에).
4. 사람들에게 부여할 동의 카테고리(예: “newsletter”)를 선택하거나 선택하지 않습니다.
5. \*\*권한으로 필터링(선택 사항)\*\*에서 마케팅 동의 체크박스를 선택하면 체크한 사람만 전송됩니다.
6. **저장**을 클릭한 다음 **테스트**를 클릭합니다.

> 참고: Bloomreach에는 목록이 없습니다. 모든 사람이 프로젝트에 들어가며, Bloomreach에서 세그먼트로 그룹을 나눕니다. 따라서 Scratcher는 **활성화**를 클릭하는 즉시 전송을 시작합니다. 캠페인이 라이브되기 전에 활성화하거나, 바로 설정을 마치세요.

## 필드 매핑

- 이메일 주소는 항상 전송되며 고객을 찾는 데 사용됩니다. 따로 매핑할 필요가 없습니다.
- **대상 필드** 목록에는 프로젝트의 고객 속성이 표시됩니다. 필요한 속성이 없다면 Bloomreach에서 먼저 만드세요.
- 고객의 유입 경로를 표시하려면 “Scratcher 여름 게임” 같은 **사용자 정의 값 사용**을 출처용 속성에 매핑하세요.

## 동의

동의 카테고리를 선택하면 Scratcher는 action을 accept로, 출처를 캠페인 이름으로 하는 `consent` 이벤트를 기록합니다. 해당 카테고리는 Bloomreach에 있어야 합니다(**Project settings**의 동의 설정). **권한으로 필터링**을 사용하면 마케팅 체크박스에 체크한 사람만 동의를 받습니다.

## 전송 내용 및 시점

신규 가입자는 1~2분 안에 전송됩니다. 통합을 활성화하면 캠페인의 기존 리드도 함께 전송됩니다. 누군가 다시 참여하면 고객 정보가 업데이트됩니다. 모든 전송 내역은 **설정** > **통합** > **전송 상태**에서 확인하세요. [전송 상태 확인 및 리드 재전송](https://scratcher.io/ko/help/integrations/delivery-status)을 참고하세요.

## 문제 해결

- 설치 시 “All or some of the fields are invalid...”: API base URL과 Project token을 확인하고 API key ID와 Secret을 다시 복사하세요.
- 액세스 오류로 전송이 실패하는 경우: API 그룹에 위의 권한 중 하나가 빠져 있습니다. Bloomreach에서 그룹을 편집하세요.
- 고객에게 동의가 표시되지 않는 경우: 동의 카테고리가 Bloomreach에 없거나 철자가 다릅니다.
- Bloomreach는 API 키에 관한 자체 가이드를 제공합니다. 메뉴가 다르게 보인다면 Bloomreach 문서에서 “API access management”를 검색하세요.

통합

- [통합의 작동 방식](https://scratcher.io/ko/help/integrations/how-integrations-work)
- [모든 통합](https://scratcher.io/ko/help/integrations/other-integrations)
- [전송 상태 확인 및 리드 재전송](https://scratcher.io/ko/help/integrations/delivery-status)
- [HubSpot 연결하기](https://scratcher.io/ko/help/integrations/hubspot)
- [Salesforce Marketing Cloud 연결하기](https://scratcher.io/ko/help/integrations/salesforce-marketing-cloud)
- [Zapier로 Microsoft Dynamics 365 연결하기](https://scratcher.io/ko/help/integrations/microsoft-dynamics-365)
- [Emarsys 연결하기](https://scratcher.io/ko/help/integrations/emarsys)
- [Klaviyo 연결하기](https://scratcher.io/ko/help/integrations/klaviyo)
- [Mailchimp 연결하기](https://scratcher.io/ko/help/integrations/mailchimp)
- [ActiveCampaign 연결하기](https://scratcher.io/ko/help/integrations/activecampaign)
- [Apsis One 연결하기](https://scratcher.io/ko/help/integrations/apsis-one)
- [Drip 연결하기](https://scratcher.io/ko/help/integrations/drip)
- [HeyLoyalty 연결하기](https://scratcher.io/ko/help/integrations/heyloyalty)
- [Peytz 연결하기](https://scratcher.io/ko/help/integrations/peytz)
- [Marketingplatform 연결하기](https://scratcher.io/ko/help/integrations/marketingplatform)
- [Zapier로 Campaign Monitor 연결하기](https://scratcher.io/ko/help/integrations/campaign-monitor)
- [Zapier로 ActiveTrail 연결하기](https://scratcher.io/ko/help/integrations/activetrail)
- [Bloomreach 연결하기](https://scratcher.io/ko/help/integrations/bloomreach)
- [Iterable 연결하기](https://scratcher.io/ko/help/integrations/iterable)
- [Mapp 연결하기](https://scratcher.io/ko/help/integrations/mapp)
- [Agillic 연결하기](https://scratcher.io/ko/help/integrations/agillic)
- [Ortto 연결하기](https://scratcher.io/ko/help/integrations/ortto)
- [Emarketeer 연결하기](https://scratcher.io/ko/help/integrations/emarketeer)
- [Shopify 연결하기](https://scratcher.io/ko/help/integrations/shopify)
- [Hello Retail 연결하기](https://scratcher.io/ko/help/integrations/hello-retail)
- [Zapier로 8,000개 이상의 앱 연결하기](https://scratcher.io/ko/help/integrations/zapier)
- [Zapier로 monday.com 연결하기](https://scratcher.io/ko/help/integrations/monday-com)
- [Zapier로 Asana 연결하기](https://scratcher.io/ko/help/integrations/asana)
- [Zapier로 Podio 연결하기](https://scratcher.io/ko/help/integrations/podio)
- [Zapier로 Intercom 연결하기](https://scratcher.io/ko/help/integrations/intercom)

더 알아보기

## 관련 글

- [통합의 작동 방식](https://scratcher.io/ko/help/integrations/how-integrations-work): 이메일 도구나 CRM을 한 번 연결하고, 캠페인마다 켜고, 목록을 선택하고, 필드를 매핑하고, 동의한 사람만 보내세요.
- [전송 상태 확인 및 리드 재전송](https://scratcher.io/ko/help/integrations/delivery-status): 어떤 리드가 도구로 전송되었는지 확인하고, 오류 메시지를 이해하고, 문제를 해결한 뒤 다시 보내세요.
- [동의 요청 및 이용 약관 추가하기](https://scratcher.io/ko/help/forms/consent-and-permissions): 뉴스레터 동의 체크박스를 추가하고, 약관을 연결하고, 구독 처리할 체크박스를 고르고, 동의한 사람만 이메일 도구로 보내세요.

도움이 필요하신가요?

## 아직 도움이 필요하신가요?

실제 담당자가 도와드립니다. 이미 Scratcher를 사용 중이라면 플랫폼 안의 채팅이 가장 빠릅니다.

- **[채팅 문의](https://platform.scratcher.io/ko/login)**

    로그인한 뒤 오른쪽 아래의 채팅 버튼을 클릭하세요. Rex가 바로 답하고, 팀과도 클릭 한 번으로 연결됩니다.
- **[미팅 예약](https://scratcher.io/ko/book-a-meeting)**

    팀과의 무료 30분 화상 통화: 둘러보기, 캠페인 아이디어, 설정 지원.
- **[이메일 문의](mailto:contact@scratcher.io)**

    contact@scratcher.io로 연락 주시면 답변드리겠습니다.
