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

1. 소개

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

빌드할 항목

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

이 Codelab을 통해 고객이 직면한 앱 비즈니스의 전체 프로세스를 경험할 수 있습니다. 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. 애플리케이션 섹션에서 앱을 선택한 후 다음을 클릭합니다.
  4. 표시되는 대화상자에서 다음 값을 사용하여 앱 이름을 지정하고 프로젝트의 추가 옵션을 선택한 후 'Next'를 클릭합니다.
  5. 제품 이름: 예: ios-app

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

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

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

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

Firebase 프로젝트 만들기

Google 애널리틱스가 사용 설정되지 않은 기존 Firebase 프로젝트가 있는 경우 설정 > 프로젝트 설정의 통합 탭에서 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 프로젝트에서 프로젝트 탐색기의 최상위 앱을 선택한 다음 '일반' 탭을 선택합니다.
  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 애널리틱스로 맞춤 이벤트를 로깅하는 방법을 알아봅니다.

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 애널리틱스로 맞춤 이벤트를 로깅하는 방법
  • 이벤트를 가져와서 액션 캠페인에 사용하는 방법