---
title: "Iterable 연결하기"
description: "Iterable에서 서버 측 API 키를 만들어 연결하고, 새 가입자를 Iterable 목록에 사용자로 추가하세요."
url: https://scratcher.io/ko/help/integrations/iterable
language: ko
---

1. [도움말 센터](https://scratcher.io/ko/help)
2. [통합](https://scratcher.io/ko/help/integrations)
3. Iterable 연결하기

# Iterable 연결하기

Iterable에서 서버 측 API 키를 만들어 연결하고, 새 가입자를 Iterable 목록에 사용자로 추가하세요.

Iterable 통합을 사용하면 가입한 모든 사람이 이메일 주소로 식별되는 Iterable 사용자로 생성되거나 업데이트되고, 선택한 Iterable 목록에 구독됩니다.

## 준비 사항

- 이메일을 사용자 식별자로 사용하는 Iterable 프로젝트와 API 키를 관리할 권한이 있는 사용자(보통 조직 관리자 또는 프로젝트 관리자).
- Iterable 프로젝트가 미국(US) 데이터 센터에 있는지 EU 데이터 센터에 있는지에 대한 정보.

## 1단계: Iterable에서 API 키 만들기

1. Iterable에서 **Integrations** > **API Keys**로 이동합니다.
2. **New API Key**를 클릭합니다.
3. 이름(예: “Scratcher”)을 입력하고 유형으로 **Standard**(서버 측)를 선택합니다.
4. 키를 생성하고 복사합니다. Iterable은 전체 키를 한 번만 보여 줍니다.

## 키의 용도

Standard(서버 측) 키로 Scratcher에 필요한 작업을 모두 할 수 있습니다.

- 목록과 사용자 필드를 읽어 캠페인에서 선택할 수 있게 합니다.
- 사용자를 생성하고 업데이트합니다.
- 사용자를 목록에 구독시킵니다.

JavaScript 키, 모바일 키, 읽기 전용 키는 사용하지 마세요. 이런 키로는 서버에서 사용자를 추가할 수 없습니다.

## 2단계: Iterable을 Scratcher에 연결하기

1. Scratcher에서 **설정** > **통합**으로 이동해 **Iterable**을 클릭합니다.
2. 데이터 센터(US 또는 EU)를 선택하고 API 키를 붙여 넣습니다.
3. **통합 설치**를 클릭합니다. Scratcher가 목록을 읽을 수 있는지 확인합니다.

## 3단계: 캠페인에서 켜기

1. 편집기에서 **연결** > **통합** > **Iterable**로 이동해 **활성화**를 클릭합니다.
2. 프로젝트를 둘 이상 연결했다면 **계정 선택**에서 프로젝트를 고릅니다.
3. **외부 목록**에서 Iterable 목록을 선택합니다. 정적 목록만 선택할 수 있습니다.
4. **필드 매핑**에서 **필드 매핑 추가**를 클릭하고 각 **Scratcher 필드**를 Iterable 사용자 필드와 연결합니다. 예: “리드 - 이름”을 **firstName**에 연결.
5. \*\*권한으로 필터링(선택 사항)\*\*에서 마케팅 동의 체크박스를 선택합니다.
6. **저장**을 클릭한 다음 **테스트**를 클릭합니다.

## 필드 매핑

- 이메일 주소는 항상 전송되며 사용자를 식별하는 데 쓰입니다. 따로 매핑할 필요가 없습니다.
- **대상 필드** 목록에는 프로젝트의 사용자 필드가 표시됩니다. 아직 없는 필드라면 올바른 유형으로 만들어지도록 먼저 Iterable에서 생성하세요.
- 전화번호는 **형식**에서 +와 국가 코드가 포함된 형식을 사용하세요. Iterable은 SMS에 이 형식을 요구합니다.

## 동의

목록에 포함되었다고 해서 메시지 유형에 자동으로 구독되는 것은 아닙니다. Iterable은 이를 위해 자체 구독 설정을 사용합니다. \*\*권한으로 필터링(선택 사항)\*\*에서 마케팅 체크박스를 선택해 동의한 사람만 전송하세요. 동의 항목의 **수락**과 **날짜** 필드를 사용자 필드에 매핑하면 Iterable에 동의 증빙을 남길 수도 있습니다.

## 전송 대상과 시점

새 가입자는 1~2분 안에 전송되며, 캠페인의 기존 리드는 통합을 활성화할 때 전송됩니다. 같은 사람이 다시 참여하면 사용자 정보가 업데이트됩니다. Iterable에서 이 목록을 여정(journey)의 시작점으로 사용해 환영 메시지를 보내 보세요. 모든 전송 내역은 **설정** > **통합** > **전송 상태**에서 확인할 수 있습니다.

## 문제 해결

- 설치할 때 “All or some of the fields are invalid...”가 표시되는 경우: 키가 잘못되었거나 Standard 키가 아니거나, 데이터 센터를 잘못 선택한 것입니다.
- 필드가 거부되는 경우: 값이 Iterable 사용자 필드의 유형과 맞지 않습니다. 예를 들어 날짜 필드에 텍스트가 들어간 경우입니다. 매핑을 확인하세요.
- 목록이 보이지 않는 경우: 동적 목록에는 사용자를 추가할 수 없습니다. Iterable에서 정적 목록을 만드세요.

통합

- [통합의 작동 방식](https://scratcher.io/ko/help/integrations/how-integrations-work)
- [모든 통합](https://scratcher.io/ko/help/integrations/other-integrations)
- [전송 상태 확인 및 리드 재전송](https://scratcher.io/ko/help/integrations/delivery-status)
- [HubSpot 연결하기](https://scratcher.io/ko/help/integrations/hubspot)
- [Salesforce Marketing Cloud 연결하기](https://scratcher.io/ko/help/integrations/salesforce-marketing-cloud)
- [Zapier로 Microsoft Dynamics 365 연결하기](https://scratcher.io/ko/help/integrations/microsoft-dynamics-365)
- [Emarsys 연결하기](https://scratcher.io/ko/help/integrations/emarsys)
- [Klaviyo 연결하기](https://scratcher.io/ko/help/integrations/klaviyo)
- [Mailchimp 연결하기](https://scratcher.io/ko/help/integrations/mailchimp)
- [ActiveCampaign 연결하기](https://scratcher.io/ko/help/integrations/activecampaign)
- [Apsis One 연결하기](https://scratcher.io/ko/help/integrations/apsis-one)
- [Drip 연결하기](https://scratcher.io/ko/help/integrations/drip)
- [HeyLoyalty 연결하기](https://scratcher.io/ko/help/integrations/heyloyalty)
- [Peytz 연결하기](https://scratcher.io/ko/help/integrations/peytz)
- [Marketingplatform 연결하기](https://scratcher.io/ko/help/integrations/marketingplatform)
- [Zapier로 Campaign Monitor 연결하기](https://scratcher.io/ko/help/integrations/campaign-monitor)
- [Zapier로 ActiveTrail 연결하기](https://scratcher.io/ko/help/integrations/activetrail)
- [Bloomreach 연결하기](https://scratcher.io/ko/help/integrations/bloomreach)
- [Iterable 연결하기](https://scratcher.io/ko/help/integrations/iterable)
- [Mapp 연결하기](https://scratcher.io/ko/help/integrations/mapp)
- [Agillic 연결하기](https://scratcher.io/ko/help/integrations/agillic)
- [Ortto 연결하기](https://scratcher.io/ko/help/integrations/ortto)
- [Emarketeer 연결하기](https://scratcher.io/ko/help/integrations/emarketeer)
- [Shopify 연결하기](https://scratcher.io/ko/help/integrations/shopify)
- [Hello Retail 연결하기](https://scratcher.io/ko/help/integrations/hello-retail)
- [Zapier로 8,000개 이상의 앱 연결하기](https://scratcher.io/ko/help/integrations/zapier)
- [Zapier로 monday.com 연결하기](https://scratcher.io/ko/help/integrations/monday-com)
- [Zapier로 Asana 연결하기](https://scratcher.io/ko/help/integrations/asana)
- [Zapier로 Podio 연결하기](https://scratcher.io/ko/help/integrations/podio)
- [Zapier로 Intercom 연결하기](https://scratcher.io/ko/help/integrations/intercom)

더 알아보기

## 관련 글

- [통합의 작동 방식](https://scratcher.io/ko/help/integrations/how-integrations-work): 이메일 도구나 CRM을 한 번 연결하고, 캠페인마다 켜고, 목록을 선택하고, 필드를 매핑하고, 동의한 사람만 보내세요.
- [전송 상태 확인 및 리드 재전송](https://scratcher.io/ko/help/integrations/delivery-status): 어떤 리드가 도구로 전송되었는지 확인하고, 오류 메시지를 이해하고, 문제를 해결한 뒤 다시 보내세요.
- [동의 요청 및 이용 약관 추가하기](https://scratcher.io/ko/help/forms/consent-and-permissions): 뉴스레터 동의 체크박스를 추가하고, 약관을 연결하고, 구독 처리할 체크박스를 고르고, 동의한 사람만 이메일 도구로 보내세요.

도움이 필요하신가요?

## 아직 도움이 필요하신가요?

실제 담당자가 도와드립니다. 이미 Scratcher를 사용 중이라면 플랫폼 안의 채팅이 가장 빠릅니다.

- **[채팅 문의](https://platform.scratcher.io/ko/login)**

    로그인한 뒤 오른쪽 아래의 채팅 버튼을 클릭하세요. Rex가 바로 답하고, 팀과도 클릭 한 번으로 연결됩니다.
- **[미팅 예약](https://scratcher.io/ko/book-a-meeting)**

    팀과의 무료 30분 화상 통화: 둘러보기, 캠페인 아이디어, 설정 지원.
- **[이메일 문의](mailto:contact@scratcher.io)**

    contact@scratcher.io로 연락 주시면 답변드리겠습니다.
