1. 소개
최종 업데이트: 2020년 12월 14일
빌드할 항목
이 Codelab에서는 Firebase용 Google 애널리틱스(GA4F)로 이벤트를 구현하고 Google Ads를 통해 액션 캠페인을 실행하는 방법을 알아봅니다.
이 Codelab에서는 GA4F로 이벤트를 구현하고 Google Ads에서 이벤트를 가져오는 방법을 중점적으로 다룹니다. Firebase로 Android 앱을 빌드하는 방법을 알아보려면 Firebase Android Codelab - Build Friendly Chat을 참고하세요.
학습 내용
- Firebase 프로젝트를 만드는 방법
- Android 앱에서 Firebase SDK를 구현하는 방법
- 이벤트 및 매개변수를 만드는 방법
- Firebase에서 Google Ads로 이벤트를 가져오는 방법
- 맞춤 이벤트로 Google Ads 액션 캠페인을 시작합니다.
필요한 사항
- Android 스튜디오 3.6 이상
- Firebase 계정
- Google Ads 계정
2. Firebase 프로젝트 만들기 및 설정
Firebase를 시작하려면 Firebase 프로젝트를 만들고 설정해야 합니다.
Firebase 프로젝트 만들기
- Firebase에 로그인합니다.
Firebase Console에서 프로젝트 추가(또는 프로젝트 만들기)를 클릭하고 원하는 Firebase 프로젝트의 이름을 지정합니다.
- 프로젝트 만들기 옵션을 클릭하여 진행합니다. 메시지가 표시되면 Firebase 약관에 동의합니다. 액션 이벤트 및 전환을 추적하려면 Google 애널리틱스 이벤트가 필요하므로 이 프로젝트에 Google 애널리틱스를 사용 설정해야 합니다.
Firebase 프로젝트에 대한 자세한 내용은 Firebase 프로젝트 이해를 참조하세요.
- Google 애널리틱스 계정을 선택합니다. 계정이 있는 경우 해당 항목을 선택하거나 새로 만듭니다. 프로젝트 만들기 버튼을 클릭합니다.
- 이제 Firebase 프로젝트 빌드가 완료되었습니다.
다음 단계에서는 Android 앱에 Firebase를 추가하는 방법을 알아봅니다.
3. Android 앱에 Firebase 추가
앱 등록
- Firebase Console의 왼쪽 탐색 메뉴에서 프로젝트 개요를 선택한 후 '앱에 Firebase를 추가하여 시작하기'에서 Android 버튼을 클릭합니다.
- 필요한 정보를 입력합니다.
Android 패키지 이름의 경우 Android 스튜디오에서 앱 디렉터리로 이동하여 build.gradle
이라는 파일을 엽니다. 파일에서 applicationId
를 검색합니다. 이 값은 Android 패키지 이름입니다. 이 값을 복사하여 붙여넣습니다.
Google 로그인 또는 Firebase 동적 링크(이러한 기능은 이 Codelab에서 다루는 내용이 아님)를 사용할 계획이 아니라면 여기에서 SHA-1 키는 필요하지 않습니다. SHA-1 키에 관한 자세한 내용은 이 문서를 참고하세요.
- 앱 등록 버튼을 클릭합니다.
구성 파일 다운로드
- 'google-services.json 다운로드' 버튼을 클릭하여 구성 파일
google-services.json
를 다운로드합니다.
- Android 스튜디오에서
app
디렉터리로 이동하여 위에서 방금 다운로드한google-services.json
파일을app
디렉터리로 이동합니다. Firebase Console로 돌아가서 '다음' 버튼을 클릭합니다.
앱에서 Firebase 사용 설정
- Firebase에서 생성된
google-services.json
파일을 읽으려면 Google 서비스 Gradle 플러그인이 필요합니다. - Android 스튜디오에서
<project>/build.gradle
를 열고 파일에 다음 줄을 추가합니다.
buildscript {
repositories {
// Check that you have the following line (if not, add it):
google() //Google's Maven repository
}
dependencies {
...
// Add this line
classpath 'com.google.gms:google-services:4.3.4'
}
}
allprojects {
...
repositories {
// Check that you have the following line (if not, add it):
google() //Google's Maven repository
...
}
}
}
<project>/<app-module>/build.gradle
를 연 다음 파일에 다음 줄을 추가합니다.
apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'
이제 Android 앱에 Firebase를 추가했습니다.
다음 단계에서는 앱에 Firebase SDK를 추가하는 방법을 알아봅니다.
4. 앱에 Firebase SDK 추가
이 단계에서는 Firebase SDK, 특히 Google 애널리틱스용 Firebase SDK를 추가합니다.
BoM 버전을 지정하여 앱에서 사용 중인 Firebase 라이브러리 버전을 관리할 수 있는 Firebase Android BoM을 사용합니다. 특정 BoM 버전에 매핑된 Firebase 라이브러리 버전을 알아보려면 해당 BoM 버전의 출시 노트를 확인하세요.
<project>/<app-module>/build.gradle
를 열고 파일에 다음 줄을 추가합니다.
dependencies {
// ...
//Import the Firebase BoM
implementation platform('com.google.firebase:firebase-bom:26.1.1')
//Declare the dependency for the Firebase SDK for Google Analytics
implementation 'com.google.firebase:firebase-analytics-ktx'
보시다시피 BoM 버전만 지정하면 Firebase 분석 라이브러리의 버전을 지정할 필요가 없습니다. 그러나 BoM에 지정된 버전과 관계없이 원하는 Firebase 라이브러리에 원하는 버전을 사용하려면 다음과 같이 원하는 버전을 지정하기만 하면 됩니다.
dependencies {
// ...
//Import the Firebase BoM
implementation platform('com.google.firebase:firebase-bom:26.1.1')
//Declare the dependency for the Firebase SDK for Google Analytics
implementation 'com.google.firebase:firebase-analytics-ktx:17.0.0'
- 이제
Sync Now
버튼을 클릭하여 앱을 동기화합니다.
이제 Google 애널리틱스용 Firebase SDK를 Android 앱에 추가했습니다.
다음 단계에서는 Android 앱에서 Firebase 이벤트를 로깅하는 방법을 알아봅니다.
5. Firebase 애널리틱스로 이벤트 로깅
이 단계에서는 Android 앱에서 Firebase 애널리틱스로 이벤트를 로깅하는 방법을 알아봅니다.
이벤트를 로깅하는 방법에는 추천 이벤트 또는 맞춤 이벤트를 사용하는 두 가지가 있습니다.
추천 이벤트 사용하기
Firebase 애널리틱스 SDK는 게임, 소매, 여행, 전자상거래와 같은 다양한 유형의 앱에서 사용할 수 있는 여러 가지 추천 이벤트를 정의합니다. 사전 정의된 매개변수가 필요한 추천 이벤트도 있으며, 이러한 매개변수를 사용하면 Firebase 보고서에서 최대한 많은 세부정보를 얻을 수 있습니다. ( 추천 이벤트 참조)
- 활동 상단에서 FirebaseAnalytics 객체를 선언합니다.
private lateinit var firebaseAnalytics: FirebaseAnalytics
onCreate()
메서드에서 객체를 초기화합니다.
firebaseAnalytics = Firebase.analytics
logEvent()
메서드로 이벤트 로깅을 시작합니다. 다음 코드는 사용자가 앱에서 항목을 구매할 때 PURCHASE 이벤트를 로깅합니다.
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
param(FirebaseAnalytics.Param.VALUE, 10)
param(FirebaseAnalytics.Param.CURRENCY, "USE")
}
맞춤 이벤트 사용
추천 이벤트로 포함되지 않은 이벤트가 필요한 경우 맞춤 매개변수를 사용하여 맞춤 이벤트를 직접 로깅할 수 있습니다.
firebaseAnalytics.logEvent("delete_item"){
param("item name", name)
param("reason", text)
}
이벤트 디버깅
Firebase Console에서 이벤트에 대한 집계된 데이터와 보고서를 확인할 수 있습니다. 하지만 업데이트는 하루 중 주기적으로 이루어지므로 앱에 로그인한 직후에는 이러한 이벤트를 볼 수 없습니다.
즉각적인 테스트 및 디버깅을 위해 Firebase Debugview를 사용할 수 있습니다. DebugView를 사용하면 개발 기기에서 앱이 기록한 이벤트 데이터를 거의 실시간으로 확인할 수 있습니다. DebugView의 경우 디버깅 이벤트 섹션을 참고하세요.
이제 Android 앱에 이벤트 로깅을 완료했습니다.
다음 단계에서는 이러한 이벤트를 Google Ads로 가져오는 방법을 알아봅니다.
6. Firebase 이벤트를 Google Ads로 가져오기
Firebase-Android 설정이 완료되었으며 기록된 액션 이벤트로 앱 캠페인을 시작할 준비가 되었습니다. 먼저 Firebase를 Google Ads에 연결합니다. Firebase를 Google Ads에 연결하면 앱 캠페인이 잠재고객에 대해 자세히 알아보고 앱 캠페인에 대한 학습 효과를 높일 수 있으므로 일반적으로 실적과 전환수가 개선됩니다.
Firebase와 Google Ads 연결하기
- '프로젝트 개요' 바로 옆에 있는 버튼을 클릭하여 Firebase 설정으로 이동합니다.
- '통합' 탭에 Google Ads 및 '연결' 버튼이 표시됩니다. '연결' 및 '계속'을 클릭합니다.
- 연결할 Google Ads 계정을 선택합니다.
이제 Firebase와 Google Ads의 연결이 완료되었습니다. Firebase 이벤트를 Google Ads로 가져와 보겠습니다.
Firebase 이벤트 가져오기
- Firebase Console에서 이벤트 메뉴로 이동하여 가져올 이벤트를 전환으로 표시합니다.
- 이제 Google Ads로 이동하여 Firebase와 연결한 계정에 로그인합니다.
- Google Ads에서 도구 → 측정 → 전환 으로 이동합니다.
- + 버튼 클릭
- 앱 → Google 애널리틱스 4 속성(Firebase)을 선택하고 '계속'을 클릭합니다.
- 전환으로 표시된 모든 애널리틱스 이벤트를 확인할 수 있습니다. 가져올 이벤트를 찾습니다. 여기서는 이전에 구현한
delete_item
이벤트를 선택합니다. '가져오기 및 계속' 버튼을 클릭합니다. - Firebase에서 전환 이벤트를 가져왔습니다.
이제 Firebase 이벤트를 Google Ads로 가져오는 작업이 완료되었습니다.
다음 단계에서는 방금 가져온 이벤트로 액션 캠페인을 실행하는 방법을 알아봅니다.
7. 가져온 이벤트로 앱 액션 캠페인 실행
- 현재 Google Ads 계정의 앱 캠페인 탭으로 이동하고 + 버튼을 클릭하여 새 캠페인을 시작합니다.
- 앱 설치 옵션과 함께 '앱 프로모션' 캠페인을 실행합니다. 하단에서 홍보할 앱을 선택하고 '계속'을 클릭합니다.
- 입찰 섹션의 드롭다운 메뉴에서 인앱 액션을 선택하면 이벤트를 볼 수 있습니다. 중점을 둘 이벤트를 선택합니다.
- 나머지 캠페인 설정만 완료하면 됩니다.
8. 축하합니다
축하합니다. Firebase와 Google Ads를 성공적으로 통합했습니다. 이렇게 하면 캠페인 실적을 높일 수 있습니다.
학습한 내용
- Android용 Firebase 애널리틱스를 구성하는 방법
- Android 앱에서 Firebase 애널리틱스로 이벤트를 로깅하는 방법
- 이벤트를 가져와 액션 캠페인에 사용하는 방법