Zdarzenia z dzienników

Wybierz platformę: iOS+ Android Web Flutter Unity C++

Analytics automatycznie rejestruje niektóre zdarzenia, więc nie musisz dodawać żadnego kodu, aby je otrzymywać. Jeśli aplikacja musi zbierać dodatkowe dane, możesz w niej rejestrować do 500 różnych rodzajów zdarzeń Analytics. Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez aplikację. Pamiętaj, że w nazwach zdarzeń jest rozróżniana wielkość liter. Rejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje rejestrowanie 2 osobnych zdarzeń.

Zanim zaczniesz

Upewnij się, że masz skonfigurowany projekt i możesz uzyskać dostęp do Analytics zgodnie z opisem w artykule Rozpoczynanie korzystania z Analytics.

Jeśli chcesz zbierać dane o atrybucji kampanii dotyczące aplikacji na platformę Apple, dodaj do projektu bibliotekę AdSupport.

Zdarzenia z dziennika

Po utworzeniu instancji FirebaseAnalytics możesz jej używać do rejestrowania zdarzeń za pomocą metod log- biblioteki.

Wstępnie zdefiniowane zdarzenia

Aby ułatwić Ci rozpoczęcie pracy, pakiet SDK Analytics definiuje szereg polecanych zdarzeń, które są typowe dla różnych rodzajów aplikacji, w tym aplikacji handlowych i e-commerce, podróżniczych oraz gier. Więcej informacji o tych zdarzeniach i o tym, kiedy ich używać, znajdziesz w artykule Polecane zdarzenia.

Metody rejestrowania zalecanych typów zdarzeń znajdziesz w dokumentacji API.

Poniższy przykład pokazuje, jak rejestrować zdarzenie select_content:

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

Możesz też zarejestrować to samo zdarzenie za pomocą funkcji logEvent():

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

Może to być przydatne, jeśli chcesz określić dodatkowe parametry inne niż te, które są wymagane. Do dowolnego zdarzenia możesz dodać te parametry:

  • Parametry niestandardowe: parametry niestandardowe mogą być używane jako wymiary lub dane w raportach Analytics. Wymiarów niestandardowych możesz używać w przypadku nienumerycznych danych parametrów zdarzeń, a danych niestandardowych – w przypadku danych parametrów, które lepiej przedstawiają wartości liczbowe. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj wymiar lub rodzaj danych, aby te parametry niestandardowe pojawiały się w raportach Analytics. Możesz to zrobić, korzystając z opcji Analytics > Zdarzenia > Zarządzaj definicjami niestandardowymi > Utwórz wymiary niestandardowe.

    Parametry niestandardowe można stosować w definicjach list odbiorców, które można stosować w każdym raporcie. Parametry niestandardowe są też uwzględniane w danych eksportowanych do BigQuery, jeśli Twoja aplikacja jest połączona z projektem BigQuery. Przykładowe zapytania i inne informacje znajdziesz w artykule BigQuery Export w Google Analytics 4.

  • Parametr value: parametr ogólnego przeznaczenia, który jest przydatny do gromadzenia kluczowych danych dotyczących zdarzenia. Mogą to być na przykład przychody, odległość, czas i punkty.

  • Nazwy parametrów mogą mieć maksymalnie 40 znaków. Muszą zaczynać się od litery i zawierać tylko znaki alfanumeryczne oraz podkreślenia. Obsługiwane są typy ciąg znaków i liczba. Wartości parametrów ciągu znaków mogą mieć maksymalnie 100 znaków. Prefiksy „firebase”, „google” i „ga_” są zarezerwowane i nie należy ich używać w nazwach parametrów.

Zdarzenia niestandardowe

Jeśli Twoja aplikacja ma specyficzne potrzeby, których nie obejmuje zalecany typ zdarzenia, możesz rejestrować własne zdarzenia niestandardowe, jak pokazano w tym przykładzie:

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

Ustawianie domyślnych parametrów zdarzenia

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

Podobnie jak w przypadku parametrów niestandardowych zarejestruj domyślne parametry zdarzenia, aby pojawiały się w raportach Analytics.

Prawidłowe wartości parametru to ciąg tekstowy i liczba. Ustawienie wartości klucza na null powoduje wyczyszczenie tego parametru. Przekazanie wartości null powoduje wyczyszczenie wszystkich parametrów.

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

Jeśli parametr jest określony w metodzie logEvent() lub log, używana jest ta wartość zamiast wartości domyślnej.

Aby wyczyścić parametr domyślny, wywołaj metodę setDefaultEventParameters(), ustawiając parametr na null.