이 빠른 시작에서는 앱에 Google 애널리틱스를 추가하고 이벤트 로깅을 시작하는 방법을 보여줍니다.
Google 애널리틱스는 앱의 사용 및 동작 데이터를 수집합니다. SDK는 두 가지 기본 유형의 정보를 기록합니다.
- 이벤트: 사용자 작업, 시스템 이벤트 또는 오류와 같이 앱에서 발생하는 것입니다.
- 사용자 속성: 언어 기본 설정 또는 지리적 위치와 같은 사용자 기반 세그먼트를 설명하기 위해 정의하는 속성입니다.
Analytics는 일부 이벤트 및 사용자 속성 을 자동으로 기록합니다. 활성화하기 위해 코드를 추가할 필요가 없습니다.
시작하기 전에
아직 추가하지 않은 경우 Apple 프로젝트에 Firebase를 추가 하고 Firebase 프로젝트에서 Google 애널리틱스가 활성화되어 있는지 확인합니다.
새 Firebase 프로젝트를 만드는 경우 프로젝트 생성 워크플로 중에 Google 애널리틱스를 활성화하세요.
Google 애널리틱스가 활성화되지 않은 기존 Firebase 프로젝트를 사용하는 경우 통합 탭으로 이동하여 활성화하세요.
> 프로젝트 설정 의
프로젝트에서 Google 애널리틱스를 사용 설정하면 Firebase 앱이 Google 애널리틱스 데이터 스트림에 연결됩니다.
(권장) . 프로젝트에 AdSupport 프레임워크를 추가하여 청중 및 캠페인 속성과 같은 추가 기능을 활성화하십시오.
앱에 애널리틱스 SDK 추가
Swift Package Manager를 사용하여 Firebase 종속 항목을 설치하고 관리합니다.
- Xcode에서 앱 프로젝트를 연 상태에서 File > Add Packages 로 이동합니다.
- 메시지가 표시되면 Firebase Apple 플랫폼 SDK 저장소를 추가합니다.
- Analytics 라이브러리를 선택합니다.
- 애널리틱스 사용 환경을 최적화하려면 Firebase 프로젝트에서 Google 애널리틱스를 사용 설정하고 앱에 Google 애널리틱스용 Firebase SDK를 추가하는 것이 좋습니다. IDFA 수집이 없는 라이브러리 또는 IDFA 수집이 있는 라이브러리를 선택할 수 있습니다.
- 완료되면 Xcode는 자동으로 백그라운드에서 종속성을 해결하고 다운로드하기 시작합니다.
https://github.com/firebase/firebase-ios-sdk
Apple의 사용자 개인 정보 및 데이터 사용 및 앱 추적 투명성 문서에서 기기 수준 광고 식별자인 IDFA에 대해 자세히 알아보세요.
다음으로 몇 가지 구성 단계를 수행합니다.
-
UIApplicationDelegate
에서 FirebaseCore 모듈과 앱 대리인이 사용하는 다른 모든FirebaseCore
모듈 을 가져옵니다. 예를 들어 Cloud Firestore 및 인증을 사용하려면 다음과 같이 하세요.SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
빠른
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
목표-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- 앱 대리인의
application(_:didFinishLaunchingWithOptions:)
메서드에서FirebaseApp
공유 인스턴스를 구성합니다.SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
빠른
// Use Firebase library to configure APIs FirebaseApp.configure()
목표-C
// Use Firebase library to configure APIs [FIRApp configure];
- SwiftUI를 사용하는 경우 애플리케이션 대리자를 생성하고
UIApplicationDelegateAdaptor
또는NSApplicationDelegateAdaptor
를 통해App
구조체에 연결해야 합니다. 앱 대리자 스위즐링도 비활성화해야 합니다. 자세한 내용은 SwiftUI 지침 을 참조하십시오.SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
(선택 사항) Apple 광고 네트워크 속성 등록 비활성화
귀하의 편의를 위해 SDK는 SKAdNetwork 를 통한 광고 네트워크 속성을 위해 귀하의 앱을 Apple에 자동으로 등록 합니다. 이 기능을 비활성화하려면 앱의 info.plist 파일에서 GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
값을 NO
(부울)로 설정하세요.
로깅 이벤트 시작
FirebaseApp
인스턴스를 구성한 후 logEvent()
메서드를 사용하여 이벤트 기록을 시작할 수 있습니다.
모든 앱에 대해 특정 이벤트가 권장됩니다 . 다른 것들은 특정 비즈니스 유형이나 업종에 권장됩니다. 제안된 이벤트를 규정된 매개변수와 함께 전송하여 보고서에서 사용 가능한 세부 정보를 최대한 확보하고 향후 기능 및 통합이 제공될 때 이점을 활용해야 합니다. 이 섹션은 미리 정의된 이벤트를 기록하는 방법을 보여줍니다. 이벤트 기록에 대한 자세한 내용은 이벤트 기록을 참조 하십시오 .
다음 예제는 사용자가 앱의 특정 요소를 클릭했음을 나타내기 위해 권장 이벤트를 기록하는 방법을 보여줍니다.
빠른
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
목표-C
[FIRAnalytics logEventWithName:kFIREventSelectContent parameters:@{ kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title], kFIRParameterItemName:self.title, kFIRParameterContentType:@"image" }];
Xcode 디버그 콘솔에서 이 이벤트를 보려면 Analytics 디버깅을 활성화하십시오.
- Xcode에서 제품 > 체계 > 체계 편집... 을 선택합니다.
- 왼쪽 메뉴에서 실행 을 선택합니다.
- 인수 탭을 선택합니다.
- 시작 시 전달되는 인수 섹션에서
-FIRAnalyticsDebugEnabled
를 추가합니다.
다음 단계
- DebugView 를 사용하여 이벤트를 확인하십시오.
- Firebase 콘솔에서 데이터를 탐색하세요.
- 이벤트 및 사용자 속성에 대한 가이드를 살펴보세요.
- 데이터를 BigQuery로 내보내는 방법을 알아보세요.