Uruchamianie kampanii Google Ads z wykorzystaniem zdarzeń niestandardowych Google Analytics i Flutter

1. Wprowadzenie

Ostatnia aktualizacja: 25.01.2021

Co utworzysz

W tym module nauczysz się wdrażać zdarzenia niestandardowe w GA4F i uruchamiać kampanie zachęcające do działania w Google Ads w przypadku aplikacji na Flattera.

Użyjemy domyślnej aplikacji Flutter z prostym widżetem licznika. Będziemy reklamować naszą aplikację potencjalnym użytkownikom, którzy prawdopodobnie klikną widżet licznika.

Czego się nauczysz

• Jak zainicjować GA4F (Google Analytics dla Firebase) w Flutterze
• Jak tworzyć zdarzenia i parametry niestandardowe
• Importowanie zdarzeń z Firebase do Google Ads
• Jak uruchamiać kampanie zachęcające do działania ze zdarzeniami niestandardowymi

Czego potrzebujesz

• Android Studio w wersji 3.6 lub nowszej.
• Xcode (do obsługi iOS)
• Konto Firebase
• Konto Google Ads

2. Rozpocznij nowy projekt Flutter

Utwórz prostą aplikację Flutter na podstawie szablonu. W tym ćwiczeniu Codelabs zmodyfikujesz tę aplikację startową.

Uruchom Android Studio.

Uwaga: jeśli nie widzisz opcji Nowy projekt Fluttera w IDE, sprawdź, czy masz zainstalowane wtyczki do Fluttera i Darta.

1. Jeśli nie masz otwartych projektów, na stronie powitalnej kliknij Start a new Flutter app (Rozpocznij nowy projekt aplikacji Flutter). W przeciwnym razie wybierz File (Plik) > New (Nowy) > New Flutter Project (Nowy projekt Fluttera).
2. Jako typ projektu wybierz Flutter Application i kliknij Next (Dalej).
3. Sprawdź, czy ścieżka pakietu Flutter SDK wskazuje lokalizację pakietu SDK. (Jeśli pole tekstowe jest puste, kliknij Zainstaluj pakiet SDK).
4. Wpisz nazwę projektu i kliknij Dalej.
5. Użyj domyślnej nazwy pakietu sugerowanej przez Androida Studio i kliknij Dalej.
6. Kliknij Zakończ.
7. Poczekaj, aż Android Studio zainstaluje pakiet SDK i utworzy projekt.

3. Tworzenie i konfigurowanie projektu w Firebase

Aby rozpocząć korzystanie z Firebase, musisz utworzyć i skonfigurować projekt w Firebase.

Tworzenie projektu w Firebase

1. Zaloguj się w Firebase.

W konsoli Firebase kliknij Add Project (Dodaj projekt) lub Create a project (Utwórz projekt) i nadaj projektowi w Firebase nazwę Firebase-Flutter-Ads lub dowolną inną nazwę.

2. Klikaj opcje tworzenia projektu. W razie potrzeby zaakceptuj warunki usługi Firebase. Włącz Google Analytics w tym projekcie, ponieważ zdarzenia Google Analytics są potrzebne do śledzenia zdarzeń związanych z działaniami i analizowania konwersji.

Więcej informacji o projektach Firebase znajdziesz w artykule Projekty Firebase.

4. Konfiguracja Firebase dla konkretnej platformy (Android)

Konfigurowanie Androida

1. W konsoli Firebase w menu po lewej stronie wybierz Przegląd projektu, a następnie kliknij przycisk Android w sekcji „Rozpocznij, dodając Firebase do aplikacji”.

Zobaczysz okno dialogowe widoczne na poniższym ekranie.

2. Ważną wartością, którą musisz podać, jest nazwa pakietu Androida. Uzyskasz ją w kolejnym kroku.

Wskazówka: więcej informacji o identyfikatorach pakietu i aplikacji znajdziesz w artykule Ustawianie identyfikatora aplikacji.

3. W katalogu aplikacji Flutter otwórz plik android/app/src/main/AndroidManifest.xml.
4. W elemencie manifest znajdź wartość ciągu atrybutu package. Jest to nazwa pakietu na Androida (np. com.yourcompany.yourproject). Skopiuj tę wartość.
5. W oknie Firebase wklej skopiowaną nazwę pakietu w polu Android package name.
6. Nie potrzebujemy tutaj klucza SHA-1, chyba że planujesz używać logowania przez Google lub linków dynamicznych Firebase (pamiętaj, że nie są one częścią tego laboratorium). Jeśli planujesz importować dane in_app_purchase z Google Play, musisz później ustawić klucz.
7. Kliknij Zarejestruj aplikację.
8. W Firebase wykonaj instrukcje, aby pobrać plik konfiguracyjny google-services.json.

9. Otwórz katalog aplikacji Flutter, a następnie przenieś plik google-services.json (pobrany przed chwilą) do katalogu android/app.
10. Wróć do konsoli Firebase, pomiń pozostałe kroki i wróć na stronę główną konsoli Firebase.
11. Na koniec potrzebujesz wtyczki Gradle do usług Google, aby odczytać plik google-services.json wygenerowany przez Firebase.
12. W IDE lub edytorze otwórz plik android/app/build.gradle, a następnie dodaj ten wiersz jako ostatni w pliku:

apply plugin: 'com.google.gms.google-services'

13. Otwórz plik android/build.gradle, a następnie w tagu buildscript dodaj nową zależność:

buildscript { 
   repositories {
      // ...
   }
   dependencies {
      // ...
      Classpath 'com.google.gms:google-services:4.3.3'
   }
}

14. Jeśli aplikacja nadal działa, zamknij ją i zbuduj ponownie, aby umożliwić Gradle zainstalowanie zależności.

Konfigurowanie aplikacji Flutter na Androida zostało zakończone. W przypadku iOS możesz skorzystać z tych warsztatów programistycznych ( Poznaj Firebase w Flutterze).

5. Konfigurowanie Firebase Analytics w Flutterze

W tym kroku zaczniesz używać pakietu Firebase Analytics o nazwie firebase_analytics, który zawiera funkcje Firebase Analytics.

Plik pubspec zarządza komponentami aplikacji Flutter. W pubspec.yaml dodaj firebase_analytics: ^6.2.0 (firebase_analytics w wersji 6.2.0 lub nowszej) do listy zależności :

dependencies: 
   flutter: 
      sdk: flutter 
   cupertino_icons: ^0.1.2 
   firebase_analytics: ^6.2.0   # add this line

Podczas wyświetlania pliku pubspec w widoku edytora Android Studio kliknij Packages get (Pobierz pakiety). Spowoduje to pobranie pakietu do projektu. W konsoli powinny się wyświetlić te informacje:

flutter packages get 
Running "flutter packages get" in startup_namer... 
Process finished with exit code 0

Wykonanie działania Pub get automatycznie generuje też plik pubspec.lock z listą wszystkich pakietów pobranych do projektu i ich numerami wersji.

Ostrzeżenie: w przypadku niektórych wersji Firebase podczas pierwszej inicjalizacji klasy FirebaseAnalytics wyświetlany jest znak java.lang.IllegalArgumentException: Service not registered (patrz problem 1662 na GitHubie.).

W lib/main.dart zaimportuj nowy pakiet:

import 'package:firebase_analytics/firebase_analytics.dart';

W klasie MyApp zainicjuj obiekt FirebaseAnalytics, wywołując konstruktor.

class MyApp extends StatelessWidget {
 static FirebaseAnalytics analytics = FirebaseAnalytics();
   ...
}

Teraz możesz wysyłać logi zdarzeń niestandardowych.

6. Rejestrowanie zdarzeń niestandardowych za pomocą Firebase Analytics

Jeśli wygenerujesz nowy szablon w aplikacji Flutter, zobaczysz zmienną _counter i metodę _incrementCounter() w domyślnej klasie State. Teraz chcesz rejestrować zdarzenia niestandardowe, gdy przycisk zwiększania jest klikany więcej niż 5 razy przez zbyt entuzjastycznych użytkowników. Później uruchomimy kampanię promującą aplikację, aby przyciągnąć potencjalnych użytkowników.

Najpierw chcemy przekazać zainicjowane obiekty analityczne do widżetu Stateful. Zaczynamy od dodania parametru analitycznego do konstruktora MyHomePage.

MyHomePage({Key key, this.title, this.analytics}) : super(key: key);

Podczas wywoływania konstruktora dodasz też parametr analityczny.

home: MyHomePage(
   title: 'Flutter Demo Home Page',
   analytics: analytics,
),

Teraz możesz łatwo rejestrować zdarzenia za pomocą metody logEvent(). Dodaj metodę i zwiększ wartość zmiennej _counter.

void _incrementCounter() {
 setState(() {
   _counter++;

   //add this
   if(_counter > 5) { 
     widget.analytics.logEvent(name: "clicked_counter"); 
   }

 });
}

Aplikacja jest teraz gotowa do wywołania logu zdarzenia niestandardowego!

Możesz też używać gotowych metod wywoływania zdarzeń.

Wszystko jest już gotowe. W Android Studio uruchom plik „main.dart”.

(Opcjonalnie) Wysyłanie dodatkowych informacji do Firebase Analytics za pomocą parametrów

Dodatkowe informacje możesz przesyłać za pomocą parametrów. Parametry niestandardowe można rejestrować na potrzeby raportowania w raportach Analytics. Można ich też używać jako filtrów w definicjach odbiorców, które można stosować do poszczególnych raportów. Jeśli Twoja aplikacja jest połączona z projektem BigQuery, parametry niestandardowe znajdziesz też w BigQuery (patrz BigQuery Export for Firebase).

Ustawiamy tutaj wartość _counter jako parametr.

void _incrementCounter() {
 setState(() {
   _counter++;

   if(_counter > 5) {
     widget.analytics.logEvent(name: "clicked_counter", parameters: {'count' : _counter});
   }
 });
}

Sprawdzanie i debugowanie zdarzeń

Po kilku godzinach zarejestrowane zdarzenia będą widoczne w konsoli Firebase. Wystarczy, że w sekcji Analytics w konsoli Firebase klikniesz kartę Zdarzenia. Możesz też sprawdzić wartości w zdarzeniu clicked_counter, klikając je.

Oznacz clicked_counter jako konwersję, przesuwając przełącznik Oznacz jako konwersję w prawo.

Jeśli zdarzenie znajduje się na karcie Konwersje, oznacza to, że zostało ono prawidłowo oznaczone jako konwersja. Google Ads będzie teraz mogło importować to zdarzenie z Firebase.

Do debugowania używaj widoku debugowania Firebase. Więcej informacji znajdziesz w artykule Debugowanie zdarzenia.

7. Importowanie zdarzeń analitycznych w Google Ads

Po zakończeniu konfiguracji Firebase-Flutter możesz uruchomić kampanie promujące aplikacje ze zdarzeniami związanymi z działaniami. Zacznij od połączenia Firebase z Google Ads. Połączenie Firebase z Google Ads umożliwia kampaniom promującym aplikację importowanie zdarzeń Firebase. Ten proces pomaga też zwiększać skuteczność kampanii promujących aplikacje w Google Ads, ponieważ umożliwia uzyskiwanie większej ilości informacji o odbiorcach.

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, a następnie Dalej.

3. Wybierz konto Google Ads.

Ostrzeżenie: jeśli zdarzenie docelowe nie jest oznaczone jako zdarzenie konwersji, Google Ads nie będzie w stanie go zaimportować. Sprawdź, czy zdarzenie jest prawidłowo oznaczone jako konwersja.

Część dotycząca Firebase jest już gotowa.

Otwórz Google Ads.

1. Zaloguj się i kliknij Narzędzia i ustawienia > Pomiar skuteczności > Konwersje, aby zaimportować zdarzenia niestandardowe jako konwersje.
2. Aby dodać nowe działania powodujące konwersję, kliknij przycisk +.

3. Wybierz Usługi w Google Analytics 4 (Firebase) i kliknij Dalej.

4. Możesz zobaczyć wszystkie zdarzenia analityczne oznaczone jako konwersje. Znajdź zdarzenie clicked_counter, które zostało wcześniej wdrożone.

5. Zaznacz działanie, kliknij Importuj,a potem kliknij Dalej.

Po ustawieniu clicked_counter jako działania powodującego konwersję możesz uruchamiać kampanie zachęcające do działania, które mogą kierować reklamy na użytkowników, którzy prawdopodobnie wywołają zdarzenia clicked_counter więcej niż 5 razy.

8. Uruchamianie kampanii promujących działania w aplikacji z importowanymi zdarzeniami

Ważne: aby skutecznie uruchomić kampanię promującą aplikację, musisz mieć aplikację w wersji produkcyjnej w Google Play. Jeśli jednak nie chcesz jeszcze publikować, możesz na razie pominąć ten krok.

6. Otwórz kartę kampanii na bieżącym koncie i zacznij nową kampanię, klikając przycisk +. Kliknij [Nowa kampania], a potem Dalej.
7. Uruchom kampanię promującą aplikację z opcją Instalacje aplikacji.

8. Znajdź aplikację, wpisując jej nazwę, nazwę pakietu lub wydawcę.
9. W sekcji Określanie stawek wybierz z menu Działania w aplikacji.
10. Znajdź na liście zdarzenie niestandardowe. Ustaw docelowy koszt działania i skonfiguruj dodatkowe opcje.

11. Dokończ konfigurowanie kampanii.

9. Gratulacje

Udało Ci się zintegrować Firebase z Google Ads. Pomoże Ci to zwiększyć skuteczność kampanii dzięki zaimportowanym zdarzeniom Firebase.

Czego się nauczysz

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