[feat] #208 amplitude - 링크 상세, 저장

ShapeKim98 · ShapeKim98 · commit 1d8e15e85f1e · 2025-11-25T19:36:26.000+09:00
diff --git a/Projects/CoreKit/Sources/Core/Analytics/AnalyticsEvent.swift b/Projects/CoreKit/Sources/Core/Analytics/AnalyticsEvent.swift
@@ -11,9 +11,9 @@ public enum AnalyticsEvent {
     case view_home_pokit(entryPoint: String)
     case view_home_recommend(entryPoint: String)
     case add_folder(folderName: String)
-    case add_link(folderId: String, linkDomain: String)
+    case add_link(folderId: String, linkDomain: String, entryPoint: String? = nil, linkId: String? = nil, positionIndex: Int? = nil, algoVersion: String? = nil)
     case view_folder_detail(folderId: String)
-    case view_link_detail(linkId: String, linkDomain: String)
+    case view_link_detail(linkId: String, linkDomain: String, entryPoint: String? = nil, positionIndex: Int? = nil, cardType: String? = nil, algoVersion: String? = nil)
     case share_link(linkId: String, shareTarget: String)
     case session_end(duration: Int)
 
@@ -70,20 +70,46 @@ public enum AnalyticsEvent {
         case let .add_folder(folderName):
             return [PropertyKey.folder_name.rawValue: folderName]
 
-        case let .add_link(folderId, linkDomain):
-            return [
+        case let .add_link(folderId, linkDomain, entryPoint, linkId, positionIndex, algoVersion):
+            var props: [String: Any] = [
                 PropertyKey.folder_id.rawValue: folderId,
                 PropertyKey.link_domain.rawValue: linkDomain
             ]
+            if let entryPoint = entryPoint {
+                props[PropertyKey.entry_point.rawValue] = entryPoint
+            }
+            if let linkId = linkId {
+                props[PropertyKey.link_id.rawValue] = linkId
+            }
+            if let positionIndex = positionIndex {
+                props[PropertyKey.position_index.rawValue] = positionIndex
+            }
+            if let algoVersion = algoVersion {
+                props[PropertyKey.algo_version.rawValue] = algoVersion
+            }
+            return props
 
         case let .view_folder_detail(folderId):
             return [PropertyKey.folder_id.rawValue: folderId]
 
-        case let .view_link_detail(linkId, linkDomain):
-            return [
+        case let .view_link_detail(linkId, linkDomain, entryPoint, positionIndex, cardType, algoVersion):
+            var props: [String: Any] = [
                 PropertyKey.link_id.rawValue: linkId,
                 PropertyKey.link_domain.rawValue: linkDomain
             ]
+            if let entryPoint = entryPoint {
+                props[PropertyKey.entry_point.rawValue] = entryPoint
+            }
+            if let positionIndex = positionIndex {
+                props[PropertyKey.position_index.rawValue] = positionIndex
+            }
+            if let cardType = cardType {
+                props[PropertyKey.card_type.rawValue] = cardType
+            }
+            if let algoVersion = algoVersion {
+                props[PropertyKey.algo_version.rawValue] = algoVersion
+            }
+            return props
 
         case let .share_link(linkId, shareTarget):
             return [
@@ -110,6 +136,9 @@ public enum PropertyKey: String {
     case link_id
     case share_target
     case duration
+    case position_index
+    case card_type
+    case algo_version
 }
 
 /// 로그인 방식
diff --git a/Projects/CoreKit/Sources/Data/Network/Content/ContentClient+LiveKey.swift b/Projects/CoreKit/Sources/Data/Network/Content/ContentClient+LiveKey.swift
@@ -18,13 +18,7 @@ extension ContentClient: DependencyKey {
                 try await provider.requestNoBody(.컨텐츠_삭제(contentId: id))
             },
             컨텐츠_상세_조회: { id in
-                let response: ContentDetailResponse
-                response = try await provider.request(.컨텐츠_상세_조회(contentId: id))
-                amplitudeTrack(.view_link_detail(
-                    linkId: "\(id)",
-                    linkDomain: response.data
-                ))
-                return response
+                try await provider.request(.컨텐츠_상세_조회(contentId: id))
             },
             컨텐츠_수정: { id, model in
                 try await provider.request(.컨텐츠_수정(contentId: id, model: model))
diff --git a/Projects/Feature/FeatureContentCard/Sources/ContentCard/ContentCardFeature.swift b/Projects/Feature/FeatureContentCard/Sources/ContentCard/ContentCardFeature.swift
@@ -21,6 +21,9 @@ public struct ContentCardFeature {
     private var openURL
     @Dependency(ContentClient.self)
     private var contentClient
+    @Dependency(\.amplitude.track)
+    private var amplitudeTrack
+    
     /// - State
     @ObservableState
     public struct State: Equatable, Identifiable {
@@ -113,7 +116,11 @@ private extension ContentCardFeature {
             guard let url = URL(string: state.content.data) else {
                 return .none
             }
-            return .run {  send in
+            return .run { [content = state.content]  send in
+                amplitudeTrack(.view_link_detail(
+                    linkId: "\(content.id)",
+                    linkDomain: content.data
+                ))
                 await send(.async(.컨텐츠_상세_조회_API))
                 await openURL(url)
             }
diff --git a/Projects/Feature/FeatureContentSetting/Sources/ContentSetting/ContentSettingFeature.swift b/Projects/Feature/FeatureContentSetting/Sources/ContentSetting/ContentSettingFeature.swift
@@ -444,7 +444,11 @@ private extension ContentSettingFeature {
                 thumbNail: state.domain.thumbNail
             )
             return .run { send in
-                let content = try await contentClient.컨텐츠_추가(request)
+                let response = try await contentClient.컨텐츠_추가(request)
+                amplitudeTrack(.add_link(
+                    folderId: "\(response.contentId)",
+                    linkDomain: response.data
+                ))
                 await send(.inner(.선택한_포킷_인메모리_삭제))
                 await send(.delegate(.저장하기_완료(category: category)))
             } catch: { error, send in
diff --git a/Projects/Feature/FeatureRecommend/Sources/Recommend/RecommendFeature.swift b/Projects/Feature/FeatureRecommend/Sources/Recommend/RecommendFeature.swift
@@ -23,6 +23,9 @@ public struct RecommendFeature {
     private var categoryClient
     @Dependency(\.openURL)
     private var openURL
+    @Dependency(\.amplitude.track)
+    private var amplitudeTrack
+    
     /// - State
     @ObservableState
     public struct State: Equatable {
@@ -87,7 +90,7 @@ public struct RecommendFeature {
             case 링크_공유_완료되었을때
             case 검색_버튼_눌렀을때
             case 알림_버튼_눌렀을때
-            case 추천_컨텐츠_눌렀을때(String)
+            case 추천_컨텐츠_눌렀을때(BaseContentItem)
             case 경고시트_dismiss
             case 포킷선택_항목_눌렀을때(pokit: BaseCategoryItem)
             case 포킷_추가하기_버튼_눌렀을때
@@ -211,8 +214,17 @@ private extension RecommendFeature {
             return .send(.delegate(.검색_버튼_눌렀을때))
         case .알림_버튼_눌렀을때:
             return .send(.delegate(.알림_버튼_눌렀을때))
-        case let .추천_컨텐츠_눌렀을때(urlString):
-            guard let url = URL(string: urlString) else { return .none }
+        case let .추천_컨텐츠_눌렀을때(content):
+            guard let url = URL(string: content.data) else { return .none }
+            let index = state.recommendedList?.index(id: content.id)
+            amplitudeTrack(.view_link_detail(
+                linkId: "\(content.id)",
+                linkDomain: content.data,
+                entryPoint: "recommend",
+                positionIndex: index,
+                cardType: "list",
+                algoVersion: "v1.2"
+            ))
             return .run { _ in await openURL(url) }
         case .관심사_편집_버튼_눌렀을때:
             state.showKeywordSheet = true
@@ -355,12 +367,8 @@ private extension RecommendFeature {
             )
             return categoryListFetch(request: request)
         case .컨텐츠_추가_API:
-            guard
-                let categoryId = state.selectedPokit?.id,
-                let category = state.domain.categoryListInQuiry.data?.first(where: {
-                    $0.id == categoryId
-                }),
-                let content = state.addContent
+            guard let categoryId = state.selectedPokit?.id,
+                  let content = state.addContent
             else { return .none }
             let request = ContentBaseRequest(
                 data: content.data,
@@ -370,8 +378,17 @@ private extension RecommendFeature {
                 alertYn: "NO",
                 thumbNail: content.thumbNail
             )
+            let index = state.recommendedList?.index(id: content.id)
             return .run { send in
-                let content = try await contentClient.컨텐츠_추가(request)
+                let response = try await contentClient.컨텐츠_추가(request)
+                amplitudeTrack(.add_link(
+                    folderId: "\(categoryId)",
+                    linkDomain: content.data,
+                    entryPoint: "recommend",
+                    linkId: "\(response.contentId)",
+                    positionIndex: index,
+                    algoVersion: "v1.2"
+                ))
                 await send(.delegate(.저장하기_완료))
             }
         }
diff --git a/Projects/Feature/FeatureRecommend/Sources/Recommend/RecommendView.swift b/Projects/Feature/FeatureRecommend/Sources/Recommend/RecommendView.swift
@@ -196,7 +196,7 @@ private extension RecommendView {
     
     @ViewBuilder
     func recommendedCard(_ content: BaseContentItem) -> some View {
-        Button(action: { send(.추천_컨텐츠_눌렀을때(content.data)) }) {
+        Button(action: { send(.추천_컨텐츠_눌렀을때(content)) }) {
             recomendedCardLabel(content)
         }
     }

Original file line number	Diff line number	Diff line change
`@@ -196,7 +196,7 @@ private extension RecommendView {`
`196`	`196`
`197`	`197`	`@ViewBuilder`
`198`	`198`	`func recommendedCard(_ content: BaseContentItem) -> some View {`
`199`		`- Button(action: { send(.추천_컨텐츠_눌렀을때(content.data)) }) {`
	`199`	`+ Button(action: { send(.추천_컨텐츠_눌렀을때(content)) }) {`
`200`	`200`	`recomendedCardLabel(content)`
`201`	`201`	`}`
`202`	`202`	`}`