1. Wstęp
Ostatnia aktualizacja: 2020-12-14
Co zbudujesz
Podczas tych zajęć z programowania dowiesz się, jak wdrażać zdarzenia za pomocą Google Analytics dla Firebase (GA4F) i uruchamiać kampanie akcji za pośrednictwem Google Ads.
Te zajęcia z programowania skupiają się na wdrażaniu zdarzeń za pomocą GA4F i importowaniu ich do Google Ads. Jeśli chcesz dowiedzieć się, jak zbudować aplikację na Androida za pomocą Firebase, zapoznaj się z przyjazną budową czatu Firebase Android Codelab .
Czego się dowiesz
- Jak utworzyć projekt Firebase
- Jak zaimplementować pakiet SDK Firebase w aplikacji na Androida
- Jak tworzyć zdarzenia i parametry.
- Jak importować wydarzenia z Firebase do Google Ads
- Uruchamiaj kampanie zachęcające do działania w Google Ads ze zdarzeniami niestandardowymi.
Co będziesz potrzebował
- Android Studio 3.6 lub nowszy
- Konto Firebase
- Konto reklamowe Google
2. Utwórz i skonfiguruj projekt Firebase
Aby rozpocząć korzystanie z Firebase, musisz utworzyć i skonfigurować projekt Firebase.
Utwórz projekt Firebase
- Zaloguj się do Firebase .
W konsoli Firebase kliknij Dodaj projekt(lub Utwórz projekt) i nazwij swój projekt Firebase według własnego uznania.
- Kliknij opcje tworzenia projektu. Jeśli pojawi się monit, zaakceptuj warunki Firebase. Powinieneś włączyć Google Analytics dla tego projektu, ponieważ potrzebujesz zdarzeń Google Analytics do śledzenia zdarzeń akcji i konwersji.
Aby dowiedzieć się więcej o projektach Firebase, zobacz Omówienie projektów Firebase .
- Wybierz konto Google Analytics. Jeśli masz, wybierz ten lub utwórz nowy. Kliknij przycisk Utwórz projekt.
- Teraz kompilacja projektu Firebase została ukończona!
W następnym kroku dowiesz się, jak dodać Firebase do swojej aplikacji na Androida.
3. Dodaj Firebase do swojej aplikacji na Androida
Zarejestruj aplikację
- W konsoli Firebase wybierz Przegląd projektu w lewym panelu nawigacyjnym, a następnie kliknij przycisk Android w sekcji „Rozpocznij od dodania Firebase do swojej aplikacji”
- Wypełnij niezbędne informacje.
Aby uzyskać nazwę pakietu Android, w studiu Android przejdź do katalogu aplikacji, otwórz plik o nazwie build.gradle
. W pliku wyszukaj applicationId
. Ta wartość to nazwa pakietu Androida. Skopiuj tę wartość i wklej ją.
Nie potrzebujemy tutaj klucza SHA-1, chyba że planujesz korzystać z logowania Google lub łączy dynamicznych Firebase (pamiętaj, że nie są one częścią tego ćwiczenia z programowania, aby uzyskać więcej informacji na temat klucza SHA-1, zapoznaj się z tym dokumentem ). .
- Kliknij przycisk Zarejestruj aplikację.
Pobierz plik konfiguracyjny
- Kliknij przycisk Pobierz google-services.json, aby pobrać plik konfiguracyjny
google-services.json
.
- W studiu Androida przejdź do katalogu
app
i przenieś plikgoogle-services.json
(który właśnie pobrałeś powyżej) do kataloguapp
. Wróć do konsoli Firebase i kliknij przycisk Dalej.
Włącz Firebase w swojej aplikacji
- Aby odczytać plik
google-services.json
wygenerowany przez Firebase, potrzebujesz wtyczki Google Services Gradle . - W studiu Android otwórz
<project>/build.gradle
, a następnie dodaj w pliku następujące linie:
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
...
}
}
}
- Otwórz
<project>/<app-module>/build.gradle
, a następnie dodaj w pliku następujące wiersze:
apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'
Zakończyłeś dodawanie Firebase do swojej aplikacji na Androida!
W następnym kroku dowiesz się, jak dodać pakiet SDK Firebase do swojej aplikacji.
4. Dodaj pakiet SDK Firebase do swojej aplikacji
Na tym etapie dodasz pakiet SDK Firebase, a konkretnie pakiet SDK Firebase dla Google Analytics.
Będziemy używać Firebase Android BoM, który umożliwia zarządzanie wersjami biblioteki Firebase, których używasz w swojej aplikacji, określając wersję BoM. Aby dowiedzieć się, które wersje bibliotek Firebase są mapowane na konkretną wersję BoM, zapoznaj się z informacjami o wydaniu tej wersji BoM.
- Otwórz
<project>/<app-module>/build.gradle
, a następnie dodaj w pliku następujące 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ć, podając tylko wersję BoM, nie musisz podawać wersji biblioteki analitycznej Firebase. Ale jeśli chcesz użyć żądanej wersji dla swojej biblioteki Firebase, niezależnie od tego, która wersja jest wyznaczona w BoM, wystarczy określić żądaną wersję w ten 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'
- Teraz zsynchronizuj swoją aplikację, klikając przycisk
Sync Now
.
Zakończyłeś dodawanie pakietu SDK Firebase dla Google Analytics do swojej aplikacji na Androida!
W następnym kroku dowiesz się, jak rejestrować zdarzenia Firebase w aplikacji na Androida.
5. Rejestruj zdarzenia za pomocą Firebase Analytics
W tym kroku dowiesz się, jak rejestrować zdarzenia za pomocą Firebase Analytics w aplikacji na Androida.
Istnieją dwa sposoby rejestrowania zdarzeń: przy użyciu sugerowanych zdarzeń lub zdarzeń niestandardowych.
Korzystanie z sugerowanych wydarzeń
Pakiet SDK Firebase Analytics definiuje szereg sugerowanych zdarzeń, które można wykorzystać w różnych typach aplikacji, takich jak gry, handel detaliczny, podróże i handel elektroniczny. Istnieją również pewne sugerowane zdarzenia, które wymagają określonych parametrów, a dzięki tym parametrom możesz zmaksymalizować dostępne szczegóły w raportach Firebase. ( Sugerowane odniesienie do wydarzeń )
- Zadeklaruj obiekt FirebaseAnalytics na górze działania:
private lateinit var firebaseAnalytics: FirebaseAnalytics
- Zainicjuj obiekt w metodzie
onCreate()
:
firebaseAnalytics = Firebase.analytics
- Rozpocznij rejestrowanie zdarzeń za pomocą metody
logEvent()
. Poniższy kod rejestruje zdarzenie PURCHASE , gdy użytkownik kupuje przedmiot(y) w aplikacji:
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
param(FirebaseAnalytics.Param.VALUE, 10)
param(FirebaseAnalytics.Param.CURRENCY, "USE")
}
Korzystanie ze zdarzeń niestandardowych
Jeśli potrzebujesz wydarzeń, które nie są objęte sugerowanymi zdarzeniami, możesz rejestrować własne zdarzenia niestandardowe z niestandardowymi parametrami:
firebaseAnalytics.logEvent("delete_item"){
param("item name", name)
param("reason", text)
}
Debuguj zdarzenia
Możesz przeglądać zbiorcze dane i raporty o swoich wydarzeniach w konsoli Firebase. Jednak aktualizacje odbywają się okresowo w ciągu dnia, nie można wyświetlić tych zdarzeń od razu po zalogowaniu się do aplikacji.
Do natychmiastowych celów testowania i debugowania możesz użyć Firebase Debugview. DebugView umożliwia przeglądanie danych zdarzeń zarejestrowanych przez aplikację na urządzeniach programistycznych w czasie zbliżonym do rzeczywistego. Informacje na temat DebugView można znaleźć w sekcji Zdarzenie debugowania .
Rejestrowanie zdarzeń w aplikacji na Androida zostało już zakończone!
W kolejnym kroku dowiesz się jak zaimportować te zdarzenia do Google Ads.
6. Zaimportuj zdarzenia Firebase do Google Ads
Konfiguracja Firebase na Androida została zakończona i możesz uruchomić kampanię aplikacji z zarejestrowanymi zdarzeniami działań. Zaczniesz od połączenia Firebase z Google Ads. Dzięki połączeniu Firebase z Google Ads kampanie promujące aplikacje będą mogły zdobywać więcej informacji o odbiorcach i zdobywać wiedzę z kampanii promujących aplikacje, co zwykle prowadzi do lepszej skuteczności i konwersji.
Połącz Firebase i Google Ads
- Przejdź do Ustawień Firebase, klikając przycisk tuż obok Przeglądu projektu.
- W zakładce Integracje zobaczysz Google Ads oraz przycisk Link. Kliknij opcję Połącz i kontynuuj.
- Wybierz konto Google Ads, które chcesz połączyć.
Zakończyłeś łączenie Firebase i Google Ads. Zaimportujmy zdarzenia Firebase do Google Ads.
Importuj zdarzenia Firebase
- W konsoli Firebase przejdź do menu Zdarzenia i zaznacz zdarzenie, które chcesz zaimportować jako konwersję.
- Teraz przejdź do Google Ads i zaloguj się na konto, które łączysz z Firebase.
- W Google Ads przejdź do Narzędzia → Pomiary → Konwersje
- Kliknij przycisk +
- Wybierz Aplikacja → Właściwości Google Analytics 4 (Firebase) i kliknij Kontynuuj.
- Możesz zobaczyć wszystkie zdarzenia analityczne oznaczone jako konwersje. Znajdź wydarzenie, które chcesz zaimportować. W tym przypadku wybierz zdarzenie
delete_item
, które zaimplementowaliśmy wcześniej. Kliknij przycisk Importuj i kontynuuj. - Pomyślnie zaimportowałeś zdarzenie konwersji z Firebase.
Zakończyłeś importowanie zdarzeń Firebase do Google Ads.
W kolejnym kroku dowiesz się jak uruchomić kampanię akcji z zaimportowanym właśnie wydarzeniem.
7. Uruchamianie kampanii akcji w aplikacji z zaimportowanymi zdarzeniami
- Przejdź do karty Kampanie promujące aplikacje na swoim obecnym koncie Google Ads i rozpocznij nową kampanię, klikając przycisk +.
- Uruchomimy kampanię promocyjną aplikacji z opcją Instalacje aplikacji. Na dole wybierz aplikację, którą chcesz promować, i kliknij Kontynuuj.
- W sekcji Licytacja, jeśli z menu rozwijanego wybierzesz Działania w aplikacji, możesz wyświetlić zdarzenia. Wybierz wydarzenie, na którym chcesz się skupić.
- Skonfiguruj pozostałe ustawienia kampanii i gotowe.
8. Gratulacje
Gratulacje, pomyślnie zintegrowałeś Firebase i Google Ads! Pomoże Ci to zwiększyć skuteczność kampanii.
Nauczyłeś się
- Jak skonfigurować Firebase Analytics dla Androida
- Jak rejestrować zdarzenia za pomocą Firebase Analytics w aplikacji na Androida.
- Jak importować wydarzenia i wykorzystywać je w kampaniach akcji.