Iterable 통합을 사용하면 가입한 모든 사람이 이메일 주소로 식별되는 Iterable 사용자로 생성되거나 업데이트되고, 선택한 Iterable 목록에 구독됩니다.
준비 사항
- 이메일을 사용자 식별자로 사용하는 Iterable 프로젝트와 API 키를 관리할 권한이 있는 사용자(보통 조직 관리자 또는 프로젝트 관리자).
- Iterable 프로젝트가 미국(US) 데이터 센터에 있는지 EU 데이터 센터에 있는지에 대한 정보.
1단계: Iterable에서 API 키 만들기
- Iterable에서 Integrations > API Keys로 이동합니다.
- New API Key를 클릭합니다.
- 이름(예: “Scratcher”)을 입력하고 유형으로 Standard(서버 측)를 선택합니다.
- 키를 생성하고 복사합니다. Iterable은 전체 키를 한 번만 보여 줍니다.
키의 용도
Standard(서버 측) 키로 Scratcher에 필요한 작업을 모두 할 수 있습니다.
- 목록과 사용자 필드를 읽어 캠페인에서 선택할 수 있게 합니다.
- 사용자를 생성하고 업데이트합니다.
- 사용자를 목록에 구독시킵니다.
JavaScript 키, 모바일 키, 읽기 전용 키는 사용하지 마세요. 이런 키로는 서버에서 사용자를 추가할 수 없습니다.
2단계: Iterable을 Scratcher에 연결하기
- Scratcher에서 설정 > 통합으로 이동해 Iterable을 클릭합니다.
- 데이터 센터(US 또는 EU)를 선택하고 API 키를 붙여 넣습니다.
- 통합 설치를 클릭합니다. Scratcher가 목록을 읽을 수 있는지 확인합니다.
3단계: 캠페인에서 켜기
- 편집기에서 연결 > 통합 > Iterable로 이동해 활성화를 클릭합니다.
- 프로젝트를 둘 이상 연결했다면 계정 선택에서 프로젝트를 고릅니다.
- 외부 목록에서 Iterable 목록을 선택합니다. 정적 목록만 선택할 수 있습니다.
- 필드 매핑에서 필드 매핑 추가를 클릭하고 각 Scratcher 필드를 Iterable 사용자 필드와 연결합니다. 예: “리드 - 이름”을 firstName에 연결.
- **권한으로 필터링(선택 사항)**에서 마케팅 동의 체크박스를 선택합니다.
- 저장을 클릭한 다음 테스트를 클릭합니다.
필드 매핑
- 이메일 주소는 항상 전송되며 사용자를 식별하는 데 쓰입니다. 따로 매핑할 필요가 없습니다.
- 대상 필드 목록에는 프로젝트의 사용자 필드가 표시됩니다. 아직 없는 필드라면 올바른 유형으로 만들어지도록 먼저 Iterable에서 생성하세요.
- 전화번호는 형식에서 +와 국가 코드가 포함된 형식을 사용하세요. Iterable은 SMS에 이 형식을 요구합니다.
동의
목록에 포함되었다고 해서 메시지 유형에 자동으로 구독되는 것은 아닙니다. Iterable은 이를 위해 자체 구독 설정을 사용합니다. **권한으로 필터링(선택 사항)**에서 마케팅 체크박스를 선택해 동의한 사람만 전송하세요. 동의 항목의 수락과 날짜 필드를 사용자 필드에 매핑하면 Iterable에 동의 증빙을 남길 수도 있습니다.
전송 대상과 시점
새 가입자는 1~2분 안에 전송되며, 캠페인의 기존 리드는 통합을 활성화할 때 전송됩니다. 같은 사람이 다시 참여하면 사용자 정보가 업데이트됩니다. Iterable에서 이 목록을 여정(journey)의 시작점으로 사용해 환영 메시지를 보내 보세요. 모든 전송 내역은 설정 > 통합 > 전송 상태에서 확인할 수 있습니다.
문제 해결
- 설치할 때 “All or some of the fields are invalid...”가 표시되는 경우: 키가 잘못되었거나 Standard 키가 아니거나, 데이터 센터를 잘못 선택한 것입니다.
- 필드가 거부되는 경우: 값이 Iterable 사용자 필드의 유형과 맞지 않습니다. 예를 들어 날짜 필드에 텍스트가 들어간 경우입니다. 매핑을 확인하세요.
- 목록이 보이지 않는 경우: 동적 목록에는 사용자를 추가할 수 없습니다. Iterable에서 정적 목록을 만드세요.