Mapp 통합을 사용하면 가입한 모든 사람이 Mapp Engage 연락처로 생성되거나 업데이트되고, 선택한 그룹(목록)에 추가됩니다.
준비 사항
- Mapp Engage 계정과 시스템 사용자를 만들 수 있는 사용자(보통 관리자).
- Mapp Engage API 주소. Mapp Engage 시스템 주소에 API 경로를 붙인 것으로, 사용 중인 시스템의 Mapp API 문서에서 찾거나 Mapp 지원팀에 문의해 확인할 수 있습니다.
1단계: Mapp Engage에서 API 사용자 만들기
Mapp Engage는 API용으로 사용자 이름과 비밀번호가 있는 별도의 사용자를 사용합니다.
- Mapp Engage에서 Administration > System Users로 이동합니다.
- 새 시스템 사용자를 만들고 이름을 지정합니다. 예: “Scratcher”
- 아래 권한과 함께 사용자에게 API 역할(API 액세스)을 부여합니다.
- 강력한 비밀번호를 설정하고 저장합니다. 사용자 이름과 비밀번호를 복사합니다.
API 사용자에게 필요한 권한
Scratcher는 이 사용자로 다음 작업을 합니다.
- 그룹을 읽어 캠페인에서 선택할 수 있게 합니다.
- 연락처 속성을 읽어 필드를 매핑할 수 있게 합니다.
- 연락처를 생성하고 업데이트합니다.
- 연락처를 그룹에 추가(구독)합니다.
메시지, 보고서 등 그 밖의 항목에 대한 액세스는 필요하지 않습니다.
2단계: Mapp을 Scratcher에 연결하기
- Scratcher에서 설정 > 통합으로 이동해 Mapp을 클릭합니다.
- 해당 필드에 API 주소, 사용자 이름, 비밀번호를 붙여 넣습니다.
- 통합 설치를 클릭합니다. Scratcher가 그룹을 읽을 수 있는지 확인합니다.
3단계: 캠페인에서 켜기
- 편집기에서 연결 > 통합 > Mapp으로 이동해 활성화를 클릭합니다.
- 계정을 둘 이상 연결했다면 계정 선택에서 계정을 고릅니다.
- 외부 목록에서 Mapp 그룹을 선택합니다.
- 필드 매핑에서 필드 매핑 추가를 클릭하고 각 Scratcher 필드를 Mapp 속성과 연결합니다. 예: “리드 - 이름”을 FirstName에 연결.
- **권한으로 필터링(선택 사항)**에서 마케팅 동의 체크박스를 선택합니다.
- 저장을 클릭한 다음 테스트를 클릭합니다.
필드 매핑
- 이메일 주소는 항상 전송되며 연락처를 식별하는 데 쓰입니다. 따로 매핑할 필요가 없습니다.
- 대상 필드 목록에는 Mapp 시스템의 기본 속성과 맞춤 속성이 표시됩니다. 맞춤 속성은 먼저 Mapp에서 만드세요.
- 휴대폰 번호는 형식 설정을 사용하세요. Mapp은 보통 +와 국가 코드를 요구합니다.
동의
연락처는 선택한 그룹에 구독됩니다. 그룹이 Mapp에서 이중 수신 동의를 사용한다면 Mapp이 자체 확인 이메일을 보내며, 확인한 사람만 구독됩니다. 마케팅 체크박스에 체크한 사람만 추가되도록 권한으로 필터링을 사용하세요.
전송 대상과 시점
새 가입자는 1~2분 안에 전송됩니다. 통합을 활성화하면 캠페인의 기존 리드도 함께 전송됩니다. 같은 사람이 다시 참여하면 연락처가 업데이트됩니다. 모든 전송 내역은 설정 > 통합 > 전송 상태에서 확인하세요.
문제 해결
- 설치할 때 “All or some of the fields are invalid...”가 표시되는 경우: API 주소를 확인하고, 시스템 사용자에게 API 역할이 있으며 잠겨 있지 않은지 확인하세요.
- 액세스 오류로 전송이 실패하는 경우: 시스템 사용자에게 위 권한 중 하나가 없습니다.
- 비밀번호가 만료된 경우: 일부 Mapp 시스템은 비밀번호에 만료 기간이 있습니다. Mapp에서 새 비밀번호를 설정하고 새 계정 추가로 다시 연결하세요.