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

Firebase용 Google 애널리틱스 맞춤 이벤트가 포함된 Google Ads - Android

1. 소개

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

빌드할 항목

이 Codelab에서는 Firebase용 Google 애널리틱스(GA4F)로 이벤트를 구현하고 Google Ads를 통해 액션 캠페인을 실행하는 방법을 알아봅니다.

이 Codelab에서는 GA4F로 이벤트를 구현하고 Google Ads에서 이벤트를 가져오는 방법을 중점적으로 다룹니다. Firebase로 Android 앱을 빌드하는 방법을 알아보려면 Firebase Android Codelab-친절한 채팅을 참조하세요.

학습 내용

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 동적 링크를 사용할 계획이 아니라면 여기에서 SHA-1 키가 필요하지 않습니다. 이는 이 Codelab의 일부가 아닙니다. 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'

이제 Firebase를 Android 앱에 추가했습니다.

다음 단계에서는 앱에 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 애널리틱스로 이벤트를 기록하는 방법을 알아봅니다.

이벤트를 로깅하는 방법에는 추천 이벤트 또는 맞춤 이벤트를 사용하는 두 가지 방법이 있습니다.

맞춤 이벤트 사용

추천 이벤트에서 다루지 않는 이벤트가 필요한 경우 맞춤 매개변수를 사용하여 자체 맞춤 이벤트를 기록할 수 있습니다.

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에서 전환 이벤트를 성공적으로 가져왔습니다.