1. Wprowadzenie
Ostatnia aktualizacja: 19 lutego 2021 r.
Co utworzysz
Z tego Codelab dowiesz się, jak implementować zdarzenia niestandardowe za pomocą GA4F na iOS w środowisku Unity i jak uruchamiać kampanie zachęcające do działania za pomocą Google Ads.
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, zapoznaj się z artykułem AdMob i Firebase 101 Unity: konfiguracja i podstawy Analytics.
Czego się nauczysz
- Jak zainicjować GA4F (Google Analytics dla Firebase) w Unity + iOS.
- Jak tworzyć zdarzenia i parametry niestandardowe
- 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. Rozpoczęcie nowego projektu Unity
Utwórz prostą aplikację Unity opartą na szablonie. Następnie zmodyfikuj tę prostą aplikację, aby utworzyć wersję końcową.
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 w 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 sekcji Ustawienia > Ustawienia projektu. Przejdź do kroku konfiguracji Firebase.
- Zaloguj się w Firebase.
W konsoli Firebase kliknij Dodaj projekt (lub Utwórz projekt) i nazwij projekt Firebase 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ż do śledzenia zdarzeń akcji i konwersji potrzebujesz zdarzeń Google Analytics.
Więcej informacji o projektach Firebase znajdziesz w artykule Informacje o projektach Firebase.
4. Konfiguracja Unity
- Unity > Plik > Ustawienia kompilacji. Ważne jest ustawienie identyfikatora pakietu na iOS, który uzyskasz w kolejnym kroku.
Zobaczysz okno pokazane na tym ekranie.
- W projekcie Unity aplikacji na iOS otwórz okno Ustawienia kompilacji i kliknij Plik > Ustawienia kompilacji. Jeśli platforma nie jest ustawiona na iOS, możesz wybrać iOS i kliknąć przycisk Switch Platform (Przełącz platformę).
- Po zmianie platformy kliknij przycisk Ustawienia gracza, aby ustawić identyfikator pakietu. Wokół obszaru Identyfikacja pojawi się pole tekstowe.
- Wartość pola Identyfikator pakietu to identyfikator pakietu na iOS (np.
com.yourcompany.yourproject). Skopiuj tę wartość lub ustaw swoją wartość i skopiuj ją. - W oknie Firebase wklej skopiowany identyfikator pakietu w polu
iOS bundle ID. - Kliknij Zarejestruj aplikację.
- W Firebase postępuj zgodnie z instrukcjami, aby pobrać plik konfiguracji
GoogleService-Info.plist - Otwórz okno projektu Unity, a potem przenieś pliki konfiguracji do folderu 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.
- W centrum strony „Opis” projektu kliknij ikonę Unity (
), aby uruchomić proces 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. Terminy nazwa pakietu i identyfikator aplikacji są często używane zamiennie.
- Gdzie znajdziesz identyfikator swojego projektu Unity?
- (Opcjonalnie) Wpisz pseudonimy platformy dla projektu Unity. Te pseudonimy to wewnętrzne, wygodne identyfikatory, które są widoczne tylko w konsoli Firebase.
- Kliknij Zarejestruj aplikację.
Dodaj pakiety SDK Firebase Analytics Unity
- W konsoli Firebase kliknij Pobierz pakiet SDK Firebase dla Unity, a następnie rozpakuj pakiet SDK w wygodnym miejscu.
- W każdej chwili możesz ponownie pobrać pakiet SDK Firebase Unity.
- Pakiet SDK Firebase Unity nie jest związany z konkretną platformą.
- W otwartym projekcie Unity przejdź do Assets (Zasoby) i wybierz Import Package (Importuj pakiet) > Custom Package (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żyć w swojej aplikacji. Aby np. korzystać z Uwierzytelniania Firebase i Bazy danych czasu rzeczywistego Firebase: FirebaseAuth.unitypackage i FirebaseDatabase.unitypackage
- W oknie Importowanie pakietu dla Unity kliknij Importuj.
- Gdy wrócisz do konsoli Firebase, w procesie 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 Unity na iOS.
Firebase Analytics automatycznie rejestruje niektóre zdarzenia, więc nie musisz dodawać żadnego kodu, aby je otrzymywać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz w niej rejestrować maksymalnie 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
Aby sprawdzić, czy zdarzenia są prawidłowo rejestrowane przez SDK, możesz włączyć szczegółowe rejestrowanie. Dotyczy to zarówno zdarzeń rejestrowanych automatycznie, jak i ręcznie.
Logowanie szczegółowe możesz włączyć w ten sposób:
- W Xcode kliknij Produkt > Schemat > Edytuj schemat….
- W menu po lewej stronie kliknij Uruchom.
- Kliknij 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
Zarejestrowane zdarzenie pojawi się w konsoli Firebase w ciągu kilku godzin. Znajdziesz go w sekcji Analytics → Zdarzenia. Wartości parametrów możesz też wyświetlić, klikając zdarzenie.
Oznaczysz zdarzenie „text_search” jako konwersję, przesuwając przełącznik „Oznacz jako konwersję” w prawo.
Na karcie Konwersje w Firebase Analytics możesz sprawdzić, czy zdarzenie zostało oznaczone jako konwersja. Gdy zdarzenie zostanie oznaczone jako konwersja, Google Ads będzie mogło je zaimportować jako konwersję.
7. Importowanie zdarzeń analitycznych do Google Ads
Konfiguracja Firebase na iOS jest zakończona i możesz uruchomić kampanię promującą aplikację z zapisanymi zdarzeniami działania. Zacznij od połączenia 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 podsumowania projektu.
- Na karcie Integracje zobaczysz Google Ads i przycisk Połącz. Kliknij Połącz i kontynuuj.
- Wybierz konto Google Ads.
Zakończyłem już część dotyczącą Firebase.
Teraz otwórz Google Ads i zaloguj się.
- Otwórz Google Ads i zaloguj się, a potem kliknij Narzędzia i ustawienia → Pomiar skuteczności → Konwersje, aby zaimportować zdarzenia niestandardowe jako konwersje.
- Aby dodać nowe działanie powodujące konwersję, kliknij przycisk +.
- Wybierz usługi w Google Analytics 4 (Firebase) i kliknij Dalej.
- Możesz zobaczyć wszystkie zdarzenia Analytics oznaczone jako konwersje. Znajdź zaimplementowane wcześniej zdarzenie
clicked_counter.
- Zaznacz pole i kliknij przycisk Importuj i kontynuuj.
Po ustawieniu zdarzenia 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. Uruchomienie kampanii zachęcających do działania w aplikacji z zaimportowanymi zdarzeniami
- Przejdź na kartę kampanii na bieżącym koncie i rozpocznij 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 z pola 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 pozostałe 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ż
- Konfigurowanie Firebase na platformie iOS w Unity
- Jak rejestrować zdarzenia niestandardowe za pomocą Unity i Firebase Analytics
- Jak importować zdarzenia i stosować je w kampaniach z działaniem