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

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 프로젝트 만들기

  1. Firebase에 로그인합니다.

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

8525e77df3536fbb.png

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

e58151a081f0628.png

Firebase 프로젝트에 대한 자세한 내용은 Firebase 프로젝트 이해를 참조하세요.

  1. Google 애널리틱스 계정을 선택합니다. 계정이 있는 경우 해당 항목을 선택하거나 새로 만듭니다. 프로젝트 만들기 버튼을 클릭합니다.

ac928e5947ba7cbf.png

  1. 이제 Firebase 프로젝트 빌드가 완료되었습니다.

다음 단계에서는 Android 앱에 Firebase를 추가하는 방법을 알아봅니다.

3. Android 앱에 Firebase 추가

앱 등록

  1. Firebase Console의 왼쪽 탐색 메뉴에서 프로젝트 개요를 선택한 후 '앱에 Firebase를 추가하여 시작하기'에서 Android 버튼을 클릭합니다.

6cbb33ad3e7c9132.png

  1. 필요한 정보를 입력합니다.

3b7d3b33d81fe8ea.png

Android 패키지 이름의 경우 Android 스튜디오에서 앱 디렉터리로 이동하여 build.gradle이라는 파일을 엽니다. 파일에서 applicationId를 검색합니다. 이 값은 Android 패키지 이름입니다. 이 값을 복사하여 붙여넣습니다.

Google 로그인 또는 Firebase 동적 링크(이러한 기능은 이 Codelab에서 다루는 내용이 아님)를 사용할 계획이 아니라면 여기에서 SHA-1 키는 필요하지 않습니다. SHA-1 키에 관한 자세한 내용은 이 문서를 참고하세요.

  1. 앱 등록 버튼을 클릭합니다.

구성 파일 다운로드

  1. 'google-services.json 다운로드' 버튼을 클릭하여 구성 파일 google-services.json를 다운로드합니다.

52f08aa18c8d59d0.png

  1. Android 스튜디오에서 app 디렉터리로 이동하여 위에서 방금 다운로드한 google-services.json 파일을 app 디렉터리로 이동합니다. Firebase Console로 돌아가서 '다음' 버튼을 클릭합니다.

앱에서 Firebase 사용 설정

  1. Firebase에서 생성된 google-services.json 파일을 읽으려면 Google 서비스 Gradle 플러그인이 필요합니다.
  2. 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
      ...
      }
   }
}
  1. <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 버전의 출시 노트를 확인하세요.

  1. <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'
  1. 이제 Sync Now 버튼을 클릭하여 앱을 동기화합니다. 937206076c88ae5c.png

이제 Google 애널리틱스용 Firebase SDK를 Android 앱에 추가했습니다.

다음 단계에서는 Android 앱에서 Firebase 이벤트를 로깅하는 방법을 알아봅니다.

5. Firebase 애널리틱스로 이벤트 로깅

이 단계에서는 Android 앱에서 Firebase 애널리틱스로 이벤트를 로깅하는 방법을 알아봅니다.

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

추천 이벤트 사용하기

Firebase 애널리틱스 SDK는 게임, 소매, 여행, 전자상거래와 같은 다양한 유형의 앱에서 사용할 수 있는 여러 가지 추천 이벤트를 정의합니다. 사전 정의된 매개변수가 필요한 추천 이벤트도 있으며, 이러한 매개변수를 사용하면 Firebase 보고서에서 최대한 많은 세부정보를 얻을 수 있습니다. ( 추천 이벤트 참조)

  1. 활동 상단에서 FirebaseAnalytics 객체를 선언합니다.
private lateinit var firebaseAnalytics: FirebaseAnalytics
  1. onCreate() 메서드에서 객체를 초기화합니다.
firebaseAnalytics = Firebase.analytics
  1. 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에 연결하면 앱 캠페인이 잠재고객에 대해 자세히 알아보고 앱 캠페인에 대한 학습 효과를 높일 수 있으므로 일반적으로 실적과 전환수가 개선됩니다.

  1. '프로젝트 개요' 바로 옆에 있는 버튼을 클릭하여 Firebase 설정으로 이동합니다.

412830708c61fdc0.png

  1. '통합' 탭에 Google Ads 및 '연결' 버튼이 표시됩니다. '연결' 및 '계속'을 클릭합니다.

796c921fb2b873ae.png

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

이제 Firebase와 Google Ads의 연결이 완료되었습니다. Firebase 이벤트를 Google Ads로 가져와 보겠습니다.

Firebase 이벤트 가져오기

  1. Firebase Console에서 이벤트 메뉴로 이동하여 가져올 이벤트를 전환으로 표시합니다.

a5f302ba01a1863c.png

  1. 이제 Google Ads로 이동하여 Firebase와 연결한 계정에 로그인합니다.
  2. Google Ads에서 도구 → 측정 → 전환 7acf268d7e799a7e.png으로 이동합니다.
  3. + 버튼 d0eed72946d038d8.png 클릭
  4. 앱 → Google 애널리틱스 4 속성(Firebase)을 선택하고 '계속'을 클릭합니다. 983f06edb15724de.png
  5. 전환으로 표시된 모든 애널리틱스 이벤트를 확인할 수 있습니다. 가져올 이벤트를 찾습니다. 여기서는 이전에 구현한 delete_item 이벤트를 선택합니다. '가져오기 및 계속' 버튼을 클릭합니다. f9bdee80c0d40999.png
  6. Firebase에서 전환 이벤트를 가져왔습니다. be75f6a11913236.png

이제 Firebase 이벤트를 Google Ads로 가져오는 작업이 완료되었습니다.

다음 단계에서는 방금 가져온 이벤트로 액션 캠페인을 실행하는 방법을 알아봅니다.

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

  1. 현재 Google Ads 계정의 앱 캠페인 탭으로 이동하고 + 버튼을 클릭하여 새 캠페인을 시작합니다.

19856a65ab999ad7.png

  1. 앱 설치 옵션과 함께 '앱 프로모션' 캠페인을 실행합니다. 하단에서 홍보할 앱을 선택하고 '계속'을 클릭합니다. 8146b5a7a4f961bd.png
  2. 입찰 섹션의 드롭다운 메뉴에서 인앱 액션을 선택하면 이벤트를 볼 수 있습니다. 중점을 둘 이벤트를 선택합니다.

b75e410c7dbdfec8.png

  1. 나머지 캠페인 설정만 완료하면 됩니다.

8. 축하합니다

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

학습한 내용

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