Skip to main content

​
Klaviyo 정보

Iru는 Klaviyo API에서 계정 사용자 및 해당 권한, API 키 및 해당 범위, 목록 및 세그먼트 메타데이터, 통합 연결을 읽습니다. 인증에는 설정 → API 키에서 생성한 비공개 API 키를 사용합니다. Klaviyo 비공개 키는 생성 시 범위가 지정됩니다. 컨트롤 대상 객체에 대한 읽기 전용 액세스 권한을 부여하세요. Iru는 메타데이터만 읽습니다. 목록 및 세그먼트 이름과 구성은 수집되지만, 그 안의 프로필은 수집되지 않습니다.

​
작동 방식

Klaviyo는 커스텀 인증 방식을 사용합니다. 헤더 값에는 Bearer가 아닌 Klaviyo-API-Key 접두사가 붙습니다. 모든 요청에는 API 버전을 고정하는 ISO 8601 날짜가 포함된 revision 헤더도 필요합니다. Klaviyo는 경로 세그먼트가 아닌 날짜별 리비전으로 API 버전을 관리하며, 유효한 리비전이 없는 요청은 거부됩니다. 리비전은 Iru가 설정하므로 사용자는 키만 제공하면 됩니다. 요청 대상은 https://a.klaviyo.com/api입니다. 구성할 하위 도메인이나 계정 호스트는 없습니다. 공개 API 키(클라이언트 측 구독 호출에 사용되는 짧은 회사 ID)는 다른 자격 증명이며 여기에서 인증되지 않습니다. 공식 참고 자료: Authenticate API requests, API versioning and deprecation policy.

​
사전 요구 사항

  • Klaviyo에서 API 키를 관리할 수 있는 계정 역할.
  • 범위에 포함할 항목을 결정하세요. Klaviyo에서는 목록 및 세그먼트 모니터링을 제외할 수 있으며, 제외된 객체에 대해서는 증거가 생성되지 않습니다.

​
Klaviyo를 Iru에 연결

Compliance에서 소스를 연결하기 전에 이 탭을 완료하세요.
1

Klaviyo에 로그인

API 키를 관리할 수 있는 계정으로 Klaviyo에 로그인합니다.
2

설정 열기

왼쪽 하단의 계정 메뉴를 열고 설정을 선택합니다.
3

API 키 열기

API 키로 이동합니다.
4

비공개 API 키 생성

Create private API key를 선택합니다.
5

키 이름 및 범위 지정

나중에 통합을 감사할 수 있도록 Iru Compliance와 같은 레이블을 입력합니다. 키의 액세스를 읽기 전용으로 설정합니다. 커스텀 범위를 사용하여 컴플라이언스 프로그램 대상 객체에만 읽기 액세스 권한을 부여합니다. Accounts, Lists 및 Segments가 Iru가 수집하는 증거를 포괄합니다. 전체 액세스나 쓰기 범위는 부여하지 마세요.
6

키 생성 및 복사

키를 생성하고 Klaviyo가 값을 표시하는 동안 한 번 복사합니다.
Iru Compliance 탭에서 계속 진행하세요.

​
문제 해결

Iru 사이트에 대한 팝업 차단 설정을 확인한 후 다시 시도하세요.
공개 키가 아닌 비공개 키를 생성했는지 확인하세요. 공개 키는 클라이언트 측 호출에 사용되는 짧은 회사 ID이며 서버 간 요청을 인증하지 않습니다.
비공개 키가 해당 객체를 제외하는 커스텀 범위로 생성되었습니다. Klaviyo 범위는 생성 시 고정됩니다. 필요한 범위로 새 키를 생성하세요.
키에 해당 항목에 대한 읽기 액세스 권한이 없거나, 이 연결에서 목록 및 세그먼트 모니터링이 범위에서 제외되었습니다.
예상된 동작입니다. Iru는 목록 및 세그먼트의 메타데이터만 수집하며, 그 안의 프로필은 수집하지 않습니다.

​
관련 문서

Sources 관리

모든 Compliance 소스를 찾아보고 관리합니다.

Compliance 시작하기

프레임워크, 작업 및 아티팩트.

Iru 개요

Endpoint, Compliance 및 Identity가 함께 작동하는 방식.

Artifacts 관리

소스 및 작업에서 수집한 증거를 업로드, 검토 및 정리합니다.