1. Wprowadzenie
Ostatnia aktualizacja: 2021-02-19
Co utworzysz
Z tego samouczka dowiesz się, jak wdrożyć zdarzenia niestandardowe za pomocą GA4F na iOS w środowisku Unity i uruchamiać kampanie zachęcające do działania w Google Ads.
W tym samouczku możesz przejść przez cały proces biznesowy związany z aplikacjami, z którym mają do czynienia nasi klienci. Jeśli chcesz poznać podstawy Firebase i AdMob na iOS, zacznij od artykułu AdMob+Firebase 101 Unity: Setup & Analytics Basics (w języku angielskim).
Czego się nauczysz
- Jak zainicjować GA4F (Google Analytics dla Firebase) w Unity i iOS.
- Jak tworzyć zdarzenia i parametry niestandardowe.
- Jak importować zdarzenia z Firebase do Google Ads.
- Uruchamiaj kampanie zachęcające do działania ze zdarzeniami niestandardowymi.
Czego potrzebujesz
- Xcode
- Unity
- Konto Firebase
- Konto Google Ads
2. Rozpocznij nowy projekt Unity
Utwórz prostą aplikację Unity opartą na szablonie. Zmodyfikuj ją, aby uzyskać gotową aplikację.
Uruchom Unity
- Jeśli nie masz otwartych projektów, wybierz opcję utworzenia nowego projektu.
- Wybierz szablony 3D w oknie.
- Wpisz nazwę projektu, np. Unity Firebase Custom Event.
- Wybierz lokalizację, w której chcesz zapisać projekt, i kliknij UTWÓRZ.
- Unity otworzy nowy projekt w oknie obszaru roboczego.
3. Tworzenie i konfigurowanie projektu w Firebase
Aby rozpocząć korzystanie z Firebase, musisz utworzyć i skonfigurować projekt w Firebase.
Jeśli masz dotychczasowy projekt w Firebase bez włączonej usługi Google Analytics, możesz ją włączyć na karcie Integracje w sekcji Ustawienia > Ustawienia projektu. Przejdź do kroku konfiguracji Firebase.
- Zaloguj się w Firebase.
W konsoli Firebase kliknij kolejno Dodaj projekt(lub Utwórz projekt) i nadaj projektowi w Firebase nazwę Firebase-iOS-Ads.
- 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ń działań i konwersji.
Więcej informacji o projektach Firebase znajdziesz w artykule Projekty Firebase.
4. Konfiguracja Unity
- W Unity otwórz File > Build Settings (Plik > Ustawienia kompilacji). Ważne jest ustawienie identyfikatora pakietu iOS, który uzyskasz w następnym kroku.
Wyświetli się okno dialogowe widoczne na poniższym ekranie.
- W projekcie Unity aplikacji na iOS otwórz okno dialogowe Ustawienia kompilacji (Build Settings) – Plik > Ustawienia kompilacji. Jeśli platforma nie jest ustawiona na iOS, możesz wybrać platformę iOS i kliknąć przycisk Przełącz platformę.
- Po zmianie platformy kliknij przycisk Ustawienia odtwarzacza, aby ustawić identyfikator pakietu. Pole tekstowe zobaczysz w obszarze Identyfikacja.
- Wartość pola Identyfikator pakietu to identyfikator pakietu iOS (np.
com.yourcompany.yourproject). Skopiuj tę wartość lub ustaw własną i ją skopiuj. - W oknie Firebase wklej skopiowany identyfikator pakietu w polu
iOS bundle ID. - Kliknij Zarejestruj aplikację.
- W Firebase wykonaj instrukcje, aby pobrać plik konfiguracyjny.
GoogleService-Info.plist - Otwórz okno projektu w Unity, a następnie przenieś pliki konfiguracyjne do folderu Assets.
- Pomiń pozostałe kroki i wróć na stronę główną konsoli Firebase.
5. Konfigurowanie Firebase Analytics w Unity
W tym kroku zaczniesz dodawać pakiet SDK Firebase do projektu Unity.
- Otwórz konsolę Firebase.
- W centrum strony przeglądu projektu kliknij ikonę Unity (
), aby uruchomić proces konfiguracji. Jeśli masz już aplikację w projekcie w Firebase, kliknij Dodaj aplikację, aby wyświetlić opcje platformy. - Wybierz cel kompilacji projektu Unity, który chcesz zarejestrować. Możesz też zarejestrować oba cele jednocześnie.
- Wpisz identyfikatory projektu Unity dla poszczególnych platform.
- W przypadku iOS – w polu Identyfikator pakietu iOS wpisz identyfikator projektu Unity na iOS.
- Android – w polu Nazwa pakietu na Androida wpisz identyfikator Androida w projekcie Unity. Terminy nazwa pakietu i identyfikator aplikacji są często używane zamiennie.
- Gdzie znajdę identyfikator projektu Unity?
- (Opcjonalnie) Wpisz pseudonimy projektu Unity specyficzne dla platformy. Te pseudonimy są wewnętrznymi identyfikatorami ułatwiającymi pracę i są widoczne tylko dla Ciebie w konsoli Firebase.
- Kliknij Zarejestruj aplikację.
Dodawanie pakietów SDK Firebase Analytics dla Unity
- W konsoli Firebase kliknij Pobierz pakiet Firebase Unity SDK, a następnie rozpakuj go w dogodnym miejscu.
- W każdej chwili możesz ponownie pobrać pakiet Firebase Unity SDK.
- Pakiet Firebase Unity SDK nie jest przeznaczony na konkretną platformę.
- W otwartym projekcie Unity kliknij Assets (Zasoby) > Import Package (Importuj pakiet) > Custom Package (Własny pakiet).
- W rozpakowanym pakiecie SDK wybierz obsługiwane usługi Firebase, których chcesz używać w aplikacji.
- Dodaj pakiet Firebase dla Google Analytics: FirebaseAnalytics.unitypackage.
- Dodaj pakiety innych usług Firebase, których chcesz używać w swojej aplikacji. Jeśli na przykład chcesz korzystać z Uwierzytelniania Firebase i Bazy danych czasu rzeczywistego Firebase, dodaj pakiety FirebaseAuth.unitypackage i FirebaseDatabase.unitypackage.
- W oknie Import Unity Package (Importowanie pakietu dla Unity) kliknij Import (Importuj).
- Wróć do konsoli Firebase i w przepływie pracy konfiguracji kliknij Dalej.
6. Rejestrowanie zdarzeń niestandardowych za pomocą Firebase Analytics
W tym kroku dowiesz się, jak rejestrować zdarzenia niestandardowe za pomocą Firebase Analytics w aplikacji na iOS w Unity.
Firebase Analytics automatycznie rejestruje niektóre zdarzenia. Aby je otrzymywać, nie musisz dodawać żadnego kodu. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz w niej rejestrować do 500 różnych typów zdarzeń niestandardowych Analytics.
Rejestrowanie zdarzeń
Po skonfigurowaniu instancji FirebaseApp możesz zacząć rejestrować zdarzenia za pomocą metody logEvent().
Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);
Wyświetlanie zdarzeń w konsoli debugowania Xcode
Możesz włączyć logowanie szczegółowe, aby monitorować logowanie zdarzeń przez pakiet SDK i sprawdzać, czy zdarzenia są rejestrowane prawidłowo. Obejmuje to zdarzenia rejestrowane automatycznie i ręcznie.
Logowanie szczegółowe możesz włączyć w ten sposób:
- W Xcode kliknij Product (Produkt) > Scheme (Schemat) > Edit scheme (Edytuj schemat)…
- W menu po lewej stronie kliknij Run(Uruchom).
- Kliknij kartę Arguments (Argumenty).
- W sekcji Arguments Passed On Launch (Argumenty przekazywane przy uruchamianiu) dodaj -FIRAnalyticsDebugEnabled.
Gdy następnym razem uruchomisz aplikację, zdarzenia będą wyświetlane w konsoli debugowania Xcode, co pozwoli Ci od razu sprawdzić, czy są wysyłane.
Wyświetlanie zdarzeń w panelu
Zarejestrowane zdarzenie pojawi się w konsoli Firebase w ciągu kilku godzin. Znajduje się on w sekcji Analytics → Zdarzenia. Wartości parametrów możesz też znaleźć, klikając zdarzenie.
Aby oznaczyć „text_search” jako konwersję, przesuń przełącznik „Oznacz jako konwersję” w prawo.
Możesz sprawdzić, czy zdarzenie zostało prawidłowo oznaczone jako konwersja, na karcie Konwersje w Firebase Analytics. Oznaczenie zdarzenia jako konwersji umożliwi też Google Ads importowanie go jako konwersji.
7. Importowanie zdarzeń analitycznych w Google Ads
Konfiguracja Firebase w iOS została zakończona i możesz uruchomić kampanię promującą aplikację z zarejestrowanymi zdarzeniami dotyczącymi działań. Zacznij od połączenia Firebase z Google Ads. Połączenie Firebase z Google Ads umożliwi kampaniom promującym aplikacje zdobywanie większej ilości informacji o odbiorcach i zwiększanie skuteczności uczenia się, co zwykle prowadzi do lepszych wyników i większej liczby konwersji.
- Otwórz Ustawienia Firebase, klikając przycisk obok opcji Przegląd projektu.
- Na karcie Integracje zobaczysz Google Ads i przycisk Połącz. Kliknij Połącz i kontynuuj.
- Wybierz konto Google Ads.
Część dotycząca Firebase jest już gotowa.
Teraz otwórz Google Ads i się zaloguj.
- Otwórz Google Ads, zaloguj się i kliknij kolejno Narzędzia i ustawienia → Pomiar skuteczności → Konwersje, aby zaimportować zdarzenia niestandardowe jako konwersje.
- Kliknij przycisk +, aby dodać nowe działanie powodujące konwersję.
- Wybierz Usługi w Google Analytics 4 (Firebase) i kliknij Dalej.
- Możesz zobaczyć wszystkie zdarzenia analityczne oznaczone jako konwersje. Znajdź zdarzenie
clicked_counter, które zostało wcześniej wdrożone.
- Zaznacz pole wyboru i kliknij przycisk Importuj i kontynuuj.
Po ustawieniu text_search jako działania powodującego konwersję możesz uruchomić kampanię kierowaną na użytkowników, którzy prawdopodobnie wywołają zdarzenia text_search.
8. Uruchamianie kampanii promujących działania w aplikacji z importowanymi zdarzeniami
- Otwórz kartę kampanii na bieżącym koncie i zacznij nową kampanię, klikając przycisk +. Kliknij nową kampanię i kontynuuj.
- Na ten czas uruchomimy kampanię promującą aplikację z opcją Instalacje aplikacji.
- Znajdź aplikację, podając jej nazwę, nazwę pakietu lub wydawcę.
- W sekcji Określanie stawek w menu wybierz Działania w aplikacji, aby reklamy skupiały się na działaniach.
- zdarzenia niestandardowe znajdziesz na podanej liście. Ustaw docelowy koszt działania i wypełnij inne opcje.
- Skonfiguruj ustawienia kampanii. Wykracza to poza zakres tego laboratorium, więc zapoznaj się z tymi dokumentami lub skontaktuj się z nami w inny sposób, aby zoptymalizować ustawienia.
9. Gratulacje
Udało Ci się zintegrować Firebase z Unity i Google Ads. Pomoże Ci to zwiększyć skuteczność kampanii.
Czego się nauczysz
- Konfigurowanie Firebase na platformie Unity iOS
- Jak rejestrować zdarzenia niestandardowe za pomocą Unity i Firebase Analytics
- Jak importować zdarzenia i używać ich w kampaniach zachęcających do działania.