하이터치는 기업이 데이터 웨어하우스와 분석, 마케팅, 운영에 사용하는 다양한 도구 또는 플랫폼 간에 데이터를 동기화할 수 있도록 지원하는데이터 연동 플랫폼입니다. 사용자는 복잡한 ETL(추출, 변환, 로드) 프로세스나 사용자 지정 코딩 없이도 데이터 웨어하우스를 CRM, 마케팅 자동화 플랫폼, 고객 지원 시스템 등과 같은 도구에 쉽게 연결할 수 있습니다.
싱귤러와 하이터치 연동은 싱귤러 서버 간(S2S) REST API를 사용하여 하이터치 소스(웨어하우스)에서 모바일(iOS/Android) 이벤트 데이터를 전송합니다. 이를 하이터치 플랫폼에서 "대상" 이라고 합니다. 아래 지침은 Hightouch에서 Singular 대상을 구성하는 방법을 설명합니다.
| 엔지니어링 팀을 위한 요구 사항 가이드 |
|
이 연동을 사용하려면 Singular Mobile SDK에서 마지막으로 알려진 이벤트와 일치하는 모든 필수 Singular 데이터 포인트가 포함된 Hightouch 소스를 사용해야 합니다.
이 연동은 비모바일 이벤트 데이터와 호환되지 않습니다. 서버 또는 웹 이벤트는 지원되지 않습니다.
-
하이터치 지원 동기화 유형: 이벤트
하이터치는 인앱 이벤트를 Singular에 동기화하는 기능을 지원합니다.
지원되는 동기화 모드: 삽입 전용
- 세션 이벤트
- 웹 이벤트
- 모바일 데이터 포인트가 없는 서버 측 이벤트
하이터치 연동은 싱귤러 SDK를 대체하지 않습니다. Singular SDK를 Hightouch와 병행하여 사용해야 합니다. 이는 하이브리드 연동으로, 데이터 수집은 동일한 기기/사용자에 대해 Singular 발급 SDK를 통해 클라이언트 내부와 REST API 엔드포인트를 통해 모두 이루어집니다. 하이터치에서 싱귤러로 전송된 모든 이벤트는 사용자의 마지막으로 알려진 모바일 디바이스와 연결되며, 해당 디바이스에 대해 마지막으로 알려진 캠페인 데이터와 코호트됩니다.
시작하기
하이터치에서 Singular 대상의 인스턴스를 생성하는 것으로 시작합니다. 인스턴스를 생성할 때 인증을 위해 Singular SDK 키를 입력해야 합니다.
- Hightouch 탐색 메뉴에서 "설정 > 대상"을 클릭합니다.
- "대상 추가" 버튼을 클릭합니다.
- "Singular"를 검색하고 계속을 클릭합니다.
- "API 키" 필드에 Singular SDK 키를 입력합니다. 계속을 클릭합니다.
싱귤러 대시보드의 "개발자 도구 > SDK 연동 > SDK 키"에서 싱귤러 "SDK 키"를 받습니다.
- 대상의 이름을 지정하고 "완료"를 클릭합니다.
중요: "연결 테스트" 버튼을 클릭하면 다음 오류가 표시될 수 있습니다:
이는 API에 다음 단계에서 구성할 추가 데이터 포인트가 필요하기 때문입니다.
추가 설정
모델 구성
- 하이터치 탐색 메뉴에서 "모델"을 선택하고 "새 모델 추가"를 선택합니다.
- 데이터 소스를 선택하고 "계속"을 클릭합니다.
- 모델 이름을 입력하고 드롭다운에서 기본 키를 선택합니다.
동기화가 각 이벤트를 전송하도록 하려면 이벤트 모델에 고유한 기본 키를 사용해야 합니다. 자세한 내용은 이벤트 동기화 문서를 참조하세요.
동기화 구성
- 하이터치 탐색 메뉴에서 "동기화" 및 "동기화 추가"를 선택합니다.
- Singular용으로 구성된 모델을 선택합니다.
- Singular 대상을 선택합니다.
- 필수입니다: 드롭다운 메뉴에서 Singular 이벤트 이름으로 사용할 이벤트 이름 열을 선택합니다.
- 필수: 드롭다운 메뉴에서 Singular 이벤트 시간으로 사용할 타임스탬프 열을 선택합니다.
- Singular 이벤트에 동기화하려는 다른 열을 선택합니다.
쿼리 결과의 열을 대상의 필드에 매핑하는 방법을 구성합니다. Singular 대상에는 '플랫폼' 필드를 기반으로 하는 몇 가지 조건부 필수 필드가 있다는 점에 유의하세요.
필수 추가 매개변수 매핑:
이벤트에 대해 매핑해야 하는 매개변수에 대한 자세한 내용은 여기에서 Singular S2S 참조의 필수 이벤트 매개변수를 참조하세요.
IP 필드를 매핑하지 않으면 하이터치 서버의 IP 필드가 기본값으로 사용됩니다.
디바이스 식별자 정보
Hightouch에서 기존 장치로 전송된 이벤트를 Singular에서 적절하게 어트리뷰션하려면 일치하는 장치 식별자를 사용해야 합니다. 내부 BI 엔드포인트 옵션이 로그인 이벤트에서 웨어하우스로 데이터를 캡처하도록 구성된 경우, 이 이벤트 요청에 동일한 식별자를 사용해야 합니다.
iOS의 경우 - IDFA 또는 IDFV입니다. "NULL" 값이나 0 식별자를 제공하지 마세요. Singular SDK가 초기화될 때 디바이스에서 IDFA를 사용할 수 없는 경우 Singular는 IDFV 값을 사용합니다.
Android의 경우, 이는 AIFA(일명. GAID) 또는 ASID입니다. "NULL" 값이나 0으로 표시된 식별자는 제공하지 마세요. Singular SDK가 초기화될 때 디바이스에서 AIFA를 사용할 수 없는 경우 Singular는 ASID 값을 사용합니다. 기기에서 AIFA나 ASID 값을 모두 사용할 수 없는 경우에는 안드로이드 ID(ANDI)만 제공해야 합니다.
- 매개변수가 매핑되면 '테스트' 버튼을 사용하여 이벤트를 테스트할 수 있습니다.
테스트에 사용되는 소스 데이터에서 식별자를 캡처하고, Singular 테스트 콘솔을 사용하여 실시간으로 수신되는 이벤트를 확인하세요. 이벤트 테스트 방법에 대한 자세한 내용은 여기를 참조하세요.
예시:
매핑
테스트
Singular 테스트 콘솔 - 테스트가 성공적으로 완료되면 계속을 클릭하고 일정 유형을 설정한 후 '마침'을 클릭합니다.
SkAdNetwork 지원
하이터치에서 전송한 이벤트를 싱귤러의 SKAN(SkAdNetwork) 전환 모델에서 사용하려면, 싱귤러 계정에 '하이브리드 SKAN' 기능이 활성화되어 있어야 합니다. 활성화하려면 CSM에게 문의하거나 싱귤러 지원 요청을 제출하세요.
이벤트
소스에 추가된 모든 레코드는 새 이벤트로 취급되며 동기화가 실행될 때 Singular로 전송됩니다.
사용자 지정 매핑을 사용하여 애플리케이션과 관련된 사용자 지정 데이터를 첨부할 수 있습니다.
사용자 지정 매핑은 API 요청 페이로드의 "e" 매개변수로 포함됩니다.
팁 및 문제 해결
불일치
서버 간 이벤트 요청에 사용된 디바이스 식별자가 Singular에서 일치하는 디바이스 식별자가 없는 경우 불일치가 발생할 수 있습니다. 다음과 같은 가능성에 유의하세요:
- 이벤트 요청이 앱 세션에서 싱귤러 SDK가 디바이스 식별자를 기록하기 '전에' 수신된 경우, 이벤트 요청은 알 수 없는 디바이스에 대한 '첫 번째 세션'으로 간주되며, 싱귤러는 해당 디바이스를 오가닉 어트리뷰션으로 어트리뷰션할 것입니다.
- 싱귤러 SDK가 디바이스 식별자를 기록했지만, 싱귤러 SDK 식별자가 서버 간 이벤트 요청에 지정된 디바이스 식별자와 다른 경우 이벤트가 잘못 어트리뷰션됩니다.
일반적인 오류
오류가 발생하면 Singular의 모든 필수 필드를 포함하고 있는지 확인하세요: "플랫폼", "패키지 이름", "OS 버전" 및 관련 플랫폼의 디바이스 식별자.
라이브 디버거
하이터치는 각 동기화 실행 중에 수행되는 API 호출에 대한 완벽한 가시성을 제공합니다. 자세한 내용은 디버깅 팁과 요령에 대한 글을 읽어보시기 바랍니다.
동기화 알림
Hightouch는 Slack, PagerDuty, SMS 또는 이메일을 통해 동기화 문제를 알려줄 수 있습니다. 자세한 내용은 알림에 대한 도움말 문서를 참조하세요.