Zdarzenia niestandardowe w Google Ads i Google Analytics dla Firebase – Android

1. Wprowadzenie

Ostatnia aktualizacja: 14.12.2020

Co utworzysz

Z tego ćwiczenia w Codelabs dowiesz się, jak wdrażać zdarzenia za pomocą Google Analytics dla Firebase(GA4F) i uruchamiać kampanie zachęcające do działania w Google Ads.

Skupia się on na implementowaniu zdarzeń w GA4F i importowaniu zdarzeń do Google Ads. Jeśli chcesz dowiedzieć się, jak utworzyć aplikację na Androida za pomocą Firebase, zapoznaj się z czatem z ćwiczeniami w Firebase na temat programowania w Firebase.

Czego się nauczysz

• Jak utworzyć projekt Firebase
• Jak wdrożyć pakiet SDK Firebase w aplikacji na Androida
• Jak tworzyć zdarzenia i parametry
• Jak importować zdarzenia z Firebase do Google Ads
• Uruchom kampanie Google Ads zachęcające do działania ze zdarzeniami niestandardowymi.

Czego potrzebujesz

• Android Studio 3.6 lub nowszy
• Konto Firebase
• Konto Google Ads

2. Tworzenie i konfigurowanie projektu Firebase

Aby zacząć korzystać z Firebase, musisz utworzyć i skonfigurować projekt Firebase.

Tworzenie projektu Firebase

1. Zaloguj się w Firebase.

W konsoli Firebase kliknij Dodaj projekt(lub Utwórz projekt) i nadaj projektowi Firebase dowolną nazwę.

2. Klikaj opcje tworzenia projektów. Zaakceptuj warunki korzystania z Firebase, jeśli pojawi się taka prośba. Włącz Google Analytics w tym projekcie, ponieważ zdarzenia Google Analytics są potrzebne do śledzenia zdarzeń związanych z działaniami i konwersji.

Więcej informacji o projektach Firebase znajdziesz w artykule Omówienie projektów Firebase.

3. Wybierz konto Google Analytics. Jeśli masz konto, wybierz je lub utwórz nowe. Kliknij przycisk Utwórz projekt.

4. Teraz kompilacja projektu Firebase się zakończyła.

W następnym kroku dowiesz się, jak dodać Firebase do swojej aplikacji na Androida.

3. Dodaj Firebase do swojej aplikacji na Androida

Zarejestruj aplikację

1. W konsoli Firebase wybierz w panelu nawigacyjnym po lewej stronie Projekt Podsumowanie, a potem w sekcji „Zacznij od dodania Firebase do aplikacji” kliknij przycisk Androida.

2. Podaj niezbędne informacje.

Aby wpisać nazwę pakietu na Androida, w Android Studio przejdź do katalogu aplikacji i otwórz plik o nazwie build.gradle. W pliku wyszukaj applicationId. Ta wartość to nazwa pakietu na Androida. Skopiuj tę wartość i wklej ją.

Nie będzie on potrzebny, chyba że zamierzasz użyć funkcji Zaloguj się przez Google lub Linków dynamicznych Firebase. Nie są one częścią tego ćwiczenia z programowania. Więcej informacji o kluczu SHA-1 znajdziesz w tym dokumentacji.

3. Kliknij przycisk Zarejestruj aplikację.

Pobierz plik konfiguracyjny

1. Kliknij przycisk Pobierz google-services.json, aby pobrać plik konfiguracyjny google-services.json.

2. W Android Studio przejdź do katalogu app i przenieś plik google-services.json (pobrany przed chwilą) do katalogu app. Wróć do konsoli Firebase i kliknij przycisk Dalej.

Włączanie Firebase w aplikacji

1. Aby odczytać plik google-services.json wygenerowany przez Firebase, musisz mieć wtyczkę do obsługi Gradle usług Google.
2. W Android Studio otwórz <project>/build.gradle i dodaj do pliku te wiersze:

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
      ...
      }
   }
}

3. Otwórz plik <project>/<app-module>/build.gradle i dodaj do niego te wiersze:

apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

Udało Ci się dodać Firebase do Twojej aplikacji na Androida.

W następnym kroku dowiesz się, jak dodać pakiet SDK Firebase do aplikacji.

4. Dodaj pakiet SDK Firebase do aplikacji

W tym kroku dodasz pakiet SDK Firebase, a w szczególności pakiet SDK Firebase dla Google Analytics.

Skorzystamy z Firebase Android BoM, który umożliwia zarządzanie wersjami biblioteki Firebase używanymi w aplikacji przez określenie wersji BoM. Aby dowiedzieć się, które wersje biblioteki Firebase są mapowane na konkretną wersję BoM, zapoznaj się z informacjami o wersji tej wersji BoM.

1. Otwórz plik <project>/<app-module>/build.gradle i dodaj do niego te wiersze:

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'

Jak widać, określając tylko wersję BoM, nie musisz określać wersji biblioteki Firebase Analytics. Jeśli jednak chcesz użyć żądanej wersji dla biblioteki Firebase niezależnie od tego, która wersja jest wskazana w BM, musisz tylko określić wersję w następujący sposób:

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'

2. Teraz zsynchronizuj aplikację, klikając przycisk Sync Now.

Udało Ci się dodać pakiet SDK Firebase dla Google Analytics do aplikacji na Androida.

W następnym kroku dowiesz się, jak rejestrować zdarzenia Firebase w aplikacji na Androida.

5. Rejestrowanie zdarzeń za pomocą Firebase Analytics

Z tego kroku dowiesz się, jak rejestrować zdarzenia za pomocą Firebase Analytics w aplikacji na Androida.

Możesz rejestrować zdarzenia na 2 sposoby: za pomocą zdarzeń sugerowanych lub niestandardowych.

Korzystanie z sugerowanych zdarzeń

Pakiet SDK Firebase Analytics określa szereg sugerowanych zdarzeń, które można wykorzystać w różnych typach aplikacji, takich jak gry, handel detaliczny, podróże i e-commerce. Poza tym istnieją pewne sugerowane zdarzenia, które wymagają określonych parametrów. Dzięki tym parametrom możesz zmaksymalizować liczbę dostępnych szczegółów w raportach Firebase. ( Informacje o sugerowanych zdarzeniach)

1. Zadeklaruj obiekt FirebaseAnalytics na górze aktywności:

private lateinit var firebaseAnalytics: FirebaseAnalytics

2. Zainicjuj obiekt w metodzie onCreate():

firebaseAnalytics = Firebase.analytics

3. Zacznij rejestrować zdarzenia za pomocą metody logEvent(). Ten kod rejestruje zdarzenie PURCHASE, gdy użytkownik kupi produkty w aplikacji:

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
   param(FirebaseAnalytics.Param.VALUE, 10)
   param(FirebaseAnalytics.Param.CURRENCY, "USE")
}

Korzystanie ze zdarzeń niestandardowych

Jeśli potrzebujesz zdarzeń, których nie uwzględniają sugerowane zdarzenia, możesz rejestrować własne zdarzenia niestandardowe za pomocą parametrów niestandardowych:

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

Zdarzenia debugowania

W konsoli Firebase możesz wyświetlać dane zbiorcze i raporty dotyczące zdarzeń. Jednak aktualizacje odbywają się co jakiś czas w ciągu dnia i nie możesz wyświetlić tych zdarzeń od razu po ich zalogowaniu w aplikacji.

Do bezpośredniego testowania i debugowania służy widok debugowania Firebase. DebugView umożliwia wyświetlanie danych zdarzeń rejestrowanych przez aplikację na urządzeniach używanych do programowania w czasie zbliżonym do rzeczywistego. Więcej informacji o raporcie DebugView znajdziesz w sekcji Zdarzenie debugowania.

Udało Ci się zakończyć rejestrowanie zdarzeń w aplikacji na Androida.

W następnym kroku dowiesz się, jak importować te zdarzenia do Google Ads.

6. Importowanie zdarzeń Firebase do Google Ads

Konfiguracja Firebase i Androida została ukończona. Teraz możesz uruchomić kampanię promującą aplikację z zarejestrowanymi zdarzeniami działania. Na początek połącz Firebase z Google Ads. Połączenie Firebase z Google Ads pozwoli kampaniom promującym aplikacje uzyskiwać więcej informacji o odbiorcach i umożliwiać im lepsze wyciąganie wniosków, co zwykle prowadzi do większej skuteczności i większej liczby konwersji.

Łączenie Firebase i Google Ads

1. Otwórz ustawienia Firebase, klikając przycisk obok przeglądu projektu.

2. Na karcie Integracje zobaczysz Google Ads i przycisk Połącz. Kliknij Połącz i kontynuuj.

3. Wybierz konto Google Ads, które chcesz połączyć.

Udało Ci się zakończyć łączenie Firebase i Google Ads. Zaimportujmy do Google Ads zdarzenia Firebase.

Zaimportuj zdarzenia Firebase.

1. W konsoli Firebase otwórz menu Zdarzenia i oznacz zdarzenie, które chcesz zaimportować, jako konwersję.

2. Teraz przejdź do Google Ads i zaloguj się na konto połączone z Firebase.
3. W Google Ads wybierz Narzędzia → Pomiar skuteczności → Konwersje
4. Kliknij przycisk + .
5. Wybierz Aplikacja → Usługi w Google Analytics 4 (Firebase) i kliknij Dalej.
6. Możesz wyświetlić wszystkie zdarzenia Analytics, które są oznaczone jako konwersje. Znajdź wydarzenie, które chcesz zaimportować. W tym przypadku wybierz zdarzenie delete_item, które było już zaimplementowane. Kliknij przycisk Importuj i kontynuuj.
7. Udało Ci się zaimportować zdarzenie konwersji z Firebase.

Udało Ci się zakończyć importowanie zdarzeń Firebase do Google Ads.

W następnym kroku dowiesz się, jak uruchomić kampanię zachęcającą do działania na podstawie zaimportowanego właśnie zdarzenia.

7. Uruchomienie kampanii zachęcających do działania w aplikacji z zaimportowanymi zdarzeniami

1. Otwórz kartę Kampanie promujące aplikacje na obecnym koncie Google Ads i otwórz nową kampanię, klikając przycisk +.

2. Uruchomimy kampanię promującą aplikację z opcją Instalacje aplikacji. Na dole wybierz aplikację, którą chcesz promować, i kliknij Dalej.
3. Zdarzenia możesz wyświetlić, wybierając z menu Działania w aplikacji w sekcji Określanie stawek. Wybierz zdarzenia, na których chcesz się skupić.

4. Skonfiguruj resztę ustawień kampanii i gotowe.

8. Gratulacje

Gratulujemy! Udało Ci się zintegrować Firebase z Google Ads. Pomoże Ci to zwiększyć skuteczność kampanii.

Wiesz już

• Jak skonfigurować Firebase Analytics na Androida
• Jak rejestrować zdarzenia w aplikacji na Androida za pomocą Firebase Analytics
• Jak importować zdarzenia i używać ich w kampaniach zachęcających do działania.