---
title: "Apsis One 연결하기"
description: "Apsis One에서 API 키를 만들어 연결하고, 신규 가입자를 속성 및 구독과 함께 섹션으로 보내는 방법을 단계별로 안내합니다."
url: https://scratcher.io/ko/help/integrations/apsis-one
language: ko
---

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

# Apsis One 연결하기

Apsis One에서 API 키를 만들어 연결하고, 신규 가입자를 속성 및 구독과 함께 섹션으로 보내는 방법을 단계별로 안내합니다.

Apsis One 통합을 사용하면 가입한 모든 사람이 선택한 섹션에 Apsis One 프로필로 생성되거나 업데이트되며, Apsis One 구독 중 하나에 수신 동의 처리될 수 있습니다.

## 준비 사항

- Apsis One 계정과 API 키를 관리할 수 있는 사용자(보통 관리자).
- Apsis One 계정이 **Europe** 리전인지 **Asia** 리전인지 확인해 두세요. 대부분의 계정은 Europe 리전에 있습니다.

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

1. Apsis One에서 **Account settings**를 열고 (통합 아래의) **API keys**로 이동합니다.
2. 새 API 키를 만듭니다. 알아보기 쉬운 이름(예: “Scratcher”)을 지정하세요.
3. Scratcher가 프로필을 보낼 섹션에 대해 아래 권한으로 키의 액세스를 허용합니다.
4. 저장한 다음 **Client ID**와 **Client secret**을 복사합니다. Secret은 한 번만 표시됩니다.

Apsis에서도 이에 대한 단계별 가이드를 제공합니다. Scratcher 설치 대화 상자의 **설정 가이드**에 링크되어 있습니다(“통합을 설치하려면 여기의 가이드를 따르세요”).

## 키에 필요한 권한

Scratcher는 이 키로 다음 작업을 합니다.

- 캠페인에서 선택할 수 있도록 섹션과 그 안의 속성, 구독(동의 주제), 이벤트를 읽습니다.
- 프로필을 생성하고 속성을 업데이트합니다.
- 프로필에 동의(수신 동의)를 추가합니다.
- 프로필에 이벤트를 추가합니다.

따라서 키에는 섹션에 대한 읽기 권한과, 사용하는 섹션의 프로필·동의·이벤트에 대한 쓰기 권한이 필요합니다. 쓰기 권한이 없으면 Apsis One의 오류 메시지와 함께 전송이 실패합니다.

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

1. Scratcher에서 **설정** > **통합**으로 이동해 **Apsis One**을 클릭합니다.
2. **API 리전**을 선택합니다. **Europe** 또는 **Asia** 중에서 고르세요.
3. **Client ID**와 **Client secret**을 붙여 넣습니다.
4. **통합 설치**를 클릭합니다. Scratcher가 Apsis One에 로그인해 정보를 확인합니다.

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

1. 편집기에서 **연결** > **통합** > **Apsis One**으로 이동해 **활성화**를 클릭합니다.
2. Apsis One 계정을 두 개 이상 연결했다면 **계정 선택**에서 계정을 고릅니다.
3. **Apsis 섹션**에서 섹션을 선택합니다(**섹션 선택**).
4. **필드 매핑**에서 필드마다 **필드 매핑 추가**를 클릭하고 **Scratcher 필드**를 **대상 필드**의 Apsis One 속성과 연결합니다. 목록에는 직접 만든 속성을 포함해 선택한 섹션의 속성이 표시됩니다.
5. \*\*구독(동의)\*\*에서 사람들을 수신 동의 처리할 구독을 선택하거나 **없음**을 선택합니다. “참여자를 수신 동의 처리할 구독을 선택하세요.”
6. \*\*권한으로 필터링(선택 사항)\*\*에서 마케팅 동의 체크박스를 선택하면 체크한 사람만 전송됩니다.
7. **저장**을 클릭한 다음 **테스트**를 클릭해 테스트 프로필을 보냅니다.

## 필드 매핑

- 이메일 주소는 항상 전송되며 프로필을 식별하는 데 사용됩니다. 따로 매핑할 필요가 없습니다.
- 전화번호는 **형식** 설정으로 속성이 요구하는 형태에 맞춰 보낼 수 있습니다.
- 예/아니요 속성에는 true 또는 false가 전송되므로, 동의의 **동의함** 필드는 예/아니요 속성에 매핑하세요.

## 동의

구독을 선택하면 각 사람은 “Subscribed via”와 캠페인 이름을 사유로, “Scratcher”를 출처로 하여 해당 구독에 수신 동의 처리됩니다. 이미 수신 동의한 사람이라면 아무것도 바뀌지 않습니다. **권한으로 필터링**을 사용하면 마케팅 체크박스에 체크한 사람만 수신 동의 처리됩니다.

섹션에 Apsis One의 동의 양식 이벤트가 있다면, Scratcher는 가입 내역도 캠페인 주소와 함께 프로필에 이벤트로 기록합니다.

## 전송 내용 및 시점

신규 가입자는 1~2분 안에 전송됩니다. 통합을 활성화하면 캠페인의 기존 리드도 함께 전송됩니다. 누군가 다시 참여하면 프로필이 업데이트됩니다. 모든 전송 내역은 **설정** > **통합** > **전송 상태**에서 확인할 수 있으며, 프로필이 새로 생성되었는지 기존 프로필인지도 표시됩니다. [전송 상태 확인 및 리드 재전송](https://scratcher.io/ko/help/integrations/delivery-status)을 참고하세요.

## 문제 해결

- 설치 시 “All or some of the fields are invalid...”: 리전을 확인하고 Client ID와 Secret을 다시 복사하세요.
- Apsis One의 액세스 오류로 전송이 실패하는 경우: 키에 해당 섹션에 대한 액세스 권한이 없거나 쓰기 권한이 없습니다. Apsis One에서 키를 편집하세요.
- \*\*구독(동의)\*\*이 비어 있는 경우: 섹션에 아직 구독이 없습니다. Apsis One에서 구독을 만든 뒤 통합을 다시 여세요.

통합

- [통합의 작동 방식](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로 연락 주시면 답변드리겠습니다.
