콘텐츠로 이동

iOS SDK - 변경 로그 (Changelog)

이 문서는 Groobee iOS SDK의 버전별 변경 사항을 기록합니다.

현재 권장 버전 (Stable)

  • 1.1.15

[1.1.15] - 2026-10-08

  • add: 장바구니 담기(AC)·제거(DC) 행동 수집 API 추가 (setAddToCart, setDeleteFromCart, 행동 수집 상세)

[1.1.14] - 2026-10-01

  • add: 인앱 팝업 닫기 버튼 크기 조정 설정 추가 (setInAppMsgCloseButtonScale, 설치 가이드)

[1.1.13] - 2026-09-28

  • fix: 가로 화면과 폴더블 기기에서 인앱 팝업이 화면 밖으로 잘리던 문제 수정. 원본 비율을 유지한 채 안전영역 안에 표시되며, 화면 회전 시 다시 계산됩니다.
  • improve: 인앱 팝업 닫기(X) 버튼 크기를 팝업 크기에 맞춰 조정 (기존 20pt 고정 → 팝업 폭의 7.5%, 최소 32pt·최대 44pt). 탭 영역은 항상 44pt로 유지됩니다.
  • add: 인앱 팝업 이미지의 높이 상한을 SDK 초기화 시 조절할 수 있는 설정 신설 (setInAppMsgMaxHeightRatioPortrait, setInAppMsgMaxHeightRatioLandscape)
  • 관련 변경 페이지: iOS SDK 설치 가이드 - 인앱 팝업 이미지 높이 상한

변경 요약: 가로 화면에서 인앱 팝업이 잘려 보이던 문제를 수정했습니다. 앱 코드 수정 없이 SDK 버전만 올리면 적용되며, 높이 상한 설정은 선택 사항입니다. 최소 지원 OS 변경은 없습니다.

팝업 크기 참고: 이번 버전에서 팝업이 기존보다 커지는 경우는 없습니다. 1.1.12에서 화면 밖으로 넘치던 경우(가로 화면 전반, 세로 9:16 소재)는 화면 안으로 들어오며, 높이 상한 기본값 0.9가 적용되어 작아지는 경우가 있습니다.

[1.1.12] - 2026-08-13

  • add: 네이티브 → 웹뷰 동기화 메소드 syncNativeToWeb(_ domain:) 신설.
  • add: 하이브리드 동기화 메소드 호출시 최근 본 상품 목록을 함께 전달하도록 추가 (syncWebToNative(webView:urlRequest:), syncNativeToWeb(_ domain:))
  • 관련 변경 페이지: iOS SDK 하이브리드 앱 데이터 동기화

⚠️ iOS 11 미만에서는 동작하지 않습니다. WKWebView의 쿠키 저장소에 접근할 공개 API가 없어 쓰기(syncNativeToWeb)와 읽기(syncWebToNative) 모두 동작하지 않으며, SDK가 경고 로그를 남깁니다.

[1.1.11] - 2026-07-27

  • fix: 팝업 인앱 메시지의 이미지를 불러오지 못했을 때 앱이 종료되던 문제 수정
  • fix: 인앱 메시지의 닫기 버튼 이미지를 불러오지 못했을 때 버튼이 보이지 않아 메시지를 닫을 수 없던 문제 수정 (기본 닫기 아이콘으로 대체)
  • change: 인앱 메시지 노출 통계를 표시 시도 시점이 아니라 실제 화면에 표시된 경우에만 전송하도록 변경

변경 요약: 팝업 이미지 로드 실패 시 잘못된 레이아웃 계산으로 앱이 종료되던 문제를 수정했습니다. 이미지를 불러오지 못하면 팝업을 표시하지 않으며, 이 경우 노출 통계를 전송하지 않으므로 해당 캠페인은 이후 다시 발행됩니다. 앱 코드 수정 없이 SDK 버전만 올리면 적용됩니다.

통계 리포트 참고: 이번 버전이 적용된 단말이 늘어남에 따라 인앱 메시지 노출수와 클릭수가 감소할 수 있습니다. 표시되지 않은 노출과 중복 집계된 클릭이 제외되면서 수치가 정확해지는 것이며, 실제 캠페인 성과가 하락한 것은 아닙니다.

[1.1.10] - 2026-06-25

  • fix: 배포 패키지에 누락되어 있던 dSYM 파일을 포함하도록 수정

[1.1.8] - 2026-06-11

  • fix: 알림 메시지에서 알림 설정 버튼을 눌렀을 떄 웹 브라우저 링크도 열 수 있도록 수정

[1.1.6] - 2026-04-30

  • fix: 웹-네이티브 동기화 중 입력되는 데이터는 동기화 이후에 처리되도록 변경

[1.1.5] - 2026-04-20

  • Add: 정보통신망법 7차 개정안 대응 기능 추가: 알림 메시지에서 바로 알림 설정 페이지로 이동하는 딥링크 지원 (KISA 안내)

관련 변경 페이지:

변경 요약: 푸시 알림 하단에 알림 수신 설정 버튼을 표시하고, 사용자가 버튼을 누르면 앱에서 정의한 알림 설정 화면 딥링크로 이동할 수 있도록 setNotificationSettingsButton() 설정이 추가되었습니다. v.1.1.5 이상에서는 알림 응답을 SDK에 전달해 일반 푸시 본체 탭과 알림 설정 액션 탭을 함께 처리할 수 있으며, 앱에서는 해당 딥링크 라우팅과 알림 수신 동의 화면/상태 동기화를 함께 구현해야 합니다.