> For the complete documentation index, see [llms.txt](https://docs.dfinery.ai/developer-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dfinery.ai/developer-guide/platform/android/change-log.md). # 릴리즈 노트 ## [2.7.2 (2026-08-18)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/v2.7.2) **고쳐짐** * 백그라운드 및 멀티스레드 환경 안정화 * 앱이 백그라운드 상태이거나 여러 스레드에서 동시에 이벤트를 기록할 때, 간헐적으로 발생하던 비정상 종료(Crash) 현상을 수정했습니다. * SDK 내부 데이터 처리 구조의 동기화(Thread-Safety)를 강화하여, 고성능 비동기 환경에서도 데이터가 끊김 없이 안전하게 전송되도록 개선했습니다. **주요 사항** * compileSdk 버전이 35로 업데이트 되었습니다. ## [2.7.1 (2026-07-31)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/v2.7.1) **고쳐짐** * 타 서비스(Non-Dfinery)에서 발송한 푸시 수신 시 [handleRemoteMessage](https://docs.dfinery.ai/developer-guide/platform/android/action/push-notification#undefined-16)가 `true`를 반환하던 문제를 수정하였습니다. * React Native 등 Third-Party 환경에서 SDK 초기화 완료 전 푸시 수신 시, 간헐적으로 식별자(Identity)가 암호화된 상태로 서버에 전송되던 문제를 수정하였습니다. **개선** * AppSetId 수집율이 향상되었습니다. ## [2.7.0 (2026-05-12)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/v2.7.0) **개선** * [푸시 클릭 시 전달되는 데이터를 직접 활용](https://docs.dfinery.ai/developer-guide/platform/android/action/push-notification#handle-push-notification-data)할 수 있도록 Intent Extra 키를 추가했습니다. * `com.igaworks.dfinery.push.extra.IS_DFINERY_PUSH` (Boolean) : Dfinery에서 발송한 푸시인지 확인하는 플래그 * `com.igaworks.dfinery.push.extra.PUSH_PAYLOAD` (String/JSON) : 수신된 푸시 알림의 전체 원본 데이터 (dfn 내부 값) * `com.igaworks.dfinery.push.extra.CLICK_RESULT` (String/JSON) : 사용자가 클릭한 지점(알림 본체 또는 특정 버튼)에 대해 정제된 클릭 액션 정보 ## [2.6.1 (2026-04-28)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/v2.6.1) **고쳐짐** * **데이터 정합성 강화**: SDK 초기화 이전 호출된 이벤트의 사용자 식별 정보(Identity)가 잘못 매핑되는 오류를 해결했습니다. **개선** * **광고 푸시 수신 리포트 안정화**: Android 13 이상 최신 OS 및 백그라운드 환경에서 푸시 수신 리포팅이 누락되지 않도록 전송 방식을 개선했습니다. * **플랫폼 로직 표준화**: 타 플랫폼(iOS/Web)과 데이터 포맷을 동일하게 맞추고, 식별 정보 변경 시 데이터 전송이 즉각 이루어지도록 최적화했습니다. ## [2.6.0 (2026-03-27)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/v2.6.0) **개선** * 백그라운드 환경에서의 SDK 동작 안정성이 개선되었습니다. * 초기화 및 세션 연결 전 발생한 데이터(UserProfile, Identity 등)의 전송 보장 로직이 강화되었습니다. **고쳐짐** * SDK 초기화 지연 도중 Activity가 종료될 경우 발생하던 메모리 누수 문제를 해결했습니다. ## [2.5.0 (2026-03-11)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/v2.5.0) **추가됨** * **푸시 알림 클릭 수동 처리 API 제공**: 앱의 특수 구조나 커스텀 브릿지 환경에서 개발자가 직접 인텐트(Intent)를 분석하여 클릭 이벤트를 처리할 수 있는 인터페이스 [`handlePushNotificationOpened(Activity activity)`](https://docs.dfinery.ai/developer-guide/platform/android/action/push-notification#handle-push-notification-opened)가 추가되었습니다. **개선** * **SDK 내부 실행 구조 및 데이터 처리 안정화**: 대량의 데이터가 일시에 유입되는 극한의 상황에서도 앱의 반응성이 저하되지 않도록 내부 실행 스레드 구조를 개선하고 DB 동시성 처리 성능을 최적화하였습니다. * **데이터 정합성 보장**: 앱이 백그라운드로 진입하는 시점의 데이터 기록 및 전송 프로세스를 개선하여, 안정적인 데이터 정합성을 확보하였습니다. * **리소스 사용 효율화**: 불필요한 반복 조회 로직을 제거하고, 인앱메시지 중복 호출 방지 플래그를 도입하여 시스템 자원 소모를 최소화하였습니다. * **푸시 알림 처리 및 액션 전달 로직 개선**: 중복 처리 방지 로직과 PendingIntent 생성 구조를 개선하여, 알림 클릭 및 버튼 액션이 유실 없이 정확하게 전달되도록 신뢰성을 강화하였습니다. ## [2.4.8 (2026-02-24)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/v2.4.8) **고쳐짐** * Android 15부터 도입된 [전체 화면 정책](https://developer.android.com/about/versions/15/behavior-changes-15?hl=ko#edge-to-edge) 및 Android 16의 [옵트아웃(Opt-out) 폐지](https://developer.android.com/about/versions/16/behavior-changes-16#edge-to-edge)에 대응하여, 인앱메시지가 화면 전체를 안정적으로 점유하고 시스템 바와 겹치지 않도록 레이아웃 로직을 최적화하였습니다. ## [2.4.7 (2026-01-30)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/v2.4.7) **변경됨** * SDK 일시정지 및 비활성화 상태에서도 푸시 알림이 노출되도록 변경되었습니다. **고쳐짐** * Flutter, Unity에서 `setUserProfile()` 호출 시 `정수형(Integer)` 및 `null` 데이터가 누락되던 문제가 해결되었습니다. **개선** * 이벤트 저장 로직이 개선되어 앱 응답성이 향상되었습니다. * 인앱메시지 조회 로직이 개선되어 앱 응답성이 향상되었습니다. **주요 사항** * 플랫폼별로 상이했던 로그 구조와 메시지가 통일된 규격으로 변경되었습니다. ## [2.4.6 (2026-01-13)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/v2.4.6) **고쳐짐** * 버전 2.4.1\~2.4.5에서 재시도를 포함한 초기화 API 호출이 모두 타임아웃될 경우 다음 초기화 전까지 이벤트 수집을 비롯한 SDK의 일부 기능이 중단되던 교착 상태 문제를 해결하였습니다. ## [2.4.5 (2026-01-06)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/v2.4.5) **개선** * 이벤트와 식별자·기기 정보 간의 정밀 매칭 로직을 적용하여, 어떤 상황에서도 발생 시점의 정확한 맥락 데이터를 수집할 수 있도록 개선했습니다. ## [2.4.4 (2025-12-02)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/v2.4.4) **고쳐짐** * `setIdentity()` API를 사용할 때, 드물게 저장되어 있던 이벤트에 새로운 식별자가 의도보다 일찍 적용되어 서버로 전송되는 문제가 해결되었습니다. ## [2.4.3 (2025-10-23)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.4.3) **고쳐짐** * Dfinery SDK가 탑재되고 푸시 연동이 완료된 애플리케이션에서, **Dfinery Console을 통하지 않고** 다른 경로로 수신된 푸시 알림의 내용이 비어있는 상태로 노출되는 문제가 해결되었습니다. ## [2.4.2 (2025-10-02)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.4.2) **고쳐짐** * 특정 상황에서 인앱메시지 커스텀 부모 뷰가 설정되지 않는 문제가 해결되었습니다. ## [2.4.1 (2025-10-01)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.4.1) **고쳐짐** * 초기화 실패 시 API 호출 방지 로직 추가. * 인앱 메시지 표시 안정성 향상. * 푸시 알림에서 딥 링크 열기 안정성 향상. ## [2.4.0 (2025-08-12)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.4.0) **추가됨** * 푸시 광고 캠페인이 지원됩니다. * 푸시 클릭시 `WebLink` 액션 타입이 지원됩니다. ## [2.3.5 (2025-07-04)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.3.5) **고쳐짐** * `2.3.4` 버전에서 이벤트 요청 실패시 [ANR](https://developer.android.com/topic/performance/vitals/anr)이 발생할 수 있는 문제가 해결되었습니다. ## [2.3.4 (2025-07-04)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.3.4) {% hint style="danger" %} **이 버전(`v2.3.4`)에서 특정 조건 하에 ANR(Application Not Responding)을 유발할 수 있는 잠재적 문제가 발견되었습니다.** 운영 환경(Production)에서는 **절대 사용하지 마시고**, 안정성이 확보된 최신 버전인 **`v2.3.5`** 이상으로 즉시 업데이트해주시기 바랍니다. 이용에 불편을 드려 대단히 죄송합니다. {% endhint %} * 다중 스레드 환경에서 API 동시 호출 시 발생하던 이벤트 정보의 중복, 누락 및 순서 오류를 해결하여 데이터 처리 안정성을 강화했습니다. * [Adbrix SDK](https://github.com/IGAWorksDev/adbrix-android-sdk)와 함께 사용 시 발생하던 데이터베이스(DB) 충돌 문제를 해결하여 SDK 호환성을 확보했습니다. * [com.android.support:support-annotations](https://mvnrepository.com/artifact/com.android.support/support-annotations) 의존성이 제거되었습니다. * compileSdk가 **35**로 변경되었습니다. ## [2.3.3 (2025-06-25)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.3.3) **추가됨** * 이제 `dfinery.xml`을 사용하여 [알림 강조 색상](https://docs.dfinery.ai/developer-guide/platform/android/action/push-notification#push_accent_color)을 설정할 수 있습니다. ```xml #e00052 ``` **고쳐짐** * SDK 초기화 전 API 호출 시 드물게 발생하던 타이밍 이슈를 수정했습니다. ## [2.3.2 (2025-06-20)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.3.2) **주요사항** * 서드파티 연동을 위한 구조 변경. ## [2.3.1 (2025-05-28)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.3.1) **더 이상 사용되지 않음** * DFUserProfile의 `PUSH_OPTIN`이 Deprecated 되었습니다. 푸시 알림 수신 허용 여부를 변경해야 하실 경우 `PUSH_ADS_OPTIN`을 써주시길 바랍니다. ## [2.3.0 (2025-04-14)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.3.0) **추가됨** * [푸시 알림의 강조 색상을 지정](https://docs.dfinery.ai/developer-guide/platform/android/action/push-notification#push_accent_color)할 수 있게 되었습니다. ```java new DfineryConfig.Builder() .setNotificationAccentColor(Color.GREEN) .build(); ``` ## [2.2.0 (2025-03-27)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.2.0) **추가됨** * 다음의 인앱메시지 연산자가 추가 되었습니다. * N일 후 특정일 연도포함 * N일 후 특정일 연도제외 * N개월 후 특정일 연도포함 * N개월 후 특정일 연도제외 **고쳐짐** * 요청 중 Timeout 발생시 재시도 하도록 변경되었습니다. ## [2.1.4 (2025-03-20)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.1.4) #### 고쳐짐 * 푸시 클릭 후 실행되는 Activity가 `onCreate()` 내에서 종료될 경우 푸시 클릭 이벤트가 집계되지 않는 버그가 수정되었습니다. ## [2.1.3 (2025-03-20)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.1.3) **고쳐짐** * 기기 프로필에서 변경된 OS 버전이 서버에 업데이트되지 않는 버그를 수정했습니다. ## [2.1.2 (2025-02-24)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.1.2) **고쳐짐** * 버튼이 있는 푸시 알림 클릭 시 잘못된 클릭 위치로 수집되는 현상이 수정되었습니다. * Activity의 특정 `launchMode` 설정에 따라 푸시 클릭 이벤트가 수집되지 않는 현상이 수정되었습니다. > 푸시 클릭시 실행하는 Activity의 `onNewIntent()`에 `setIntent()`를 추가해 주시기 바랍니다. > > ```java > protected void onNewIntent(Intent intent) { > super.onNewIntent(intent); > setIntent(intent); > } > ``` **추가됨** * 캠페인 여정 기능이 지원됩니다. ## [2.1.1 (2025-02-06)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.1.1) **고쳐짐** * Android 15의 특정 조건에서 내부적으로 인앱메시지 노출이 부하를 일으키는 현상 수정되었습니다. ## [2.1.0 (2025-01-09)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.1.0) **고쳐짐** * 인앱메시지 렌더링이 실패했을 경우 다음 인앱메시지가 표시되지 않는 문제가 해결되었습니다. **추가됨** * DfineryProperties에 `setUserProfile(String key, JSONArray value)`가 추가되었습니다. ## [2.0.1 (2024-12-30)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/2.0.1) **고쳐짐** * 네트워크 통신 등의 이슈로 API 요청이 실패했을때 재시도하는 로직이 적용되었습니다. * Log 레벨을 Debug 이상으로 설정했을 경우 네트워크 요청 페이로드가 출력되도록 변경되었습니다. **추가됨** * 인앱메시지 표시시 이벤트 속성 개인화가 지원됩니다. * SDK를 중단시키고 로컬 데이터를 제거하는 `disableSDK()`가 추가되었습니다. * `disalbeSDK()`를 사용하여 SDK가 중지 상태일때 재개하는 `enableSDK()`가 추가되었습니다. **제거됨** * `suspendUserTargeting()`가 제거되었습니다. ## [1.2.1 (2024-11-27)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/1.2.1) * 1.2.0 버전에서 인앱메시지를 사용할 수 없던 버그가 수정되었습니다 * 상수 명칭 변경 ## [1.2.0 (2024-11-21)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/1.2.0) * 상수 명칭 변경 * 광고 ID와 푸시 토큰 값을 `null`을 입력하여 초기화 할 수 있게 되었습니다 ## [1.1.2 (2024-11-14)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/1.1.2) * 값이 있는, 값이 없는, 빈 배열 인앱메시지 연산자 지원 * 테스트 인앱메시지의 노출 빈도에 따른 표시 제한이 적용되지 않는 버그 수정 ## [1.1.1 (2024-10-29)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/1.1.1) * 종료 이벤트를 설정하지 않고 인앱메시지를 지연하였을때 발생하는 버그 수정 * 동일한 이벤트의 지연된 인앱메시지가 등록되었을때 노출 로직 변경 * 인앱메시지 일부 연산자에서 발생하는 버그 수정 * 테스트 인앱메시지가 일반 인앱메시지보다 우선적으로 노출되도록 수정 * 인앱 메시지가 콘솔보다 어둡게 표시되지 않도록 수정 ## [1.1.0 (2024-10-10)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/1.1.0) * 푸시 기능 추가 * 인앱메시지 기능 추가 ## [1.0.0 (2024-03-29)](https://github.com/IGAWorksDev/dfinery-android-sdk/releases/tag/1.0.0) * 최초 배포