Google Ads ze zdarzeniami niestandardowymi Google Analytics dla Firebase – iOS

1. Wprowadzenie

Ostatnia aktualizacja: 14.12.2020

Co utworzysz

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

Dzięki temu ćwiczeniu w Codelabs możesz poznać cały proces tworzenia aplikacji, z którym zmagają się nasi klienci. Jeśli chcesz dowiedzieć się więcej o Firebase na iOS, zacznij od Firebase iOS Codelab Swift.

Czego się nauczysz

• Jak zainicjować GA4F (Google Analytics dla Firebase) w iOS Swift
• 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
• Konto Firebase
• Konto Google Ads

2. Rozpocznij nowy projekt iOS Swift

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

Najpierw uruchom Xcode.

1. Jeśli nie masz otwartych projektów, wybierz Utwórz nowy projekt Xcode na stronie powitalnej.
2. Wybierz iOS u góry okna.
3. W sekcji Aplikacja wybierz Aplikacja, a następnie kliknij Dalej.
4. W wyświetlonym oknie dialogowym wpisz następujące wartości, aby nazwać aplikację i wybrać dodatkowe opcje projektu. Następnie kliknij Dalej :
5. Nazwa produktu: np. aplikacja na iOS

Xcode wykorzystuje podaną przez Ciebie nazwę produktu do nazwania Twojego projektu i aplikacji.

2. Zespół: jeśli to pole nie zostało wypełnione automatycznie, ustaw zespół jako 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 Firebase

Aby zacząć korzystać z Firebase, musisz utworzyć i skonfigurować projekt Firebase.

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

1. Zaloguj się w Firebase.

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

2. 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 Firebase

1. W konsoli Firebase wybierz Informacje o projekcie > Ustawienia projektu w panelu nawigacyjnym po lewej stronie, a następnie kliknij przycisk iOS w sekcji Ogólne > Twoje aplikacje

Okno dialogowe pojawi się na następnym ekranie.

2. Pamiętaj, by podać identyfikator pakietu na iOS, który uzyskasz w kolejnym kroku.
3. W projekcie Xcode dla aplikacji na iOS wybierz aplikację najwyższego poziomu w nawigatorze projektów, a następnie wybierz kartę Ogólne.
4. Wartością w polu Identyfikator pakietu jest identyfikator pakietu na 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. Przechodząc dalej w Firebase, postępuj zgodnie z instrukcjami, aby pobrać plik konfiguracyjny GoogleService-Info.plist

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

5. Konfiguracja Firebase Analytics w Xcode

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

Uwaga: usługi Google do instalacji zależności i zarządzania nimi używają CocoaPods. Jeśli korzystasz z CocoaPods po raz pierwszy, musisz go zainstalować, uruchamiając w terminalu to polecenie:

$ sudo gem install cocoapods

1. Otwórz okno terminala i przejdź do lokalizacji projektu Xcode 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 polecenie :

$ pod install

5. Dodaj kod inicjowania :

Aby łączyć się z Firebase podczas uruchamiania aplikacji, dodaj poniższy kod inicjowania 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 Otwórz konsolę.

Teraz możesz uruchomić logi zdarzeń niestandardowych.

6. Rejestrowanie zdarzeń niestandardowych w Firebase Analytics

Z tego kroku dowiesz się, jak rejestrować zdarzenia niestandardowe za pomocą Firebase Analytics w aplikacji 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().

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

Ustawianie domyślnych parametrów zdarzenia

Możesz rejestrować parametry w różnych zdarzeniach za pomocą metody setDefaultEventParameters. Parametry domyślne są powiązane ze wszystkimi przyszłymi zdarzeniami, które są rejestrowane.

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

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ą 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:

1. W Xcode wybierz Product > (Produkt >) Schemat > Edytuj schemat...
2. W menu po lewej stronie kliknij Uruchom.
3. Wybierz kartę Argumenty.
4. 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.

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 i kontynuuj.

3. Wybierz konto Google Ads.

Uwaga: jeśli zdarzenie docelowe nie jest oznaczone jako konwersja, Google Ads nie może go zaimportować. Sprawdź, czy zdarzenie jest prawidłowo oznaczone jako konwersja.

To już koniec działania Firebase.

Przejdź do Google Ads i zaloguj się.

1. Otwórz Google Ads, zaloguj się i kliknij Narzędzia i Ustawienia → Pomiar skuteczności → Konwersje do importowania zdarzeń niestandardowych jako konwersji.
2. Aby dodać nowe działanie powodujące konwersję, kliknij przycisk +.

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

4. Możesz wyświetlić wszystkie zdarzenia Analytics, które są oznaczone jako konwersje. Znajdź zaimplementowane wcześniej zdarzenie clicked_counter.

5. Zaznacz przycisk Importuj i kontynuuj.

Po ustawieniu text_search jako działania powodującego konwersję możesz rozpocząć kampanię kierowaną na użytkowników, którzy prawdopodobnie będą wywoływać zdarzenia typu text_search.

8. Uruchomienie kampanii zachęcających do działania w aplikacji z zaimportowanymi zdarzeniami

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

6. Przejdź na kartę kampanii bieżącego konta i uruchom nową kampanię, klikając przycisk +. Kliknij nową kampanię i kontynuuj.
7. Tym razem uruchomimy kampanię promującą aplikację z opcją „Instalacje aplikacji”.

8. Znajdź swoją aplikację, podając jej nazwę, nazwę pakietu lub wydawcę.
9. W sekcji Określanie stawek wybierz w polu Działania w aplikacji Działania w aplikacji, aby reklamy skupiały się na działaniach.
10. niestandardowych zdarzeń znajdziesz na wyświetlonej liście. Ustaw docelowy koszt działania i wypełnij także inne opcje.

11. 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

Gratulujemy! Udało Ci się zintegrować Firebase z Google Ads. Pomoże Ci to zwiększyć skuteczność kampanii.

Udało Ci się zainstalować skrypt, utworzyć i przeprowadzić nową listę zmian ćwiczeń z programowania, zaktualizować i przetestować listę oczekujących zmian, sprawdzić i zatwierdzić listę zmian ćwiczeń z programowania, a także przesłać i opublikować listę zmian ćwiczeń z programowania.

Wiesz już

• Jak skonfigurować 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