Google Ads ze zdarzeniami niestandardowymi Google Analytics dla Firebase – iOS

1. Wprowadzenie

Ostatnia aktualizacja: 2020-12-14

Co utworzysz

Z tego ćwiczenia dowiesz się, jak wdrażać zdarzenia niestandardowe za pomocą pakietu SDK GA4F na iOS i uruchamiać kampanie zachęcające do działania w Google Ads.

Dzięki temu ćwiczeniu możesz poznać cały proces biznesowy związany z aplikacjami, z którym mają do czynienia nasi klienci. Jeśli chcesz poznać Firebase na iOS w bardziej przystępny sposób, zacznij od ćwiczenia dotyczącego Firebase na iOS – Swift.

Czego się nauczysz

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

Czego potrzebujesz

• Xcode
• Konto Firebase
• Konto Google Ads

2. Rozpocznij nowy projekt iOS Swift

Utwórz prostą aplikację na iOS w języku Swift na podstawie szablonu. Zmodyfikuj tę aplikację startową, aby utworzyć gotową aplikację.

Najpierw uruchom Xcode.

1. Jeśli nie masz otwartych projektów, na stronie powitalnej kliknij Utwórz nowy projekt Xcode.
2. U góry okna wybierz iOS.
3. W sekcji Aplikacja wybierz Aplikacja, a potem kliknij Dalej.
4. W wyświetlonym oknie dialogowym użyj tych wartości, aby nazwać aplikację i wybrać dodatkowe opcje projektu, a potem kliknij Dalej :
5. Nazwa produktu: np. ios-app

Xcode używa wpisanej nazwy produktu do nazwania projektu i aplikacji.

2. Zespół: jeśli to pole nie zostanie wypełnione automatycznie, ustaw wartość Brak.
3. Nazwa organizacji: nazwa Twojej organizacji lub Twoje imię i nazwisko.
4. Identyfikator pakietu: ta wartość jest generowana automatycznie na podstawie nazwy produktu i identyfikatora organizacji.
5. Język: Swift
6. Wybierz lokalizację, w której chcesz zapisać projekt, i kliknij Utwórz.
7. Xcode 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.

Tworzenie projektu 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.

1. Zaloguj się w Firebase.

W konsoli Firebase kliknij kolejno Dodaj projekt(lub Utwórz projekt) i nadaj projektowi w Firebase nazwę Firebase-iOS-Ads.

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ń działań i konwersji.

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

4. Konfiguracja Firebase

1. W konsoli Firebase wybierz kolejno Opis projektu > Ustawienia projektu w menu po lewej stronie, a następnie kliknij przycisk iOS w sekcji Ogólne > Twoje aplikacje.

Wyświetli się okno dialogowe widoczne na poniższym ekranie.

2. Ważną wartością, którą należy podać, jest identyfikator pakietu iOS. Uzyskasz go w następnym kroku.
3. W projekcie Xcode aplikacji na iOS wybierz aplikację najwyższego poziomu w nawigatorze projektu, a następnie kliknij kartę Ogólne.
4. Wartość pola Identyfikator pakietu to identyfikator pakietu iOS (np. com.yourcompany.yourproject). Skopiuj tę wartość.
5. W oknie Firebase wklej skopiowany identyfikator pakietu w polu iOS bundle ID.
6. Kliknij Zarejestruj aplikację.
7. W Firebase wykonaj instrukcje, aby pobrać plik konfiguracyjny. GoogleService-Info.plist

8. Otwórz projekt Xcode, a następnie przenieś pobrany plik GoogleService-Info.plist do katalogu głównego projektu Xcode.
9. Pomiń pozostałe kroki i wróć na stronę główną konsoli Firebase.

5. Konfigurowanie Firebase Analytics w Xcode

W tym kroku zaczniesz dodawać pakiet SDK Firebase do projektu Xcode.

Uwaga: usługi Google wykorzystują CocoaPods do instalacji zależności i zarządzania nimi. Jeśli nigdy wcześniej nie używałeś(-aś) CocoaPods, musisz najpierw zainstalować to narzędzie, wykonując w terminalu to polecenie:

$ sudo gem install cocoapods

1. Otwórz okno terminala i przejdź do lokalizacji projektu Xcode odpowiadającego Twojej aplikacji.
2. Utwórz plik Podfile, jeśli go nie masz:

$ pod init

3. Otwórz plik Podfile i dodaj :

$ vi Podfile

$ pod 'Firebase/Analytics'

4. Zapisz plik i uruchom :

$ pod install

5. Dodaj kod inicjowania :

Aby aplikacja łączyła się z Firebase podczas uruchamiania, dodaj poniższy kod inicjalizacji do swojej głównej klasy AppDelegate.

import UIKit
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
      [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    return true
  }
}

6. Wszystko gotowe Przejdź do konsoli.

Teraz możesz wywoływać logi zdarzeń niestandardowych.

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.

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

Analytics.logEvent("text_search", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

Ustawianie domyślnych parametrów zdarzenia

Za pomocą funkcji setDefaultEventParameters możesz rejestrować parametry w zdarzeniach. Domyślne parametry są powiązane ze wszystkimi przyszłymi zdarzeniami, które zostaną zarejestrowane.

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Wyświetlanie zdarzeń w konsoli debugowania Xcode

Możesz włączyć logowanie szczegółowe, aby monitorować rejestrowanie 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:

1. W Xcode kliknij Product (Produkt) > Scheme (Schemat) > Edit scheme (Edytuj schemat)…
2. W menu po lewej stronie kliknij Run(Uruchom).
3. Kliknij kartę Arguments (Argumenty).
4. 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.

1. Otwórz Ustawienia Firebase, klikając przycisk obok opcji Przegląd projektu.
2. Na karcie Integracje zobaczysz Google Ads i przycisk Połącz. Kliknij Połącz i kontynuuj.

3. Wybierz konto Google Ads.

Ostrzeżenie: jeśli zdarzenie docelowe nie jest oznaczone jako konwersja, 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.

Teraz otwórz Google Ads i się zaloguj.

1. Otwórz Google Ads, zaloguj się i kliknij kolejno Narzędzia i ustawienia → Pomiar skuteczności → Konwersje, aby zaimportować zdarzenia niestandardowe jako konwersje.
2. Kliknij przycisk +, aby dodać nowe działanie powodujące konwersję.

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 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 użyciem importowanych zdarzeń

Ważne: aby uruchomić kampanię promującą aplikację, musisz mieć aplikację na poziomie produkcyjnym w Google Play. Jeśli nie chcesz jeszcze opublikować aplikacji, pomiń ten krok.

6. Otwórz kartę kampanii na bieżącym koncie i zacznij nową kampanię, klikając przycisk +. Kliknij nową kampanię i kontynuuj.
7. Na ten czas uruchomimy kampanię reklamy aplikacji z opcją Instalacje aplikacji.

8. Znajdź aplikację, podając jej nazwę, nazwę pakietu lub wydawcę.
9. W sekcji Określanie stawek w menu wybierz Działania w aplikacji, aby reklamy skupiały się na działaniach.
10. na liście znajdziesz swoje zdarzenia niestandardowe. Ustaw docelowy koszt działania i wypełnij inne opcje.

11. Skonfiguruj ustawienia kampanii. Wykracza to poza zakres tego ćwiczenia, 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 Google Ads. Pomoże Ci to zwiększyć skuteczność kampanii.

Skrypt został zainstalowany, utworzono i przygotowano nową listę zmian ćwiczeń z programowania, zaktualizowano i przygotowano oczekującą listę zmian ćwiczeń z programowania, sprawdzono i zatwierdzono listę zmian ćwiczeń z programowania oraz przesłano i opublikowano listę zmian ćwiczeń z programowania.

Czego się nauczysz

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