Metadata-Version: 2.1
Name: aanalyticsact_1
Version: 0.0.2.7
Summary: Adobe Analytics Api Extraction
Author-Email: Youngkwang Cho <youngkwang.cho@concentrix.com>
License: MIT
Project-URL: Homepage, https://github.com/Glory-Cho/aanalyticsact
Project-URL: Repository, https://github.com/Glory-Cho/aanalyticsact
Requires-Python: >=3.12
Requires-Dist: sqlalchemy==1.4.39
Requires-Dist: pandas==2.1.4
Description-Content-Type: text/markdown

# Adobe Analytics for Team ACT v0.0.2.7

This module is designed to provide a more efficient and stable analysis environment
for Adobe Analytics analysts in Team ACT, with internal performance optimizations
and extended data retrieval capabilities.

## New in 0.0.2.7 (Updated 2026.9.2)

### 1. actRunner / actModuler / actExecute 내부 로직 정비
- 시각(hour) 지정 조회 시 구간이 하루 넓어지던 버그 수정
- breakdown 무한 재시도 / 중복 적재 / 뒷부분 데이터 손실 문제 수정
- 재시도가 중복 행을 만들던 문제 수정
- weekly/monthly 기간 분할이 요청 종료일을 넘던 문제 수정 (`clamp=False`로 기존 동작 복원 가능)
- 오류 진단 메시지 개선
- site_code 입력 개선, tbColumn 개수 불일치 조기 차단, breakdown 진행 표시 추가, 조직 매핑을 공식 조직표로 교체
- 기존 공개 함수 56개 전부 유지, 호출부 수정 불필요 — 자세한 내용은 `CHANGELOG.md` 참고

## New in 0.0.2.5.2 (Updated 2026.4.24)

### 1. 신규 US RS 추가 및 기존 US RS 명칭 변경
- 신규 US RS: sssamsung4newus (기존 "us" 대응)
- 구 US RS: sssamsungnewus (기존 "us_old" 대응)

### 2. MST Filter 내 site_code 지원 범위 확대
- retrieve_FirstLevel 및 retrieve_SecondLevel 함수에서 MST 사용시 데이터를 필터링할 수 있는 국가 코드(site_code) 추가
- 추가된 코드: ec, sv, gt, cr, do, hn, car, mi, pr, ni, pa, us

### 3. DB 접속 엔진 최적화 및 안정성 개선
- DB 연결 방식에 싱글톤(Singleton) 패턴 및 커넥션 풀을 적용하여 병렬 작업 시의 안정성 증가


## New in 0.0.2.4 (Updated 2026.2.11)

### 1. 데이터 최대 추출 개수 (5만 > 전체)


## New in 0.0.2.2 (Updated 2026.1.27)

### 1. max_retries 기능 수정


## New in 0.0.2.1 (Updated 2025.12.23)

### 1. RS INPUT 변수에 EU-VRS (6개국, ES, DE, NL, PT, BE) 추가 및 UK RS 명칭 변경
- VRS 명칭 : sitecode ex) uk vrs > uk
- 국RS 명칭 : sitecode_old ex) uk rs > uk_old


## New in 0.0.2 (Updated 2025.12.12)

### 1. retrieve_by_RS_parallel 함수 추가
- `ThreadPoolExecutor`를 활용한 동시 실행 구조 적용
- 사용 방식에는 변경 없음
- 성능 및 처리 효율 개선

### 2. max_retries 기능 수정
- `"oberon_client_http_error"` 감지하도록 로직 수정


## New in 0.0.1.60 (Updated 2025.8.18)
- pandas, sqlalchemy 버전 업그레이드에 따른 업데이트


## New in 0.0.1.59 (Updated 2025.2.5)

### 기능 추가
- retrieve_by_RS_breakdownTotal / retrieve_SecondLevelTotal 함수 추가
  - Dimension과 Breakdown 값을 동시에 추출 가능

### 버그 수정
- `'No data returned & lastPage is False'`로 인한 무한 루프 해결
  - 데이터 추출 시 수치가 없으면 다음 행으로 넘어가도록 수정

### 기능 개선
- retrieve_SecondLevel, retrieve_FirstLevel에 limit 기능 추가 및 수정
  - retrieve_SecondLevel / retrieve_SecondLevelTotal에 limit1, limit2 적용
  - 1st Dimension과 Breakdown의 limit을 각각 지정 가능
  - retrieve_FirstLevel의 limit 기능 수정

### 데이터 범위 변경
- MST Site Code Filter 203개로 축소
  - [Site Code] 103개 사이트 (Evar 세그먼트 기준 APP 포함 총 206 site code)
  - `[site code]`, `[site code]-app`


## New in 0.0.1.58 (Updated 2025.1.7)
- `max_retries` 기능 추가 (default = 5)
  - AttributeError, ConnectionError 등 발생 시
  - 최대 `max_retries` 횟수만큼 재시도


## New in 0.0.1.57 (Updated 2024.8.13)

### Site Code 확장
- Site Code Filter에 Site Code 추가
  - v0.0.1.57 이전: `[site code]`, `[site code]-smb` (총 137개)
  - v0.0.1.57 이후:
    - `[site code]-app`
    - `[site code]-epp`
    - `[site code]-epp-app`
    - `[site code]-smb-app`
  - 총 636개

### 기능 추가
- retrieve_by_RS, retrieve_by_RS_breakdown에서 MST 데이터 추출 가능
- `extra1` 기능 추가
  - 기존 `extra` 외 추가 구분자 사용 가능 (최대 2개)

### 구조 개선
- 데이터 추출 Loop 순서 변경
  - Date > RS → RS > Date


## New in 0.0.1.53 (Updated 2024.6.25)
- RS INPUT 변수에 UK-VRS 추가
  - uk → UK VRS
  - uk_epp → UK RS


## New in 0.0.1.52 (Updated 2024.5.7)

### 기능 추가 및 개선
- limit 기능 추가
- retrieve_by_RS_breakdown에 limit1, limit2 추가
- retrieve_by_RS에 limit 기능 추가
- limit 변수 순서 변경 및 option화
  - 필수 → 선택 변수
  - 미지정 시 전체 데이터 추출

### 버그 수정
- Encoding error 수정
- 특수문자 데이터 저장 오류 수정

### 데이터 추가
- Semiconductor RS 7개 추가
- ds-global, ds-cn, ds-us, ds-kr, ds-emea, ds-jp, ds-total


## New in 0.0.1.48 (Updated 2024.3.22)
- API 동시 추출 기능 추가
  - sqlalchemy 패키지 활용

---

More functionalities will be added in the near future.
