1. Wprowadzenie
Ostatnia aktualizacja: 19.02.2021
Co utworzysz
Z tego ćwiczenia w Codelabs dowiesz się, jak w środowisku Unity wdrażać zdarzenia niestandardowe w GA4F na iOS i uruchamiać w Google Ads kampanie zachęcające do działania.
W ramach tego ćwiczenia w Codelabs możesz obejrzeć cały proces tworzenia aplikacji, z którym zmagają się nasi klienci. Jeśli chcesz dowiedzieć się więcej o Firebase i AdMob na iOS, na początek zapoznaj się z artykułem AdMob+Firebase 101 Unity: Podstawy Analytics.
Czego się nauczysz
- Jak zainicjować GA4F (Google Analytics dla Firebase) w Unity + iOS.
- Jak tworzyć zdarzenia niestandardowe i ich parametry.
- Jak importować zdarzenia z Firebase do Google Ads
- uruchamiać kampanie zachęcające do działania ze zdarzeniami niestandardowymi,
Czego potrzebujesz
- Xcode
- Unity
- Konto Firebase
- Konto Google Ads
2. Rozpocznij nowy projekt w Unity
Utwórz prostą aplikację w Unity na podstawie szablonu. Zmodyfikuj tę prostą aplikację, aby utworzyć gotową aplikację.
Uruchom Unity
- Jeśli nie masz otwartych projektów, wybierz Utwórz nowy projekt.
- W oknie wybierz szablony 3D.
- Wpisz nazwę projektu: np. Zdarzenie niestandardowe Firebase Unity.
- Wybierz lokalizację, w której chcesz zapisać projekt, i kliknij UTWÓRZ.
- Unity otwiera nowy projekt w oknie obszaru roboczego.
3. Tworzenie i konfigurowanie projektu Firebase
Aby zacząć korzystać z Firebase, musisz utworzyć i skonfigurować projekt Firebase.
Jeśli masz istniejący projekt Firebase bez włączonego Google Analytics, możesz włączyć Google Analytics na karcie Integracje w ustawieniach. Ustawienia projektu. Przejdź do kroku konfiguracji Firebase.
- Zaloguj się w Firebase.
W konsoli Firebase kliknij Dodaj projekt(lub Utwórz projekt) i nadaj projektowi Firebase nazwę Firebase-iOS-Ads
- 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.
4. Konfiguracja Unity
- W jedności > Plik > Ustawienia kompilacji. Ważne jest ustawienie identyfikatora pakietu na iOS, który uzyskasz w kolejnym kroku.
Okno dialogowe pojawi się na następnym ekranie.
- W projekcie Unity dla aplikacji na iOS otwórz okno Ustawienia kompilacji, a następnie kliknij kolejno Plik > Ustawienia kompilacji (jeśli Platforma nie jest ustawiona na iOS, możesz wybrać iOS Platform i kliknąć przycisk Przełącz platformę)
- Po zmianie platformy kliknij przycisk Ustawienia gracza, aby ustawić identyfikator pakietu. Wokół obszaru Identyfikacja pojawi się pole tekstowe.
- Wartością w polu Identyfikator pakietu jest identyfikator pakietu na iOS (np.
com.yourcompany.yourproject). Skopiuj tę wartość lub ustaw ją i skopiuj. - W oknie Firebase wklej skopiowany identyfikator pakietu w polu
iOS bundle ID. - Kliknij Zarejestruj aplikację.
- Przechodząc dalej w Firebase, postępuj zgodnie z instrukcjami, aby pobrać plik konfiguracyjny
GoogleService-Info.plist - Otwórz okno projektu w Unity i przenieś pliki konfiguracyjne do folderu Assets(Zasoby).
- 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.
- Na środku strony przeglądu projektu kliknij ikonę Unity (
), aby uruchomić przepływ pracy konfiguracji. Jeśli masz już aplikację dodaną do projektu Firebase, kliknij Dodaj aplikację, aby wyświetlić opcje platformy. - Wybierz środowisko docelowe kompilacji swojego projektu w Unity, które chcesz zarejestrować. Możesz też zarejestrować oba środowiska docelowe jednocześnie.
- Wpisz identyfikatory platformy projektu Unity.
- iOS – w polu Identyfikator pakietu na iOS wpisz identyfikator iOS projektu Unity.
- Android – w polu Nazwa pakietu na Androida wpisz identyfikator Androida projektu Unity. Określenia nazwa pakietu i identyfikator aplikacji są często używane zamiennie.
- Gdzie znajdziesz identyfikator swojego projektu w Unity?
- (Opcjonalnie) Wpisz pseudonimy związane z platformą projektu Unity. Te pseudonimy to wewnętrzne, wygodne identyfikatory, które są widoczne tylko dla Ciebie w konsoli Firebase.
- Kliknij Zarejestruj aplikację.
Dodaj pakiety SDK Firebase Analytics Unity
- W konsoli Firebase kliknij Pobierz pakiet Firebase Unity SDK i rozpakuj pakiet SDK w dogodnym miejscu.
- W każdej chwili możesz ponownie pobrać pakiet Firebase Unity SDK.
- Pakiet SDK Firebase Unity nie jest związany z konkretną platformą.
- W otwartym projekcie Unity przejdź do Assets (Zasoby) > Importuj pakiet > Pakiet niestandardowy.
- 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 wszystkich innych usług Firebase, których chcesz używać w swojej aplikacji. Aby np. skorzystać z Uwierzytelniania Firebase i Bazy danych czasu rzeczywistego Firebase: FirebaseAuth.unitypackage i FirebaseDatabase.unitypackage
- W oknie Import Unity Package (Importuj pakiet Unity) kliknij Import (Importuj).
- Gdy wrócisz do konsoli Firebase, w procesie konfiguracji kliknij Dalej.
6. Rejestrowanie zdarzeń niestandardowych w Firebase Analytics
Z tego kroku dowiesz się, jak rejestrować zdarzenia niestandardowe za pomocą Firebase Analytics w aplikacji Unity na iOS.
Firebase Analytics automatycznie rejestruje niektóre zdarzenia za Ciebie. nie musisz dodawać żadnego kodu, aby je otrzymywać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz zarejestrować w niej nawet 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świetl zdarzenia w konsoli debugowania Xcode
Możesz włączyć logowanie szczegółowe, aby monitorować logowanie zdarzeń przez pakiet SDK i sprawdzać, czy zdarzenia są prawidłowo logowane. Dotyczy to zarówno zdarzeń rejestrowanych automatycznie, jak i ręcznie.
Logowanie szczegółowe możesz włączyć w ten sposób:
- W Xcode wybierz Product > (Produkt >) Schemat > Edytuj schemat...
- W menu po lewej stronie kliknij Uruchom.
- Wybierz kartę Argumenty.
- W sekcji Arguments przekazane przy uruchomieniu dodaj -FIRAnalyticsDebugEnabled.
Przy następnym uruchomieniu aplikacji zdarzenia wyświetlą się w konsoli debugowania Xcode, co pozwoli Ci od razu sprawdzić, czy zdarzenia są wysyłane.
Wyświetlanie zdarzeń w panelu
Za kilka godzin zobaczysz zarejestrowane zdarzenie w konsoli Firebase. Znajdziesz ją w sekcji Analytics → Zdarzenia. Wartości parametrów możesz też wyświetlić, klikając zdarzenie.
Oznaczysz wartość „text_search” jako konwersję, przesuwając suwak „Oznacz jako konwersję” przesuń w prawo.
Na karcie Konwersje w Firebase Analytics możesz dokładnie sprawdzić, czy zdarzenie zostało oznaczone jako konwersja. Jeśli oznaczysz zdarzenie jako konwersję, Google Ads będzie mógł je też zaimportować jako konwersję.
7. Importowanie zdarzeń analitycznych do Google Ads
Konfiguracja Firebase w iOS dobiegła końca i 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.
- Otwórz ustawienia Firebase, klikając przycisk obok przeglądu projektu.
- Na karcie Integracje zobaczysz Google Ads i przycisk Połącz. Kliknij Połącz i kontynuuj.
- Wybierz konto Google Ads.
To już koniec działania Firebase.
Przejdź do Google Ads i zaloguj się.
- Otwórz Google Ads, zaloguj się i kliknij Narzędzia i Ustawienia → Pomiar skuteczności → Konwersje do importowania zdarzeń niestandardowych jako konwersji.
- Aby dodać nowe działanie powodujące konwersję, kliknij przycisk +.
- Wybierz usługi w Google Analytics 4 (Firebase) i kliknij Dalej.
- Możesz wyświetlić wszystkie zdarzenia Analytics, które są oznaczone jako konwersje. Znajdź zaimplementowane wcześniej zdarzenie
clicked_counter.
- Zaznacz przycisk Importuj i kontynuuj.
Po ustawieniu wartości text_search jako działania powodującego konwersję nadszedł czas na uruchomienie kampanii kierowanej na użytkowników, którzy prawdopodobnie będą wywoływać text_search zdarzeń.
8. Uruchomienie kampanii zachęcających do działania w aplikacji z zaimportowanymi zdarzeniami
- Przejdź na kartę kampanii bieżącego konta i uruchom nową kampanię, klikając przycisk +. Kliknij nową kampanię i kontynuuj.
- Tym razem uruchomimy kampanię promującą aplikację z opcją „Instalacje aplikacji”.
- Znajdź swoją aplikację, podając jej nazwę, nazwę pakietu lub wydawcę.
- W sekcji Określanie stawek wybierz w polu Działania w aplikacji Działania w aplikacji, aby reklamy skupiały się na działaniach.
- niestandardowych zdarzeń znajdziesz na wyświetlonej liście. Ustaw docelowy koszt działania i wypełnij także inne opcje.
- Skonfiguruj ustawienia kampanii. To wykracza poza zakres ćwiczeń z programowania, więc zapoznaj się z tymi dokumentami lub skontaktuj się z innymi kanałami, aby zoptymalizować ustawienia.
9. Gratulacje
Gratulacje, udało Ci się zintegrować Firebase z Unity i Google Ads. Pomoże Ci to zwiększyć skuteczność kampanii.
Wiesz już
- Jak skonfigurować Firebase dla platformy 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