Google Ads에서 Firebase용 Google 애널리틱스 맞춤 이벤트 사용하기 - Unity

1. 소개

최종 업데이트: 2021년 2월 19일

빌드할 항목

이 Codelab에서는 Unity 환경에서 GA4F iOS로 맞춤 이벤트를 구현하고 Google Ads를 통해 액션 캠페인을 실행하는 방법을 알아봅니다.

이 Codelab에서는 Google 고객이 직면한 앱 비즈니스의 전체 프로세스를 경험할 수 있습니다. iOS에서 Firebase 및 AdMob을 간단하게 소개하는 방법을 알아보려면 AdMob+Firebase 101 Unity: 설정 및 분석 기본사항부터 시작하세요.

학습할 내용

  • Unity + iOS에서 GA4F(Firebase용 Google 애널리틱스)를 초기화하는 방법
  • 맞춤 이벤트 및 매개변수를 만드는 방법
  • Firebase에서 Google Ads로 이벤트를 가져오는 방법
  • 맞춤 이벤트로 액션 캠페인 실행

필요한 항목

  • Xcode
  • Unity
  • Firebase 계정
  • Google Ads 계정

2. 새 Unity 프로젝트 시작

간단한 템플릿 Unity 앱을 만듭니다. 이 간단한 앱을 수정하여 완성된 앱을 만듭니다.

Unity 실행

  1. 열려 있는 프로젝트가 없으면 '새 프로젝트 만들기'를 선택합니다.
  2. 대화상자에서 3D 템플릿을 선택합니다.
  3. 프로젝트 이름(예: Unity Firebase 맞춤 이벤트)을 입력합니다.
  4. 프로젝트를 저장할 위치를 선택하고 '만들기'를 클릭합니다.
  5. Unity가 작업공간 창에서 새 프로젝트를 엽니다.

3. Firebase 프로젝트 만들기 및 설정

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

기존 Firebase 프로젝트가 있지만 Google 애널리틱스가 사용 설정되지 않은 경우 설정 > 프로젝트 설정의 통합 탭에서 Google 애널리틱스를 사용 설정할 수 있습니다. Firebase 구성 단계로 이동합니다.

  1. Firebase에 로그인합니다.

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

d9519856fc3b4bd0.png

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

e58151a081f0628.png

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

4. Unity 구성

  1. Unity > File > Build Settings에서 중요한 값은 다음 단계에 따라 얻을 수 있는 iOS 번들 ID를 설정하는 것입니다.

다음 화면과 같은 대화상자가 표시됩니다.

7dbfc36bef1d035c.png

  1. iOS 앱의 Unity 프로젝트에서 빌드 설정 대화상자(File > Build Settings)를 엽니다. 플랫폼이 iOS로 설정되어 있지 않으면 iOS 플랫폼을 선택하고 Switch Platform 버튼을 클릭할 수 있습니다.

8be5416883a70def.png

  1. 플랫폼을 변경한 후 Player Settings(플레이어 설정) 버튼을 클릭하여 번들 ID를 설정합니다. 기본정보 영역 주변에 이 텍스트 입력란이 표시됩니다.
  2. 번들 식별자 필드의 값은 iOS 번들 ID (예: com.yourcompany.yourproject)입니다. 이 값을 복사하거나 값을 설정하여 복사하세요.
  3. Firebase 대화상자에서 복사한 번들 ID를 iOS bundle ID 필드에 붙여넣습니다.
  4. 앱 등록을 클릭합니다.
  5. Firebase에서 계속 진행하여 안내에 따라 구성 파일 GoogleService-Info.plist을 다운로드합니다.
  6. Unity 프로젝트의 프로젝트 창을 연 다음 구성 파일을 Assets 폴더로 이동합니다.
  7. 나머지 단계를 건너뛰고 Firebase Console의 기본 페이지로 돌아갑니다.

5. Unity에서 Firebase 애널리틱스 구성

이 단계에서는 Unity 프로젝트에 Firebase SDK를 추가합니다.

  1. Firebase Console로 이동합니다.
  2. 프로젝트 개요 페이지 중앙에 있는 Unity 아이콘 ( 8c8fc0e0e05dc749.png)을 클릭하여 설정 워크플로를 시작합니다. Firebase 프로젝트에 앱을 이미 추가한 경우 앱 추가를 클릭하여 플랫폼 옵션을 표시합니다.
  3. 등록하려는 Unity 프로젝트의 빌드 타겟을 선택하거나 이제 동시에 두 타겟을 등록하도록 선택할 수도 있습니다.
  1. Unity 프로젝트의 플랫폼별 ID를 입력합니다.
  • iOS의 경우 — iOS 번들 ID 필드에 Unity 프로젝트의 iOS ID를 입력합니다.
  • Android의 경우 — Android 패키지 이름 입력란에 Unity 프로젝트의 Android ID를 입력합니다. 패키지 이름과 애플리케이션 ID는 같은 개념입니다.
  1. Unity 프로젝트의 ID는 어디에서 찾을 수 있나요?
  1. (선택사항) Unity 프로젝트의 플랫폼별 닉네임을 입력합니다. 이러한 닉네임은 편의상 지정하는 내부용 식별자이며 Firebase Console에서 본인만 볼 수 있습니다.
  2. 앱 등록을 클릭합니다.

Firebase 애널리틱스 Unity SDK 추가

  1. Firebase Console에서 Firebase Unity SDK 다운로드를 클릭한 다음, 원하는 위치에 SDK의 압축을 풉니다.
  • 언제든지 Firebase Unity SDK를 다시 다운로드할 수 있습니다.
  • Firebase Unity SDK는 플랫폼별로 다르지 않습니다.
  1. 열려 있는 Unity 프로젝트에서 Assets(애셋) > Import Package(패키지 가져오기) > Custom Package(맞춤 패키지)로 이동합니다.
  2. 압축을 푼 SDK에서 앱에 사용할 지원되는 Firebase 제품을 선택합니다.
  • Google 애널리틱스용 Firebase 패키지인 FirebaseAnalytics.unitypackage를 추가합니다.
  • 앱에서 사용할 다른 Firebase 제품의 패키지를 추가합니다. 예를 들어 Firebase 인증 및 Firebase 실시간 데이터베이스를 사용하려면 FirebaseAuth.unitypackage 및 FirebaseDatabase.unitypackage를 추가하세요.
  1. Unity 패키지 가져오기 창에서 가져오기를 클릭합니다.
  2. Firebase Console로 돌아가서 설정 워크플로에서 다음을 클릭합니다.

6. Firebase 애널리틱스로 맞춤 이벤트 로깅

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

Firebase Analytics는 몇 가지 이벤트를 자동으로 로깅하며 별도의 코드 없이 이벤트를 수신할 수 있습니다. 앱에서 데이터를 추가로 수집해야 하는 경우 앱에서 최대 500개의 서로 다른 애널리틱스 맞춤 이벤트 유형을 기록할 수 있습니다.

로그 이벤트

FirebaseApp 인스턴스를 구성한 후 logEvent() 메서드로 이벤트 로깅을 시작할 수 있습니다.

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

Xcode 디버그 콘솔에서 이벤트 보기

상세 로깅을 사용 설정하여 SDK의 이벤트 로깅을 모니터링하면 이벤트가 제대로 로깅되는지 확인할 수 있습니다. 여기에는 자동으로 로깅되는 이벤트와 수동으로 로깅되는 이벤트가 모두 포함됩니다.

다음과 같이 상세 로깅을 사용 설정할 수 있습니다.

  1. Xcode에서 Product(제품) > Scheme(스킴) > Edit scheme(스킴 수정)을 선택합니다.
  2. 왼쪽 메뉴에서 Run(실행)을 선택합니다.
  3. Arguments(인수) 탭을 선택합니다.
  4. Arguments Passed On Launch(실행 시 전달 인수) 섹션에 -FIRAnalyticsDebugEnabled를 추가합니다.

다음에 앱을 실행하면 Xcode 디버그 콘솔에 이벤트가 표시되어 이벤트 전송 여부를 즉시 확인할 수 있습니다.

대시보드에서 이벤트 보기

몇 시간 내에 Firebase Console에 로깅된 이벤트가 표시됩니다. 애널리틱스 → 이벤트에 있습니다. 이벤트를 클릭하여 매개변수 값을 찾을 수도 있습니다.

286b640ed4646163.png

'전환으로 표시' 스위치를 오른쪽으로 밀어 'text_search'를 전환으로 표시합니다.

a933a338990cba3a.png

Firebase 애널리틱스 전환 탭을 통해 이벤트가 전환으로 표시되었는지 다시 한번 확인할 수 있습니다. 이벤트를 전환으로 표시하면 Google Ads에서 이벤트를 전환으로 가져올 수도 있습니다.

7. Google Ads에서 애널리틱스 이벤트 가져오기

Firebase-iOS 설정이 완료되었으며 로깅된 작업 이벤트로 앱 캠페인을 실행할 준비가 되었습니다. 먼저 Firebase를 Google Ads에 연결합니다. Firebase를 Google Ads에 연결하면 앱 캠페인에서 잠재고객에 대해 자세히 알아보고 앱 캠페인 학습을 개선할 수 있으므로 일반적으로 실적과 전환이 개선됩니다.

  1. '프로젝트 개요' 바로 옆에 있는 버튼을 클릭하여 Firebase 설정으로 이동합니다.
  2. '통합' 탭에 Google Ads 및 '연결' 버튼이 표시됩니다. '연결' 및 계속을 클릭합니다.

b711bf2e94fa0895.png

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

이제 Firebase 부분이 완료되었습니다.

이제 Google Ads로 이동하여 로그인합니다.

  1. 맞춤 이벤트를 전환으로 가져오려면 Google Ads로 이동하여 로그인한 후 도구 및 설정 → 측정 → 전환으로 이동합니다.
  2. + 버튼을 클릭하여 새 전환 액션을 추가합니다.

73cec8d2e80eab03.png

  1. 'Google 애널리틱스 4(GA4) 속성'(Firebase)을 선택하고 '계속'을 클릭합니다.

4b1d8f6a712b2ac6.png

  1. 전환으로 표시된 모든 애널리틱스 이벤트를 확인할 수 있습니다. 앞서 구현한 clicked_counter 이벤트를 찾습니다.

ba1bbe6b2924fac8.png

  1. 가져오기 및 계속 버튼을 확인하고 클릭합니다.

ab35e341dff32e48.png

text_search를 전환 액션으로 설정했다면 이제 text_search 이벤트를 실행할 가능성이 있는 사용자를 타겟팅하는 캠페인을 시작해야 합니다.

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

  1. 현재 계정의 캠페인 탭으로 이동하고 + 버튼을 클릭하여 새 캠페인을 시작합니다. 새 캠페인을 클릭하고 계속하기
  2. 이번에 Google은 앱 설치 옵션이 포함된 앱 프로모션 캠페인을 출시할 예정입니다.

af98c44d1476558.png

  1. 앱 이름, 패키지 이름 또는 게시자를 입력하여 앱을 찾습니다.
  2. '입찰' 섹션의 광고 드롭다운에서 '인앱 액션'을 선택하여 액션에 중점을 둡니다.
  3. 제공된 목록에서 맞춤 이벤트를 찾을 수 있습니다. '타겟 전환당비용'을 설정하고 다른 옵션도 설정합니다.

a1f145794f949109.png

  1. 캠페인 설정을 구성합니다. 이 내용은 Codelab에서 다루지 않으므로 이 문서를 참조하거나 설정 최적화에 관한 다른 채널을 통해 문의하세요.

9. 축하합니다

축하합니다. Firebase를 Unity 및 Google Ads에 통합했습니다. 이렇게 하면 캠페인 실적을 높일 수 있습니다.

학습한 내용

  • Unity iOS 플랫폼용 Firebase 구성 방법
  • Unity 및 Firebase 애널리틱스로 맞춤 이벤트를 로깅하는 방법
  • 이벤트를 가져와 액션 캠페인에 사용하는 방법

참조 문서