이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Google Ads에서 Firebase용 Google 애널리틱스 맞춤 이벤트 - iOS

1. 소개

최종 업데이트: 2020년 12월 14일

빌드할 항목

이 Codelab에서는 GA4F iOS SDK로 맞춤 이벤트를 구현하고 Google Ads를 통해 액션 캠페인을 실행하는 방법을 알아봅니다.

이 Codelab을 통해 Google 고객이 직면한 앱 비즈니스의 전체 프로세스를 경험할 수 있습니다. Firebase iOS에 대한 대략적인 소개를 알아보려면 Firebase iOS Codelab Swift를 시작하세요.

학습할 내용

iOS Swift에서 GA4F(Firebase용 Google 애널리틱스)를 초기화하는 방법
맞춤 이벤트 및 매개변수를 만드는 방법
Firebase에서 Google Ads로 이벤트를 가져오는 방법
맞춤 이벤트로 액션 캠페인 실행

필요한 항목

Xcode
Firebase 계정
Google Ads 계정

2. 새 iOS Swift 프로젝트 시작

간단한 템플릿 형식의 iOS Swift 앱을 만듭니다. 이 시작 앱을 수정하여 완성된 앱을 만듭니다.

먼저 Xcode를 실행합니다.

열려 있는 프로젝트가 없다면 시작 페이지에서 'Create a new Xcode project'를 선택합니다.
대화상자 상단에서 iOS를 선택합니다.
Application 섹션에서 App을 선택하고 Next를 클릭합니다.
대화상자가 표시되면 다음 값을 사용하여 앱 이름을 지정하고 프로젝트의 추가 옵션을 선택한 다음 '다음'을 클릭합니다.
제품 이름: 예: ios-app

Xcode는 입력한 제품 이름을 사용하여 프로젝트 및 앱의 이름을 지정합니다.

팀: 자동으로 입력되지 않는 경우 팀을 없음으로 설정합니다.
조직 이름: 조직의 이름 또는 본인의 이름입니다.
번들 식별자: 이 값은 제품 이름 및 조직 식별자에 따라 자동으로 생성됩니다.
언어: Swift
프로젝트를 저장할 위치를 선택하고 '만들기'를 클릭합니다.
Xcode에서 작업 공간 창에 새 프로젝트가 열립니다.

3. Firebase 프로젝트 만들기 및 설정

Firebase를 시작하려면 Firebase 프로젝트를 만들고 설정해야 합니다.

Firebase 프로젝트 만들기

기존 Firebase 프로젝트가 있지만 Google 애널리틱스가 사용 설정되지 않은 경우 설정 > 프로젝트 설정의 통합 탭에서 Google 애널리틱스를 사용 설정할 수 있습니다. Firebase 구성 단계로 이동합니다.

Firebase에 로그인합니다.

Firebase Console에서 프로젝트 추가(또는 프로젝트 만들기)를 클릭하고 Firebase 프로젝트의 이름을 Firebase-iOS-Ads로 지정합니다.

프로젝트 만들기 옵션을 클릭하며 살펴봅니다. 메시지가 표시되면 Firebase 약관에 동의합니다. 액션 이벤트 및 전환을 추적하려면 Google 애널리틱스 이벤트가 필요하므로 이 프로젝트에 Google 애널리틱스를 사용 설정해야 합니다.

Firebase 프로젝트에 관해 자세히 알아보려면 Firebase 프로젝트 이해를 참고하세요.

4. Firebase 구성

Firebase Console의 왼쪽 탐색 메뉴에서 '프로젝트 개요' > '프로젝트 설정'을 선택한 후 '일반' > '내 앱'에서 iOS 버튼을 클릭합니다.

다음 화면과 같은 대화상자가 표시됩니다.

제공해야 할 중요한 값은 iOS 번들 ID이며 다음 단계에 따라 가져옵니다.
iOS 앱용 Xcode 프로젝트의 프로젝트 탐색기에서 최상위 앱을 선택한 다음 General(일반) 탭을 선택합니다.
번들 식별자 필드의 값이 iOS 번들 ID (예: com.yourcompany.yourproject)입니다. 이 값을 복사합니다.
Firebase 대화상자에서 복사한 번들 ID를 iOS bundle ID 필드에 붙여넣습니다.
앱 등록을 클릭합니다.
Firebase에서 계속 진행하여 안내에 따라 구성 파일 GoogleService-Info.plist을 다운로드합니다.

Xcode 프로젝트로 이동한 다음 방금 다운로드한 GoogleService-Info.plist 파일을 Xcode 프로젝트의 루트로 이동합니다.
나머지 단계를 건너뛰고 Firebase Console의 기본 페이지로 돌아갑니다.

5. Xcode에서 Firebase 애널리틱스 구성

이 단계에서는 Xcode 프로젝트에 Firebase SDK를 추가합니다.

터미널 창을 열고 앱의 Xcode 프로젝트 위치로 이동합니다.
Podfile이 없는 경우 다음 명령어로 새로 만드세요.

$ pod init

Podfile을 열고 다음을 추가합니다.

$ vi Podfile

$ pod 'Firebase/Analytics'

파일을 저장하고 다음을 실행합니다.

$ pod install

초기화 코드 추가:

앱을 시작할 때 Firebase에 연결하려면 기본 AppDelegate 클래스에 아래의 초기화 코드를 추가하세요.

import UIKit
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
      [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    return true
  }
}

완료되었습니다. 콘솔로 이동

이제 맞춤 이벤트 로그를 실행할 준비가 되었습니다.

6. Firebase 애널리틱스로 맞춤 이벤트 로깅

이 단계에서는 iOS 앱에서 Firebase Analytics로 맞춤 이벤트를 기록하는 방법을 알아봅니다.

Firebase 애널리틱스는 몇 가지 이벤트를 자동으로 로깅하며 별도의 코드 없이 이벤트를 수신할 수 있습니다. 앱에서 데이터를 추가로 수집해야 하는 경우 앱에서 최대 500개의 서로 다른 애널리틱스 맞춤 이벤트 유형을 기록할 수 있습니다.

로그 이벤트

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

Analytics.logEvent("text_search", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

기본 이벤트 매개변수 설정

setDefaultEventParameters를 사용하여 이벤트 간에 매개변수를 로깅할 수 있습니다. 기본 매개변수는 이후에 로깅되는 모든 이벤트와 연결됩니다.

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Xcode 디버그 콘솔에서 이벤트 보기

상세 로깅을 사용 설정하여 SDK의 이벤트 로깅을 모니터링하면 이벤트가 제대로 로깅되는지 확인할 수 있습니다. 여기에는 자동으로 로깅되는 이벤트와 수동으로 로깅되는 이벤트가 모두 포함됩니다.

다음과 같이 상세 로깅을 사용 설정할 수 있습니다.

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

다음에 앱을 실행하면 Xcode 디버그 콘솔에 이벤트가 표시되어 이벤트 전송 여부를 즉시 확인할 수 있습니다.

대시보드에서 이벤트 보기

몇 시간 후에 Firebase Console에 로깅된 이벤트가 표시됩니다. 애널리틱스 → 이벤트에 있습니다. 이벤트를 클릭하여 매개변수 값을 찾을 수도 있습니다.

'전환으로 표시' 스위치를 오른쪽으로 슬라이드하여 'text_search'를 전환으로 표시합니다.

Firebase 애널리틱스 전환 탭을 통해 이벤트가 전환으로 표시되었는지 다시 한번 확인할 수 있습니다. 이벤트를 전환으로 표시하면 Google Ads에서 이벤트를 전환으로 가져올 수도 있습니다.

7. Google Ads에서 애널리틱스 이벤트 가져오기

Firebase-iOS 설정이 완료되었으며 기록된 액션 이벤트로 앱 캠페인을 시작할 준비가 되었습니다. 먼저 Firebase를 Google Ads에 연결합니다. Firebase를 Google Ads에 연결하면 앱 캠페인이 잠재고객에 대해 자세히 알아보고 앱 캠페인에 대한 학습 효과를 높일 수 있으므로 일반적으로 실적과 전환수가 개선됩니다.

'프로젝트 개요' 바로 옆에 있는 버튼을 클릭하여 Firebase 설정으로 이동합니다.
'통합' 탭에 Google Ads 및 '연결' 버튼이 표시됩니다. '연결' 및 계속을 클릭합니다.

Google Ads 계정을 선택합니다.

이제 Firebase 부분이 완료되었습니다.

이제 Google Ads로 이동하여 로그인합니다.

맞춤 이벤트를 전환으로 가져오려면 Google Ads로 이동하여 로그인한 후 도구 및 설정 → 측정 → 전환으로 이동합니다.
+ 버튼을 클릭하여 새 전환 액션을 추가합니다.

'Google 애널리틱스 4(GA4) 속성'(Firebase)을 선택하고 '계속'을 클릭합니다.

전환으로 표시된 모든 애널리틱스 이벤트를 확인할 수 있습니다. 앞서 구현한 clicked_counter 이벤트를 찾습니다.

가져오기 및 계속 버튼을 확인하고 클릭합니다.

text_search을(를) 전환 액션으로 설정했다면 이제 text_search 이벤트를 실행할 가능성이 있는 사용자를 타겟팅하는 캠페인을 시작해야 합니다.

8. 가져온 이벤트로 앱 액션 캠페인 실행

현재 계정의 캠페인 탭으로 이동하고 + 버튼을 클릭하여 새 캠페인을 시작합니다. 새 캠페인을 클릭하고 계속하기
이번에는 앱 설치 옵션이 포함된 앱 프로모션 캠페인을 시작합니다.

앱 이름, 패키지 이름 또는 게시자를 입력하여 앱을 찾습니다.
입찰 섹션의 보관용 계정에서 인앱 액션을 선택하면 광고가 액션에 초점을 맞출 수 있습니다.
제공된 목록에서 맞춤 이벤트를 찾을 수 있습니다. '타겟 전환당비용'을 설정하고 다른 옵션도 설정합니다.

캠페인 설정을 구성합니다. 이 내용은 Codelab에서 다루지 않으므로 이 문서를 참조하거나 설정 최적화에 관한 다른 채널을 통해 문의하세요.

9. 축하합니다

축하합니다. Firebase와 Google Ads를 성공적으로 통합했습니다. 이렇게 하면 캠페인 실적을 높일 수 있습니다.

스크립트를 설치하고, 새 Codelab 변경 목록을 만들어 스테이징했고, 대기 중인 Codelab 변경 목록을 업데이트 및 스테이징했으며, Codelab 변경 목록을 검토 및 승인하고, Codelab 변경 목록을 제출 및 게시했습니다.

학습한 내용

iOS용 Firebase 구성 방법
iOS 및 Firebase 애널리틱스로 맞춤 이벤트를 로깅하는 방법
이벤트를 가져와서 액션 캠페인에 사용하는 방법