Google Ads ze zdarzeniami niestandardowymi Google Analytics dla Firebase – Android

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

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

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

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

4. 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ę

1. 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”

2. 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 ). .

3. Kliknij przycisk Zarejestruj aplikację.

Pobierz plik konfiguracyjny

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

2. W studiu Androida przejdź do katalogu app i przenieś plik google-services.json (który właśnie pobrałeś powyżej) do katalogu app . Wróć do konsoli Firebase i kliknij przycisk Dalej.

Włącz Firebase w swojej aplikacji

1. Aby odczytać plik google-services.json wygenerowany przez Firebase, potrzebujesz wtyczki Google Services Gradle .
2. 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
      ...
      }
   }
}

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

1. 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'

2. 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ń )

1. Zadeklaruj obiekt FirebaseAnalytics na górze działania:

private lateinit var firebaseAnalytics: FirebaseAnalytics

2. Zainicjuj obiekt w metodzie onCreate() :

firebaseAnalytics = Firebase.analytics

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

1. Przejdź do Ustawień Firebase, klikając przycisk tuż obok Przeglądu projektu.

2. W zakładce Integracje zobaczysz Google Ads oraz przycisk Link. Kliknij opcję Połącz i kontynuuj.

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

1. W konsoli Firebase przejdź do menu Zdarzenia i zaznacz zdarzenie, które chcesz zaimportować jako konwersję.

2. Teraz przejdź do Google Ads i zaloguj się na konto, które łączysz z Firebase.
3. W Google Ads przejdź do Narzędzia → Pomiary → Konwersje
4. Kliknij przycisk +
5. Wybierz Aplikacja → Właściwości Google Analytics 4 (Firebase) i kliknij Kontynuuj.
6. 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.
7. 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

1. Przejdź do karty Kampanie promujące aplikacje na swoim obecnym koncie Google Ads i rozpocznij nową kampanię, klikając przycisk +.

2. Uruchomimy kampanię promocyjną aplikacji z opcją Instalacje aplikacji. Na dole wybierz aplikację, którą chcesz promować, i kliknij Kontynuuj.
3. 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ć.

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