> 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.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)
* 최초 배포
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.dfinery.ai/developer-guide/platform/android/change-log.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.