Google Ads ze zdarzeniami niestandardowymi Google Analytics dla Firebase – iOS

1. Wprowadzenie

Ostatnia aktualizacja: 14.12.2020

Co utworzysz

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

W tym laboratorium programistycznym możesz zapoznać się z całym procesem związanym z prowadzeniem działalności związanej z aplikacjami, z którym mierzą się nasi klienci. Jeśli chcesz zapoznać się z Firebase na iOS, zacznij od Firebase iOS Codelab Swift.

Czego się nauczysz

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

2. Rozpocznij nowy projekt Swift na iOS

Utwórz prostą aplikację Swift na iOS opartą na szablonie. Aby utworzyć gotową aplikację, zmodyfikuj tę aplikację startową.

Najpierw uruchom Xcode.

1. Jeśli nie masz otwartych projektów, wybierz Utwórz nowy projekt Xcode na stronie powitalnej.
2. U góry okna wybierz iOS.
3. W sekcji Aplikacja wybierz Aplikacja, a następnie kliknij Dalej.
4. W oknie, które się wyświetli, użyj podanych niżej wartości, aby nadać nazwę aplikacji i wybrać dodatkowe opcje projektu, a potem kliknij Dalej:
5. Nazwa produktu: np. ios-app

Xcode wykorzystuje podaną przez Ciebie nazwę produktu do nadania nazwy projektowi i aplikacji.

2. Zespół: jeśli nie zostanie wypełniony automatycznie, ustaw zespół na Brak.
3. Nazwa organizacji: nazwa 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 dotychczasowy projekt 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 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ż do śledzenia zdarzeń akcji i konwersji potrzebujesz zdarzeń Google Analytics.

Więcej informacji o projektach Firebase znajdziesz w artykule Omówienie projektów Firebase.

4. Konfiguracja Firebase

1. W konsoli Firebase kliknij Opis projektu > Ustawienia projektu w menu nawigacyjnym po lewej stronie, a potem 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 aplikacji na iOS wybierz aplikację najwyższego poziomu w nawigatorze projektu, a następnie kliknij 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. W Firebase postępuj zgodnie z instrukcjami, aby pobrać plik konfiguracji GoogleService-Info.plist

8. Otwórz projekt Xcode, a potem przenieś plik GoogleService-Info.plist (który został właśnie pobrany) 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 wykorzystują CocoaPods do instalowania zależności i zarządzania nimi. 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 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 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, więc 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 zdarzeń

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.

Aby włączyć logowanie szczegółowe, wykonaj te czynności:

1. W Xcode wybierz Product > Scheme > Edit schema... (Produkt > Schemat > Edytuj schemat...)
2. W menu po lewej stronie kliknij Uruchom.
3. Kliknij kartę Argumenty.
4. W sekcji Argumenty przekazywane podczas uruchamiania 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 ją 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 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 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.

1. Otwórz Ustawienia Firebase, klikając przycisk obok podsumowania 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.

Zakończyłem już część dotyczącą Firebase.

Teraz otwórz Google Ads i zaloguj się.

1. Otwórz Google Ads i zaloguj się, a potem kliknij 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 Analytics oznaczone jako konwersje. Znajdź wcześniej zaimplementowane zdarzenie clicked_counter.

5. Zaznacz przycisk Importuj i kontynuuj.

Po ustawieniu zdarzenia text_search jako działania konwersji możesz uruchomić kampanię kierowaną na użytkowników, którzy prawdopodobnie wywołają zdarzenia text_search.

8. Uruchamianie kampanii promujących działanie w aplikacji za pomocą importowanych zdarzeń

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

6. Otwórz kartę Kampanie na bieżącym koncie i utwórz nową kampanię, klikając przycisk +. Kliknij nową kampanię i kontynuuj.
7. Tym razem uruchomimy kampanię promującą aplikację z opcją instalacji aplikacji.

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

11. Skonfiguruj ustawienia kampanii. Nie jest to objęte zakresem Codelab, więc zapoznaj się z tymi dokumentami lub skontaktuj się z nami przez dowolny inny kanał, aby uzyskać pomoc w optymalizacji ustawień.

9. Gratulacje

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

Zainstalowano skrypt, utworzono i przetestowano nową listę zmian w codelab, zaktualizowano i przetestowano oczekującą listę zmian w codelab, sprawdzono i zatwierdzono listę zmian w codelab oraz przesłano i opublikowano listę zmian w codelab.

Co się nauczysz

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