Apsis One 통합을 사용하면 가입한 모든 사람이 선택한 섹션에 Apsis One 프로필로 생성되거나 업데이트되며, Apsis One 구독 중 하나에 수신 동의 처리될 수 있습니다.
준비 사항
- Apsis One 계정과 API 키를 관리할 수 있는 사용자(보통 관리자).
- Apsis One 계정이 Europe 리전인지 Asia 리전인지 확인해 두세요. 대부분의 계정은 Europe 리전에 있습니다.
1단계: Apsis One에서 API 키 만들기
- Apsis One에서 Account settings를 열고 (통합 아래의) API keys로 이동합니다.
- 새 API 키를 만듭니다. 알아보기 쉬운 이름(예: “Scratcher”)을 지정하세요.
- Scratcher가 프로필을 보낼 섹션에 대해 아래 권한으로 키의 액세스를 허용합니다.
- 저장한 다음 Client ID와 Client secret을 복사합니다. Secret은 한 번만 표시됩니다.
Apsis에서도 이에 대한 단계별 가이드를 제공합니다. Scratcher 설치 대화 상자의 설정 가이드에 링크되어 있습니다(“통합을 설치하려면 여기의 가이드를 따르세요”).
키에 필요한 권한
Scratcher는 이 키로 다음 작업을 합니다.
- 캠페인에서 선택할 수 있도록 섹션과 그 안의 속성, 구독(동의 주제), 이벤트를 읽습니다.
- 프로필을 생성하고 속성을 업데이트합니다.
- 프로필에 동의(수신 동의)를 추가합니다.
- 프로필에 이벤트를 추가합니다.
따라서 키에는 섹션에 대한 읽기 권한과, 사용하는 섹션의 프로필·동의·이벤트에 대한 쓰기 권한이 필요합니다. 쓰기 권한이 없으면 Apsis One의 오류 메시지와 함께 전송이 실패합니다.
2단계: Apsis One을 Scratcher에 연결하기
- Scratcher에서 설정 > 통합으로 이동해 Apsis One을 클릭합니다.
- API 리전을 선택합니다. Europe 또는 Asia 중에서 고르세요.
- Client ID와 Client secret을 붙여 넣습니다.
- 통합 설치를 클릭합니다. Scratcher가 Apsis One에 로그인해 정보를 확인합니다.
3단계: 캠페인에서 켜기
- 편집기에서 연결 > 통합 > Apsis One으로 이동해 활성화를 클릭합니다.
- Apsis One 계정을 두 개 이상 연결했다면 계정 선택에서 계정을 고릅니다.
- Apsis 섹션에서 섹션을 선택합니다(섹션 선택).
- 필드 매핑에서 필드마다 필드 매핑 추가를 클릭하고 Scratcher 필드를 대상 필드의 Apsis One 속성과 연결합니다. 목록에는 직접 만든 속성을 포함해 선택한 섹션의 속성이 표시됩니다.
- **구독(동의)**에서 사람들을 수신 동의 처리할 구독을 선택하거나 없음을 선택합니다. “참여자를 수신 동의 처리할 구독을 선택하세요.”
- **권한으로 필터링(선택 사항)**에서 마케팅 동의 체크박스를 선택하면 체크한 사람만 전송됩니다.
- 저장을 클릭한 다음 테스트를 클릭해 테스트 프로필을 보냅니다.
필드 매핑
- 이메일 주소는 항상 전송되며 프로필을 식별하는 데 사용됩니다. 따로 매핑할 필요가 없습니다.
- 전화번호는 형식 설정으로 속성이 요구하는 형태에 맞춰 보낼 수 있습니다.
- 예/아니요 속성에는 true 또는 false가 전송되므로, 동의의 동의함 필드는 예/아니요 속성에 매핑하세요.
동의
구독을 선택하면 각 사람은 “Subscribed via”와 캠페인 이름을 사유로, “Scratcher”를 출처로 하여 해당 구독에 수신 동의 처리됩니다. 이미 수신 동의한 사람이라면 아무것도 바뀌지 않습니다. 권한으로 필터링을 사용하면 마케팅 체크박스에 체크한 사람만 수신 동의 처리됩니다.
섹션에 Apsis One의 동의 양식 이벤트가 있다면, Scratcher는 가입 내역도 캠페인 주소와 함께 프로필에 이벤트로 기록합니다.
전송 내용 및 시점
신규 가입자는 1~2분 안에 전송됩니다. 통합을 활성화하면 캠페인의 기존 리드도 함께 전송됩니다. 누군가 다시 참여하면 프로필이 업데이트됩니다. 모든 전송 내역은 설정 > 통합 > 전송 상태에서 확인할 수 있으며, 프로필이 새로 생성되었는지 기존 프로필인지도 표시됩니다. 전송 상태 확인 및 리드 재전송을 참고하세요.
문제 해결
- 설치 시 “All or some of the fields are invalid...”: 리전을 확인하고 Client ID와 Secret을 다시 복사하세요.
- Apsis One의 액세스 오류로 전송이 실패하는 경우: 키에 해당 섹션에 대한 액세스 권한이 없거나 쓰기 권한이 없습니다. Apsis One에서 키를 편집하세요.
- **구독(동의)**이 비어 있는 경우: 섹션에 아직 구독이 없습니다. Apsis One에서 구독을 만든 뒤 통합을 다시 여세요.