Merge pull request #696 from sopt-makers/feat/#673-home-amplitude

dlwogus0128 · web-flow · commit 6928888d335c · 2025-09-07T13:13:02.000+09:00
[Feat] #673 - 홈화면 앰플리튜드 연동
diff --git a/SOPT-iOS/Projects/Core/Sources/Amplitude/AmplitudeEventPropertyKey.swift b/SOPT-iOS/Projects/Core/Sources/Amplitude/AmplitudeEventPropertyKey.swift
@@ -15,4 +15,13 @@ public enum AmplitudeEventPropertyKey: String {
     // 콕 찌르기 피쳐 관련 Key
     case viewProfile = "view_profile" // 멤버 프로필 id
     case friendType = "friend_type"
+    
+    // 홈 피쳐 관련 Key
+    case postRanking = "post_ranking"
+    case sectionName = "section_name"
+    case postID = "post_id"
+    case category = "category"
+    case promoName = "promo_name"
+    case destinationURL = "destination_url"
+    case destinationType = "destination_type"
 }
diff --git a/SOPT-iOS/Projects/Core/Sources/Amplitude/AmplitudeEventType.swift b/SOPT-iOS/Projects/Core/Sources/Amplitude/AmplitudeEventType.swift
@@ -43,6 +43,11 @@ public enum AmplitudeEventType: String {
     case clickPokeMenu = "click_poke_menu"
     case clickTodaySoptuneMenu = "click_todaysoptmadi_menu"
     case clickSoptampMenu = "click_soptamp_menu"
+    case clickPostMember = "click_post_member"
+    case clickPost = "click_post"
+    case clickEmpty = "click_empty"
+    case clickViewAll = "click_view_all"
+    case clickPromo = "click_promo"
     
     // 콕 찌르기 클릭 이벤트
     case clickPoke = "click_poke"
diff --git a/SOPT-iOS/Projects/Data/Sources/Transform/HomeLatestPostsTransform.swift b/SOPT-iOS/Projects/Data/Sources/Transform/HomeLatestPostsTransform.swift
@@ -22,7 +22,8 @@ extension HomeLatestPostsResponseEntity {
             content: self.content,
             webLink: self.webLink,
             id: self.id,
-            isOutdated: self.isOutdated
+            isOutdated: self.isOutdated,
+            userId: self.userId
         )
     }
 }
diff --git a/SOPT-iOS/Projects/Data/Sources/Transform/HomePopularPostsTransform.swift b/SOPT-iOS/Projects/Data/Sources/Transform/HomePopularPostsTransform.swift
@@ -22,7 +22,8 @@ extension HomePopularPostsResponseEntity {
             title: self.title,
             content: self.content,
             webLink: self.webLink,
-            id: self.id
+            id: self.id,
+            userId: self.userId
         )
     }
 }
diff --git a/SOPT-iOS/Projects/Domain/Sources/Model/HomeLatestPostsModel.swift b/SOPT-iOS/Projects/Domain/Sources/Model/HomeLatestPostsModel.swift
@@ -18,6 +18,7 @@ public struct HomeLatestPostModel {
     public let webLink: String
     public let id: Int?
     public let isOutdated: Bool
+    public let userId: Int?
 
     public init(
         profileImage: String?,
@@ -28,7 +29,8 @@ public struct HomeLatestPostModel {
         content: String,
         webLink: String,
         id: Int?,
-        isOutdated: Bool
+        isOutdated: Bool,
+        userId: Int?
     ) {
         self.profileImage = profileImage
         self.name = name
@@ -39,5 +41,6 @@ public struct HomeLatestPostModel {
         self.webLink = webLink
         self.id = id
         self.isOutdated = isOutdated
+        self.userId = userId
     }
 }
diff --git a/SOPT-iOS/Projects/Domain/Sources/Model/HomePopularPostsModel.swift b/SOPT-iOS/Projects/Domain/Sources/Model/HomePopularPostsModel.swift
@@ -18,6 +18,7 @@ public struct HomePopularPostModel {
     public let content: String
     public let webLink: String
     public let id: Int?
+    public let userId: Int?
 
     public init(
         profileImage: String?,
@@ -28,7 +29,8 @@ public struct HomePopularPostModel {
         title: String,
         content: String,
         webLink: String,
-        id: Int?
+        id: Int?,
+        userId: Int?
     ) {
         self.profileImage = profileImage
         self.name = name
@@ -39,5 +41,6 @@ public struct HomePopularPostModel {
         self.content = content
         self.webLink = webLink
         self.id = id
+        self.userId = userId
     }
 }
diff --git a/SOPT-iOS/Projects/Features/HomeFeature/Interface/Sources/HomeForMemberPresentable.swift b/SOPT-iOS/Projects/Features/HomeFeature/Interface/Sources/HomeForMemberPresentable.swift
@@ -29,6 +29,7 @@ public protocol HomeForMemberCoordinatable {
     var onPopularPostCellTapped: ((String) -> Void)? { get set }
     var onLatestPostCellTapped: ((String) -> Void)? { get set }
     var onViewAllContentButtonTapped: ((String) -> Void)? { get set }
+    var onProfileImageViewTapped: ((Int) -> Void)? { get set }
 }
 public typealias HomeForMemberViewModelType = ViewModelType & HomeForMemberCoordinatable
 public typealias LegacyHomeForMemberPresentable = (vc: HomeForMemberViewControllable, vm: any HomeForMemberViewModelType)
diff --git a/SOPT-iOS/Projects/Features/HomeFeature/Sources/Amplitude/HomeAmplitudeEventPropertyValue.swift b/SOPT-iOS/Projects/Features/HomeFeature/Sources/Amplitude/HomeAmplitudeEventPropertyValue.swift
@@ -0,0 +1,24 @@
+//
+//  HomeAmplitudeEventPropertyValue.swift
+//  HomeFeature
+//
+//  Created by Jae Hyun Lee on 9/6/25.
+//  Copyright © 2025 SOPT-iOS. All rights reserved.
+//
+
+import Foundation
+
+import Core
+
+enum HomeAmplitudeEventPropertyValue: String, AmplitudeEventPropertyValueConvertible {
+    case latestPosts = "latest_posts"
+    case realTimeFeed = "realtime_feed"
+    case homeBanner = "home_banner"
+    case homeFAB = "home_fab"
+    case app = "app"
+    case web = "web"
+
+    func toString() -> String {
+        self.rawValue
+    }
+}
diff --git a/SOPT-iOS/Projects/Features/HomeFeature/Sources/Amplitude/HomeEventTracker.swift b/SOPT-iOS/Projects/Features/HomeFeature/Sources/Amplitude/HomeEventTracker.swift
@@ -0,0 +1,93 @@
+//
+//  HomeEventTracker.swift
+//  HomeFeature
+//
+//  Created by Jae Hyun Lee on 9/6/25.
+//  Copyright © 2025 SOPT-iOS. All rights reserved.
+//
+
+import Foundation
+
+import Core
+import HomeFeatureInterface
+
+struct HomeEventTracker {
+    func trackAmplitude(event: AmplitudeEventType?) {
+        if let event {
+            AmplitudeInstance.shared.trackWithUserType(event: event)
+        }
+    }
+    
+    func trackClickPostMember(
+        postRanking: Int?,
+        sectionName: HomeAmplitudeEventPropertyValue,
+        postID: Int?,
+        category: String
+    ) {
+        let properties = AmplitudeEventPropertyBuilder<HomeAmplitudeEventPropertyValue>()
+            .add(key: .postRanking, value: postRanking)
+            .add(key: .sectionName, value: sectionName)
+            .add(key: .postID, value: postID)
+            .add(key: .category, value: category)
+            .addViewType()
+            .build()
+            
+        AmplitudeInstance.shared.track(eventType: .clickPostMember, eventProperties: properties)
+    }
+    
+    func trackClickPost(
+        postRanking: Int? = 0, // NOTE: 최신 게시물일 경우, 랭킹이 존재하지 않고 0으로 처리합니다.
+        sectionName: HomeAmplitudeEventPropertyValue,
+        postID: Int? = 0,
+        category: String
+    ) {
+        let properties = AmplitudeEventPropertyBuilder<HomeAmplitudeEventPropertyValue>()
+            .add(key: .postRanking, value: postRanking)
+            .add(key: .sectionName, value: sectionName)
+            .add(key: .postID, value: postID)
+            .add(key: .category, value: category)
+            .addViewType()
+            .build()
+        
+        AmplitudeInstance.shared.track(eventType: .clickPost, eventProperties: properties)
+    }
+    
+    func trackClickEmpty(
+        sectionName: HomeAmplitudeEventPropertyValue,
+        category: String
+    ) {
+        let properties = AmplitudeEventPropertyBuilder<HomeAmplitudeEventPropertyValue>()
+            .add(key: .sectionName, value: sectionName)
+            .add(key: .category, value: category)
+            .build()
+        
+        AmplitudeInstance.shared.track(eventType: .clickEmpty, eventProperties: properties)
+    }
+    
+    func trackClickViewAll(
+        sectionName: HomeAmplitudeEventPropertyValue
+    ) {
+        let properties = AmplitudeEventPropertyBuilder<HomeAmplitudeEventPropertyValue>()
+            .add(key: .sectionName, value: sectionName)
+            .build()
+        
+        AmplitudeInstance.shared.track(eventType: .clickViewAll, eventProperties: properties)
+    }
+    
+    func trackClickPromo(
+        sectionName: HomeAmplitudeEventPropertyValue,
+        promoName: String? = nil,
+        destinationURL: String? = nil,
+        destinationType: HomeAmplitudeEventPropertyValue
+    ) {
+        let properties = AmplitudeEventPropertyBuilder<HomeAmplitudeEventPropertyValue>()
+            .add(key: .sectionName, value: sectionName)
+            .add(key: .promoName, value: promoName)
+            .add(key: .destinationURL, value: destinationURL)
+            .add(key: .destinationType, value: destinationType)
+            .build()
+        
+        AmplitudeInstance.shared.track(eventType: .clickPromo, eventProperties: properties)
+    }
+    
+}
diff --git a/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/Cells/DefaultPost/DefaultPostCVC.swift b/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/Cells/DefaultPost/DefaultPostCVC.swift
@@ -29,6 +29,15 @@ enum PostCellType {
     case empty
 }
 
+// 앰플리튜드 이벤트 트래킹을 위한 구조체입니다.
+struct PostInfo {
+    var postRanking: Int? = 0
+    let sectionName: HomeAmplitudeEventPropertyValue
+    var postID: Int? = 0
+    let category: String
+    let userID: Int?
+}
+
 final class DefaultPostCVC: UICollectionViewCell {
     
     // MARK: - Properties
@@ -37,6 +46,13 @@ final class DefaultPostCVC: UICollectionViewCell {
     private let shapeLayer = CAShapeLayer()
     var onAnimationCompleted: (() -> Void)?
     private var isOutlineAnimationCancelled = false
+    private var model: PostInfo?
+    
+    lazy var profileImageViewTap = profileImageView.gesture()
+        .compactMap { [weak self] _ in self?.model }
+        .asDriver()
+    
+    var cancelBag = CancelBag()
         
     // MARK: - UI & Layout
 
@@ -137,6 +153,8 @@ final class DefaultPostCVC: UICollectionViewCell {
         emptySubLabel.text = nil
         emptyTitleLabel.text = nil
         emptyImageView.image = nil
+        cancelBag = CancelBag()
+        model = nil
         profileImageView.setPlaceholder()
         updateVisibility(for: .latest) // visible 상태는 기본적으로 latest와 같음
     }
@@ -333,6 +351,17 @@ extension DefaultPostCVC {
         self.postContentLabel.text = model.content
         self.postContentLabel.setLineSpacing(lineSpacing: 1)
     }
+    
+    // 앰플리튜드 이벤트 트래킹을 위해 세팅합니다.
+    func setPostInfo(model: some PostDisplayable, section: HomeAmplitudeEventPropertyValue) {
+        self.model = PostInfo(
+            postRanking: model.ranking,
+            sectionName: section,
+            postID: model.postID,
+            category: model.category,
+            userID: model.userID
+        )
+    }
 }
 
 
diff --git a/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/CollectionView/Registration/HomeForMemberItemProvider.swift b/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/CollectionView/Registration/HomeForMemberItemProvider.swift
@@ -50,12 +50,28 @@ extension HomeForMemberVC {
     func createPopularPostCellRegistration() -> PopularPostCellRegistration {
         collectionView.createCellRegistration { cell, index, item in
             cell.configureCell(model: item, index: index, cellType: .popular)
+            cell.setPostInfo(model: item, section: .latestPosts)
+            
+            cell.profileImageViewTap
+                .withUnretained(self)
+                .sink { owner, info in
+                    owner.profileImageViewTapped.send(info)
+                }
+                .store(in: cell.cancelBag)
         }
     }
     
     func createLatestPostCellRegistration() -> LatestPostCellRegistration {
         collectionView.createCellRegistration { cell, index, item in
             cell.configureCell(model: item, index: index, cellType: .latest)
+            cell.setPostInfo(model: item, section: .realTimeFeed)
+            
+            cell.profileImageViewTap
+                .withUnretained(self)
+                .sink { owner, info in
+                    owner.profileImageViewTapped.send(info)
+                }
+                .store(in: cell.cancelBag)
         }
     }
     
diff --git a/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/Coordinator/HomeCoordinator.swift b/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/Coordinator/HomeCoordinator.swift
@@ -142,6 +142,12 @@ public final class HomeCoordinator: DefaultHomeCoordinator {
             self.delegate?.homeCoordinator(self, to: .webLink(url: url))
         }
         
+        homeForMember.vm.onProfileImageViewTapped = { [weak self] userID in
+            guard let self else { return }
+            let url = "\(ExternalURL.Playground.main)/members/\(userID)"
+            self.delegate?.homeCoordinator(self, to: .webLink(url: url))
+        }
+        
         rootViewController = homeForMember.vc
         navigationController.pushViewController(homeForMember.vc, animated: true)
     }
diff --git a/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/Coordinator/LegacyHomeCoordinator.swift b/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/Coordinator/LegacyHomeCoordinator.swift
@@ -122,6 +122,11 @@ public final class LegacyHomeCoordinator: DefaultHomeCoordinator {
             self?.requestCoordinating?(.webLink(url: url))
         }
         
+        homeForMember.vm.onProfileImageViewTapped = { [weak self] userID in
+            let url = "\(ExternalURL.Playground.main)/members/\(userID)"
+            self?.requestCoordinating?(.webLink(url: url))
+        }
+        
         rootViewController = homeForMember.vc.viewController
         
         router.push(homeForMember.vc)
diff --git a/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/Models/HomePresentationModel.swift b/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/Models/HomePresentationModel.swift
@@ -72,6 +72,10 @@ struct HomePresentationModel {
         let content: String
         let webLink: String
         let id: String
+        let serverID: Int?
+        let userID: Int?
+        let ranking: Int?
+        let postID: Int?
     }
 
     struct LatestPost: Identifiable, Hashable {
@@ -84,6 +88,10 @@ struct HomePresentationModel {
         let content: String
         let webLink: String
         let isOutdated: Bool
+        let serverID: Int?
+        let userID: Int?
+        let ranking: Int?
+        let postID: Int?
     }
     
     struct Survey: Identifiable, Hashable {
@@ -170,7 +178,11 @@ extension HomePopularPostModel {
             title: self.title,
             content: self.content,
             webLink: self.webLink,
-            id: self.stableID
+            id: self.stableID,
+            serverID: self.id,
+            userID: self.userId,
+            ranking: self.rank,
+            postID: self.id
         )
     }
 }
@@ -193,7 +205,11 @@ extension HomeLatestPostModel {
             title: self.title,
             content: self.content,
             webLink: self.webLink,
-            isOutdated: self.isOutdated
+            isOutdated: self.isOutdated,
+            serverID: self.id,
+            userID: self.userId,
+            ranking: 0, // NOTE: 최신글의 경우 0
+            postID: self.id
         )
     }
 }
diff --git a/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/Models/Protocol/PostDisplayable.swift b/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/Models/Protocol/PostDisplayable.swift
@@ -17,5 +17,8 @@ protocol PostDisplayable {
     var title: String { get }
     var content: String { get }
     var webLink: String { get }
-    var id: String { get } // 서버에서 내려오는 값은 Int?
+    var id: String { get }
+    var postID: Int? { get }
+    var userID: Int? { get }
+    var ranking: Int? { get }
 }
diff --git a/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/VC/HomeForMemberVC.swift b/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/VC/HomeForMemberVC.swift
diff --git a/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/ViewModel/HomeForMemberViewModel.swift b/SOPT-iOS/Projects/Features/HomeFeature/Sources/HomeScene/ViewModel/HomeForMemberViewModel.swift
diff --git a/SOPT-iOS/Projects/Modules/Networks/Sources/Entity/ResponseEntity/HomeLatestPostsResponseEntity.swift b/SOPT-iOS/Projects/Modules/Networks/Sources/Entity/ResponseEntity/HomeLatestPostsResponseEntity.swift
diff --git a/SOPT-iOS/Projects/Modules/Networks/Sources/Entity/ResponseEntity/HomePopularPostsResponseEntity.swift b/SOPT-iOS/Projects/Modules/Networks/Sources/Entity/ResponseEntity/HomePopularPostsResponseEntity.swift

Original file line number	Diff line number	Diff line change
`@@ -22,7 +22,8 @@ extension HomeLatestPostsResponseEntity {`
`22`	`22`	`content: self.content,`
`23`	`23`	`webLink: self.webLink,`
`24`	`24`	`id: self.id,`
`25`		`- isOutdated: self.isOutdated`
	`25`	`+ isOutdated: self.isOutdated,`
	`26`	`+ userId: self.userId`
`26`	`27`	`)`
`27`	`28`	`}`
`28`	`29`	`}`
Original file line number	Diff line number	Diff line change
`@@ -22,7 +22,8 @@ extension HomePopularPostsResponseEntity {`
`22`	`22`	`title: self.title,`
`23`	`23`	`content: self.content,`
`24`	`24`	`webLink: self.webLink,`
`25`		`- id: self.id`
	`25`	`+ id: self.id,`
	`26`	`+ userId: self.userId`
`26`	`27`	`)`
`27`	`28`	`}`
`28`	`29`	`}`
Original file line number	Diff line number	Diff line change
`@@ -29,6 +29,7 @@ public protocol HomeForMemberCoordinatable {`
`29`	`29`	`var onPopularPostCellTapped: ((String) -> Void)? { get set }`
`30`	`30`	`var onLatestPostCellTapped: ((String) -> Void)? { get set }`
`31`	`31`	`var onViewAllContentButtonTapped: ((String) -> Void)? { get set }`
	`32`	`+ var onProfileImageViewTapped: ((Int) -> Void)? { get set }`
`32`	`33`	`}`
`33`	`34`	`public typealias HomeForMemberViewModelType = ViewModelType & HomeForMemberCoordinatable`
`34`	`35`	`public typealias LegacyHomeForMemberPresentable = (vc: HomeForMemberViewControllable, vm: any HomeForMemberViewModelType)`