Google 애널리틱스 시작하기

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

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

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

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

시작하기 전에

아직 추가하지 않았다면 Apple 프로젝트에 Firebase를 추가합니다. Firebase에서 Google Analytics가 사용 설정되어 있는지 확인합니다. 프로젝트:
- 새 Firebase 프로젝트를 만드는 경우 Google Analytics를 사용 설정합니다. 프로젝트 생성 워크플로에서 작성할 수 있습니다
- 기존 Firebase 프로젝트를 사용하면 Google Analytics 사용 설정됨, 다음으로 이동: 통합 > 탭 프로젝트 설정을 클릭하여 사용 설정합니다.
경고: 2019년 7월 31일 이전에 만든 모든 Firebase 프로젝트는 전체 Google 애널리틱스 4 환경 선택할 수 있습니다 (Analytics 업그레이드가 필요합니다.) 연결된 서비스 약관은 2022년 2월 15일까지 동의 데이터 수집을 계속할 수 있습니다 업그레이드에 대한 지원 FAQ 를 참조하세요. 프로젝트 소유자 찾기

프로젝트에서 Google Analytics를 사용 설정하면 Firebase 앱이 데이터 스트림 Google Analytics개에 연결되어 있습니다.
(권장) 프로젝트에 AdSupport 프레임워크를 추가하여 잠재고객 및 캠페인 기여 분석과 같은 추가 기능을 사용 설정합니다.

앱에 Analytics SDK 추가

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

앱 프로젝트를 연 상태로 Xcode에서 File(파일) > Add Packages(패키지 추가)로 이동합니다.
메시지가 표시되면 Firebase Apple 플랫폼 SDK 저장소를 추가합니다.

  https://github.com/firebase/firebase-ios-sdk.git

Analytics 라이브러리를 선택합니다.
타겟 빌드 설정의 Other Linker Flags(기타 링커 플래그) 섹션에 -ObjC 플래그를 추가합니다.
Analytics 사용 환경을 최적화하려면 다음을 권장합니다. Google Analytics 사용 설정 Google 애널리틱스용 Firebase SDK를 앱에 추가하면 됩니다. 다음을 수행할 수 있습니다. IDFA 수집이 없는 라이브러리 또는 IDFA 수집이 있는 라이브러리를 선택하세요.
완료되면 Xcode가 백그라운드에서 자동으로 종속 항목을 확인하고 다운로드하기 시작합니다.

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

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

UIApplicationDelegate의 FirebaseCore 모듈과 앱 대리자가 사용하는 다른 Firebase 모듈을 가져옵니다. 예를 들어 Cloud Firestore 및 Authentication를 사용하려면 다음을 실행합니다.

SwiftUI

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

Swift

import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

Objective-C

@import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...

앱 대리자의 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];

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() 메서드를 사용하여 이벤트 로깅을 시작할 수 있습니다.

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

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

Swift

참고: 이 Firebase 제품은 macOS 대상에서 사용할 수 없습니다.

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])ViewController.swift

Objective-C

참고: 이 Firebase 제품은 macOS 대상에서 사용할 수 없습니다.

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];ViewController.m

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

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

다음 단계

각 애널리틱스 보고서 이해하기
DebugView를 사용하여 이벤트를 확인합니다.
Firebase 콘솔에서 데이터를 살펴보세요.
이벤트 및 사용자 속성에 대한 가이드를 살펴봅니다.
BigQuery로 데이터를 내보내는 방법을 알아봅니다.