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

Firebase용 Google Analytics 맞춤 이벤트를 사용한 Google Ads - Android

1. 소개

최종 업데이트 날짜: 2020-12-14

무엇을 구축할 것인가

이 Codelab에서는 Firebase용 Google Analytics(GA4F)로 이벤트를 구현하고 Google Ads를 통해 액션 캠페인을 시작하는 방법을 알아봅니다.

이 Codelab에서는 GA4F로 이벤트를 구현하고 Google Ads에서 이벤트를 가져오는 데 중점을 둡니다. Firebase로 Android 앱을 구축하는 방법을 알아보려면 Firebase Android Codelab-Build Friendly Chat을 참조하세요.

무엇을 배울 것인가

Firebase 프로젝트를 만드는 방법
Android 앱에서 Firebase SDK를 구현하는 방법
이벤트 및 매개변수를 생성하는 방법
Firebase에서 Google Ads로 이벤트를 가져오는 방법
맞춤 이벤트를 통해 Google Ads 액션 캠페인을 시작하세요.

필요한 것

안드로이드 스튜디오 3.6 이상
Firebase 계정
Google Ads 계정

2. Firebase 프로젝트 생성 및 설정

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

Firebase 프로젝트 만들기

Firebase 에 로그인합니다.

Firebase 콘솔에서 프로젝트 추가(또는 프로젝트 생성)를 클릭하고 원하는 대로 Firebase 프로젝트 이름을 지정하세요.

프로젝트 생성 옵션을 클릭하세요. 메시지가 표시되면 Firebase 약관에 동의하세요. 액션 이벤트 및 전환을 추적하려면 Google Analytics 이벤트가 필요하므로 이 프로젝트에 대해 Google Analytics를 활성화해야 합니다.

Firebase 프로젝트에 대해 자세히 알아보려면 Firebase 프로젝트 이해를 참조하세요.

Google Analytics 계정을 선택합니다. 가지고 있는 경우 해당 항목을 선택하거나 새로 만드세요. 프로젝트 생성 버튼을 클릭합니다.

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

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

3. Android 앱에 Firebase 추가

앱 등록

Firebase 콘솔의 왼쪽 탐색 메뉴에서 프로젝트 개요를 선택한 다음 '앱에 Firebase를 추가하여 시작하기' 아래의 Android 버튼을 클릭하세요.

필요한 정보를 입력하세요.

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

Google 로그인 또는 Firebase 동적 링크를 사용할 계획이 아니라면 여기에는 SHA-1 키가 필요하지 않습니다. 이는 이 Codelab의 일부가 아닙니다. SHA-1 키에 대한 자세한 내용은 이 문서를 참조하세요. .

앱 등록 버튼을 클릭하세요.

구성 파일 다운로드

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

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

앱에서 Firebase를 활성화하세요.

Firebase에서 생성된 google-services.json 파일을 읽으려면 Google Services 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 Analytics용 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 버튼을 클릭하여 앱을 동기화하세요.

이제 Android 앱에 Google Analytics용 Firebase SDK 추가가 완료되었습니다.

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

5. Firebase Analytics로 이벤트 기록하기

이 단계에서는 Android 앱에서 Firebase Analytics를 사용하여 이벤트를 기록하는 방법을 알아봅니다.

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

맞춤 이벤트 사용

추천 이벤트에 포함되지 않는 이벤트가 필요한 경우 맞춤 매개변수를 사용하여 맞춤 이벤트를 직접 기록할 수 있습니다.

firebaseAnalytics.logEvent("delete_item"){
   param("item name", name)
   param("reason", text)
}

디버그 이벤트

Firebase 콘솔에서 이벤트에 대한 집계된 데이터와 보고서를 볼 수 있습니다. 그러나 업데이트는 하루 종일 주기적으로 이루어지기 때문에 앱에 로그인한 직후에는 해당 이벤트를 볼 수 없습니다.

즉각적인 테스트 및 디버깅 목적으로 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 콘솔에서 이벤트 메뉴로 이동하여 전환으로 가져오려는 이벤트를 표시하세요.

이제 Google Ads로 이동하여 Firebase와 연결한 계정에 로그인하세요.
Google Ads에서 도구 → 측정 → 전환으로 이동합니다.
+ 버튼을 클릭하세요
앱 → Google Analytics 4 속성(Firebase)을 선택하고 계속을 클릭하세요.
전환으로 표시된 모든 분석 이벤트를 볼 수 있습니다. 가져오려는 이벤트를 찾으세요. 이 경우 이전에 구현한 delete_item 이벤트를 선택합니다. 가져오기 및 계속 버튼을 클릭하세요.
Firebase에서 전환 이벤트를 성공적으로 가져왔습니다.