Firebase Summit에서 발표된 모든 내용을 살펴보고 Firebase로 앱을 빠르게 개발하고 안심하고 앱을 실행하는 방법을 알아보세요. 자세히 알아보기

Google 애널리틱스 시작하기

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 빠른 시작에서는 앱에 Google 애널리틱스를 추가하고 이벤트 로깅을 시작하는 방법을 보여줍니다.

Google 애널리틱스는 앱의 사용 및 동작 데이터를 수집합니다. SDK는 두 가지 기본 유형의 정보를 기록합니다.

  • 이벤트: 사용자 작업, 시스템 이벤트 또는 오류와 같이 앱에서 발생하는 것입니다.
  • 사용자 속성: 언어 기본 설정 또는 지리적 위치와 같은 사용자 기반 세그먼트를 설명하기 위해 정의하는 속성입니다.

Analytics는 일부 이벤트사용자 속성 을 자동으로 기록합니다. 활성화하기 위해 코드를 추가할 필요가 없습니다.

시작하기 전에

  1. 아직 추가하지 않은 경우 Apple 프로젝트에 Firebase를 추가 하고 Firebase 프로젝트에서 Google 애널리틱스가 활성화되어 있는지 확인합니다.

    • 새 Firebase 프로젝트를 만드는 경우 프로젝트 생성 워크플로 중에 Google 애널리틱스를 활성화하세요.

    • Google 애널리틱스가 활성화되지 않은 기존 Firebase 프로젝트를 사용하는 경우 > 프로젝트 설정통합 탭으로 이동하여 활성화하세요.

    프로젝트에서 Google 애널리틱스를 사용 설정하면 Firebase 앱이 Google 애널리틱스 데이터 스트림에 연결됩니다.

  2. (권장) . 프로젝트에 AdSupport 프레임워크를 추가하여 청중 및 캠페인 속성과 같은 추가 기능을 활성화하십시오.

앱에 애널리틱스 SDK 추가

Swift Package Manager를 사용하여 Firebase 종속 항목을 설치하고 관리합니다.

  1. Xcode에서 앱 프로젝트를 연 상태에서 File > Add Packages 로 이동합니다.
  2. 메시지가 표시되면 Firebase Apple 플랫폼 SDK 저장소를 추가합니다.
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Analytics 라이브러리를 선택합니다.
  5. 애널리틱스 사용 환경을 최적화하려면 Firebase 프로젝트에서 Google 애널리틱스를 사용 설정하고 앱에 Google 애널리틱스용 Firebase SDK를 추가하는 것이 좋습니다. IDFA 수집이 없는 라이브러리 또는 IDFA 수집이 있는 라이브러리를 선택할 수 있습니다.
  6. 완료되면 Xcode는 자동으로 백그라운드에서 종속성을 해결하고 다운로드하기 시작합니다.

Apple의 사용자 개인 정보 및 데이터 사용앱 추적 투명성 문서에서 기기 수준 광고 식별자인 IDFA에 대해 자세히 알아보세요.

다음으로 몇 가지 구성 단계를 수행합니다.

  1. 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;
    // ...
          
  2. 앱 대리인의 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];
  3. 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() 메서드를 사용하여 이벤트 기록을 시작할 수 있습니다.

모든 앱에 대해 특정 이벤트가 권장됩니다 . 다른 것들은 특정 비즈니스 유형이나 업종에 권장됩니다. 제안된 이벤트를 규정된 매개변수와 함께 전송하여 보고서에서 사용 가능한 세부 정보를 최대한 확보하고 향후 기능 및 통합이 제공될 때 이점을 활용해야 합니다. 이 섹션은 미리 정의된 이벤트를 기록하는 방법을 보여줍니다. 이벤트 기록에 대한 자세한 내용은 이벤트 기록을 참조 하십시오 .

다음 예제는 사용자가 앱의 특정 요소를 클릭했음을 나타내기 위해 권장 이벤트를 기록하는 방법을 보여줍니다.

빠른

참고: 이 Firebase 제품은 macOS 대상에서 사용할 수 없습니다.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

목표-C

참고: 이 Firebase 제품은 macOS 대상에서 사용할 수 없습니다.
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

Xcode 디버그 콘솔에서 이 이벤트를 보려면 Analytics 디버깅을 활성화하십시오.

  1. Xcode에서 제품 > 체계 > 체계 편집... 을 선택합니다.
  2. 왼쪽 메뉴에서 실행 을 선택합니다.
  3. 인수 탭을 선택합니다.
  4. 시작 시 전달되는 인수 섹션에서 -FIRAnalyticsDebugEnabled 를 추가합니다.

다음 단계