Google 애널리틱스 시작하기


이 빠른 시작에서는 Google Analytics를 앱에 추가하고 이벤트 로깅을 시작합니다.

Google Analytics에서 앱의 사용 현황 및 행동 데이터를 수집합니다. SDK 다음과 같은 두 가지 기본 유형의 정보를 기록합니다.

  • 이벤트: 사용자 행동, 시스템 이벤트, 오류 등 앱에서 발생하는 상황입니다.
  • 사용자 속성: 사용자층을 나눈 세그먼트를 기술하고자 개발자가 정의하는 언어 환경설정, 지리적 위치 등의 속성입니다.

Analytics에서 자동으로 이벤트사용자 속성 별도의 코드를 추가하지 않아도 됩니다.

시작하기 전에

  1. 아직 추가하지 않았다면 Apple 프로젝트에 Firebase를 추가합니다. Firebase에서 Google Analytics가 사용 설정되어 있는지 확인합니다. 프로젝트:

    • 새 Firebase 프로젝트를 만드는 경우 Google Analytics를 사용 설정합니다. 프로젝트 생성 워크플로에서 작성할 수 있습니다

    • 기존 Firebase 프로젝트를 사용하면 Google Analytics 사용 설정됨, 다음으로 이동: 통합 > 탭 프로젝트 설정을 클릭하여 사용 설정합니다.

    프로젝트에서 Google Analytics를 사용 설정하면 Firebase 앱이 데이터 스트림 Google Analytics개에 연결되어 있습니다.

  2. (권장) 프로젝트에 AdSupport 프레임워크를 추가하여 잠재고객 및 캠페인 기여 분석과 같은 추가 기능을 사용 설정합니다.

앱에 Analytics SDK 추가

Swift Package Manager를 사용해 Firebase 종속 항목을 설치하고 관리하세요.

  1. 앱 프로젝트를 연 상태로 Xcode에서 File(파일) > Add Packages(패키지 추가)로 이동합니다.
  2. 메시지가 표시되면 Firebase Apple 플랫폼 SDK 저장소를 추가합니다.
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Analytics 라이브러리를 선택합니다.
  5. 타겟 빌드 설정의 Other Linker Flags(기타 링커 플래그) 섹션에 -ObjC 플래그를 추가합니다.
  6. Analytics 사용 환경을 최적화하려면 다음을 권장합니다. Google Analytics 사용 설정 Google 애널리틱스용 Firebase SDK를 앱에 추가하면 됩니다. 다음을 수행할 수 있습니다. IDFA 수집이 없는 라이브러리 또는 IDFA 수집이 있는 라이브러리를 선택하세요.
  7. 완료되면 Xcode가 백그라운드에서 자동으로 종속 항목을 확인하고 다운로드하기 시작합니다.

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

그런 다음 몇 가지 구성 단계를 따릅니다.

  1. UIApplicationDelegateFirebaseCore 모듈과 앱 대리자가 사용하는 다른 Firebase 모듈을 가져옵니다. 예를 들어 Cloud FirestoreAuthentication를 사용하려면 다음을 실행합니다.

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Swift

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. 앱 대리자의 application(_:didFinishLaunchingWithOptions:) 메서드에서 FirebaseApp 공유 인스턴스를 구성합니다.

    SwiftUI

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-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_ENABLEDNO(불리언)로 설정합니다.

이벤트 로깅 시작

FirebaseApp 인스턴스를 구성한 후에는 logEvent() 메서드를 사용하여 이벤트 로깅을 시작할 수 있습니다.

모든 앱에 권장되는 특정 이벤트가 있으며 특정 비즈니스 유형이나 카테고리에 권장되는 이벤트가 있습니다. 추천 이벤트를 사전 정의된 매개변수와 함께 전송해야 합니다. 이렇게 하면 보고서에 세부정보가 최대한 포함되고 향후 기능 및 통합을 즉시 사용할 수 있습니다. 이 섹션에서는 사전 정의된 이벤트 로깅을 보여줍니다. 이벤트 로깅에 대한 자세한 내용은 이벤트 로깅을 참조하세요.

다음 예시에서는 사용자가 앱의 특정 요소를 클릭했음을 나타내는 추천 이벤트를 로깅하는 방법을 보여줍니다.

Swift

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

Objective-C

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

Xcode 디버그 콘솔에서 이 이벤트를 보려면 애널리틱스 디버깅을 사용 설정합니다.

  1. Xcode에서 Product(제품) > Scheme(스킴) > Edit scheme(스킴 수정)을 선택합니다.
  2. 왼쪽 메뉴에서 Run(실행)을 선택합니다.
  3. Arguments(인수) 탭을 선택합니다.
  4. Arguments Passed On Launch(실행 시 전달 인수) 섹션에 -FIRAnalyticsDebugEnabled를 추가합니다.

다음 단계