Agillic 통합을 사용하면 가입한 모든 사람이 Agillic에 수신자로 생성되거나 업데이트됩니다. 여기서는 Agillic 목록을 사용하지 않습니다. 수신자는 Agillic 데이터에 추가되며, 타깃 그룹은 Agillic에서 구성합니다.
준비 사항
- Agillic 유럽 플랫폼의 Agillic 계정과 API 키를 만들 수 있는 사용자(보통 관리자).
1단계: Agillic에서 API 키 만들기
- Agillic에서 Settings를 열고 API 키(API credentials)를 찾습니다.
- 새 키를 만들고 알아보기 쉬운 이름(예: “Scratcher”)을 지정합니다.
- Developer key(API key라고도 함)와 Secret을 복사합니다. Secret은 한 번만 표시됩니다.
키에 필요한 권한
Scratcher는 이 키로 개인 데이터 필드를 읽고, 이메일로 수신자를 찾고, 수신자를 생성 및 업데이트합니다. Agillic에서 키의 권한을 제한할 수 있다면 수신자에 대한 읽기·쓰기 권한과 개인 데이터에 대한 읽기 권한이 필요합니다. 그 외의 권한은 필요하지 않습니다.
2단계: Agillic을 Scratcher에 연결하기
- Scratcher에서 설정 > 통합으로 이동해 Agillic을 클릭합니다.
- 개발자 키와 Secret을 붙여 넣습니다.
- 통합 설치를 클릭합니다. Scratcher가 Agillic에 로그인해 정보를 확인합니다.
3단계: 캠페인에서 켜기
- 편집기에서 연결 > 통합 > Agillic으로 이동해 활성화를 클릭합니다.
- 계정을 두 개 이상 연결했다면 계정 선택에서 계정을 고릅니다.
- 필드 매핑에서 각 Scratcher 필드를 Agillic 개인 데이터 필드와 연결합니다.
- 고유 이메일 필드에서 이메일에 사용하는 Agillic 필드를 선택합니다. “Agillic에서 이메일에 사용하는 필드를 선택하세요(Agillic에서도 고유한 필드여야 합니다)”. 고유한 텍스트 필드만 목록에 표시됩니다. 비워 두면 Scratcher는 EMAIL 필드를 사용합니다.
- **권한으로 필터링(선택 사항)**에서 마케팅 동의 체크박스를 선택하면 동의한 사람만 전송됩니다.
- 저장을 클릭한 다음 테스트를 클릭합니다.
참고: Agillic에는 선택할 목록이 없으므로 Scratcher는 활성화를 클릭하는 즉시 전송을 시작합니다. 캠페인이 라이브되기 전에 활성화하거나, 바로 설정을 마치세요.
필드 매핑
- 이메일 주소는 항상 고유 이메일 필드로 전송됩니다. 따로 매핑할 필요가 없습니다.
- 필드 목록에는 Agillic 개인 데이터가 유형과 함께 표시됩니다. 날짜는 Agillic 형식(예: 31.12.2025)으로 전송됩니다.
- 수신 동의용 개인 데이터 필드가 있다면 동의의 동의함 필드를 거기에 매핑하세요.
전송 내용 및 시점
Scratcher는 이메일로 수신자를 조회합니다. 수신자가 없으면 새로 생성하고, 있으면 업데이트합니다. 신규 가입자는 1~2분 안에 전송되며, 기존 리드는 통합을 활성화할 때 전송됩니다. 설정 > 통합 > 전송 상태에서 각 리드가 Agillic에 새로 생성되었는지 기존에 있었는지 확인할 수 있습니다.
문제 해결
- “Agillic API request failed with status code ...”: Agillic이 요청을 수락하지 않았습니다. 401 또는 403은 키가 삭제되었거나 권한이 없다는 뜻입니다. 새 키를 연결하세요.
- 필드에 관한 Agillic 메시지: 값이 필드 유형에 맞지 않거나 필수 필드가 빠져 있습니다. 매핑을 확인하세요.