Bloomreach 통합을 사용하면 가입한 모든 사람이 이메일 주소로 식별되어 Bloomreach Engagement 프로젝트에 고객으로 생성되거나 업데이트됩니다. 마케팅 메시지를 보낼 수 있도록 Bloomreach 동의를 부여할 수도 있습니다.
준비 사항
- Bloomreach Engagement 프로젝트와 프로젝트 설정에서 API 액세스를 관리할 수 있는 사용자(보통 프로젝트 관리자).
1단계: Bloomreach에서 API 키 만들기
- Bloomreach Engagement에서 프로젝트를 열고 Project settings > Access management > API로 이동합니다.
- 페이지에 표시된 Project token과 API base URL을 복사합니다.
- API 그룹에서 Private access 그룹을 새로 만들고 이름을 지정합니다(예: “Scratcher”).
- 그룹에서 새 API 키를 만듭니다. API key ID와 API secret을 복사하세요. Secret은 한 번만 표시됩니다.
- 그룹에 아래 권한을 부여하고 저장합니다.
키에 필요한 권한
그룹 권한에서 다음을 허용하세요.
- Customer properties: get 및 set. 고객을 찾고 생성하거나 업데이트하며, 필드 매핑에 고객 속성을 표시하는 데 필요합니다.
- Events:
consent이벤트에 대한 set. Scratcher가 동의를 기록하는 데 필요합니다.
그 외에는 필요하지 않습니다. set 권한이 없으면 Bloomreach의 액세스 오류와 함께 전송이 실패합니다.
2단계: Bloomreach를 Scratcher에 연결하기
- Scratcher에서 설정 > 통합으로 이동해 Bloomreach를 클릭합니다.
- API base URL, Project token, API key ID, API secret을 해당 필드에 붙여 넣습니다.
- 통합 설치를 클릭합니다. Scratcher가 Bloomreach에서 정보를 확인합니다.
3단계: 캠페인에서 켜기
- 편집기에서 연결 > 통합 > Bloomreach로 이동해 활성화를 클릭합니다.
- 프로젝트를 두 개 이상 연결했다면 계정 선택에서 프로젝트를 고릅니다.
- 필드 매핑에서 필드 매핑 추가를 클릭하고 각 Scratcher 필드를 Bloomreach 고객 속성과 연결합니다(예: “리드 - 이름”을 first_name에).
- 사람들에게 부여할 동의 카테고리(예: “newsletter”)를 선택하거나 선택하지 않습니다.
- **권한으로 필터링(선택 사항)**에서 마케팅 동의 체크박스를 선택하면 체크한 사람만 전송됩니다.
- 저장을 클릭한 다음 테스트를 클릭합니다.
참고: Bloomreach에는 목록이 없습니다. 모든 사람이 프로젝트에 들어가며, Bloomreach에서 세그먼트로 그룹을 나눕니다. 따라서 Scratcher는 활성화를 클릭하는 즉시 전송을 시작합니다. 캠페인이 라이브되기 전에 활성화하거나, 바로 설정을 마치세요.
필드 매핑
- 이메일 주소는 항상 전송되며 고객을 찾는 데 사용됩니다. 따로 매핑할 필요가 없습니다.
- 대상 필드 목록에는 프로젝트의 고객 속성이 표시됩니다. 필요한 속성이 없다면 Bloomreach에서 먼저 만드세요.
- 고객의 유입 경로를 표시하려면 “Scratcher 여름 게임” 같은 사용자 정의 값 사용을 출처용 속성에 매핑하세요.
동의
동의 카테고리를 선택하면 Scratcher는 action을 accept로, 출처를 캠페인 이름으로 하는 consent 이벤트를 기록합니다. 해당 카테고리는 Bloomreach에 있어야 합니다(Project settings의 동의 설정). 권한으로 필터링을 사용하면 마케팅 체크박스에 체크한 사람만 동의를 받습니다.
전송 내용 및 시점
신규 가입자는 1~2분 안에 전송됩니다. 통합을 활성화하면 캠페인의 기존 리드도 함께 전송됩니다. 누군가 다시 참여하면 고객 정보가 업데이트됩니다. 모든 전송 내역은 설정 > 통합 > 전송 상태에서 확인하세요. 전송 상태 확인 및 리드 재전송을 참고하세요.
문제 해결
- 설치 시 “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”를 검색하세요.