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를 실행합니다.

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

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

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

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

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

Firebase 프로젝트 만들기

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

  1. Firebase에 로그인합니다.

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

9b0ae97cc3c6f1d0.png

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

e58151a081f0628.png

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

4. Firebase 구성

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

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

425bb1c07921e71d.png

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

26e5b98711c2787a.png

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

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

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

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

$ pod init

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

$ vi Podfile

$ pod 'Firebase/Analytics' 54204c9ce2a49666.png

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

$ pod install

  1. 초기화 코드 추가:

앱을 시작할 때 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
  }
}
  1. 완료되었습니다. 콘솔로 이동

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

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의 이벤트 로깅을 모니터링하면 이벤트가 제대로 로깅되는지 확인할 수 있습니다. 여기에는 자동으로 로깅되는 이벤트와 수동으로 로깅되는 이벤트가 모두 포함됩니다.

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

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

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

대시보드에서 이벤트 보기

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

286b640ed4646163.png

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

a933a338990cba3a.png

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

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

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

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

b711bf2e94fa0895.png

  1. Google Ads 계정을 선택합니다.

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

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

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

73cec8d2e80eab03.png

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

4b1d8f6a712b2ac6.png

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

ba1bbe6b2924fac8.png 2b9abde9fb95d188.png

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

ab35e341dff32e48.png

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

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

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

af98c44d1476558.png

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

a1f145794f949109.png 3dc838d7f4eeeba5.png

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

9. 축하합니다

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

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

학습한 내용

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