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