Wysyłaj wiadomości za pomocą konsoli Firebase

Można wysyłać powiadomień Używanie Powiadomienia kompozytora w konsoli Firebase. Pomimo tego, że nie daje taką samą elastyczność lub skalowalność jak wysyłanie wiadomości z Admin SDK lub HTTP i XMPP protokołów , może to być bardzo przydatne do testowania lub bardzo ukierunkowany marketing i zaangażowania użytkownika. Konsola Firebase zapewnia analityczne oparte testy A / B do pomocy udoskonalić i poprawić wiadomości marketingowych.

Po opracowali logiki aplikacji, aby otrzymywać wiadomości, można umożliwić użytkownikom nietechniczne wysyłać wiadomości zgodnie z instrukcją w Powiadomień stronie w Centrum pomocy Firebase.

O

Po wysłaniu powiadomienia od kompozytora Powiadomienia , Google używa wartości wpisanych w polach formularzy w następujący sposób:

  • Obszary takie jak segmentu użytkownika i wygasa określić opcje docelowych i dostarczanie wiadomości.
  • Obszary takie jak tekst powiadomień i danych niestandardowych są wysyłane do klienta w bloku danych składa się z par klucz / wartość.

Te pola są mapowane na klucze dostępne za pośrednictwem protokołów serwera FCM. Na przykład, par klucz / wartość wpisana w niestandardowych danych są traktowane jako ładunek danych dla zgłoszenia. Pozostałe pola map bezpośrednio do kluczy w FCM ładowności powiadomień .

Zauważ, że niektóre pola kompozytora Powiadomienia nie są dostępne za pośrednictwem protokołów serwerowych FCM. Na przykład, można kierować segmenty użytkowników na podstawie wersji aplikacji, język, typ przeglądarki i wersji, lub właściwości użytkownika w taki sposób, że nie są dostępne przy użyciu to pola w API serwera.

Klucze wysyłane przez konsolę Firebase do klientów to:

Klucz Etykieta pola konsoli Opis
notification.title Tytuł powiadomienia Wskazuje tytuł powiadomienia.
notification.body Tekst powiadomienia Wskazuje tekst treści powiadomienia.
data Dane niestandardowe Pary klucz/wartość, które definiujesz. Są one dostarczane jako ładunek danych do obsługi przez aplikację.

Klucze określające dostarczanie wiadomości obejmują:

Klucz Etykieta pola konsoli Opis
sound Dźwięk

Wskazuje dźwięk do odtworzenia, gdy urządzenie otrzyma powiadomienie.

time_to_live Wygasa

Ten parametr określa, jak długo (w sekundach) wiadomość powinna być przechowywana w pamięci FCM, jeśli urządzenie jest w trybie offline. Aby uzyskać więcej informacji, zobacz Ustawianie żywotność wiadomości .

Dzienniki audytu

Ta strona opisuje dzienników inspekcji stworzone przez Firebase w ramach cloud Audytu dzienników .

Przegląd

Usługi Firebase zapisują dzienniki kontrolne, aby pomóc Ci odpowiedzieć na pytania „Kto co zrobił, gdzie i kiedy?” Są Chmura Audit Logs, o ile w ramach projektu Google Cloud podłączonego do projektu Firebase . Każdy z Twoich projektów Firebase zawiera tylko dzienniki kontrolne zasobów, które znajdują się bezpośrednio w projekcie.

Dla ogólnego przeglądu Cloud Audytu dzienników, przejdź do cloud Audytu dzienników . Dla głębszego zrozumienia Cloud Audytu Logi przeglądu Understanding dzienników inspekcji .

Cloud Audit Logs przechowuje trzy dzienniki kontrolne dla każdego projektu, folderu i organizacji Google Cloud:

  • Dzienniki kontrolne aktywności administratora
  • Dzienniki kontroli dostępu do danych
  • Dzienniki audytu zdarzeń systemowych

Tylko wtedy, gdy wyraźnie włączone, Firebase Powiadomienia konsoli pisze dzienniki kontroli dostępu do danych. Dzienniki kontrolne dostępu do danych zawierają wywołania interfejsu API, które odczytują konfigurację lub metadane zasobów, a także wywołania interfejsu API sterowane przez użytkownika, które tworzą, modyfikują lub odczytują dane zasobów dostarczone przez użytkownika. Dzienniki audytu dane dostępowe nie rejestrują operacje dostępu do danych na temat zasobów, które są publicznie udostępnione (dostępny dla wszystkich użytkowników lub wszystkich uwierzytelnionych użytkowników) lub które mogą być dostępne bez logowania do Google Cloud.

Firebase Powiadomienia Konsola administratora nie pisze dzienniki AUDYTEM.

Firebase Powiadomienia Konsola nie pisze dzienniki zdarzeń systemu kontroli.

Audytowane operacje

Poniżej podsumowano, które operacje interfejsu API odpowiadają poszczególnym typom dziennika kontrolnego w Firebase Notifications Console :

Kategoria dzienników kontroli Działania konsoli powiadomień Firebase Wpisz nazwę (używane do wyszukiwania dzienników w interfejsie użytkownika)
Dzienniki dostępu do danych (DATA_READ) Pobierz kampanię Pobierz kampanię
Dzienniki dostępu do danych (DATA_READ) Lista kampanii Lista kampanii
Dzienniki dostępu do danych (DATA_READ) Uzyskaj informacje z powiadomienia o eksperymencie ABT LegacyGetRollout
Dzienniki dostępu do danych (DATA_READ) Uzyskaj możliwości kierowania GetAudiences
Dzienniki dostępu do danych (DATA_READ) Uzyskaj statystyki fcm (liczba wysłanych/otwartych/dostarczonych/przekonwertowanych) GetFcmStats
Dzienniki dostępu do danych (DATA_READ) Uzyskaj listę etykiet analitycznych dla zakresu dat i projektu. GetAnalyticsListaEtykiet
Dzienniki dostępu do danych (DATA_WRITE) Utwórz kampanię Utwórz kampanię
Dzienniki dostępu do danych (DATA_WRITE) Usuń kampanię Usuń kampanię
Dzienniki dostępu do danych (DATA_WRITE) Zaktualizuj kampanię Aktualizuj kampanię
Dzienniki dostępu do danych (DATA_WRITE) Utwórz wdrożenie z ABT LegacyUtwórzWdrożenie

Format dziennika kontroli

Wpisy dziennika kontrolnego, które można wyświetlić w usłudze Stackdriver Logging za pomocą przeglądarki logów, interfejsu Stackdriver Logging API lub pakietu Cloud SDK, obejmują następujące obiekty:

  • Wpis sam dziennik, który jest obiektem typu LogEntry . Przydatne pola to:

    • logName zawiera typ identyfikacyjny projektu i dziennika audytu
    • resource zawiera cel kontrolowanej pracy
    • timeStamp zawiera czas badanej operacji
    • protoPayload zawiera zbadane informacje
  • Dane logowania audytu, który jest AuditLog obiektu odbyło się w protoPayload polu wpisu.

  • Opcjonalne informacje specyficzne usługi audytu, który jest przedmiotem danej usługi odbywa się w serviceData dziedzinie AuditLog obiektu. Aby uzyskać szczegółowe informacje, przejdź do specyficznego dla usługi danych kontrolnych .

Dla pozostałych pól w tych obiektach, plus, jak je interpretować, przeglądarki Zrozumienie dzienników kontroli .

Nazwa dziennika

Nazwy zasobów dzienników kontrolnych Cloud wskazują projekt lub inną jednostkę, która jest właścicielem dzienników kontrolnych, oraz czy dziennik zawiera dane z dzienników kontrolnych dotyczących aktywności administratora, dostępu do danych lub zdarzeń systemowych. Poniżej przedstawiono na przykład nazwy dzienników kontrolnych aktywności administratora projektu i dzienników kontrolnych dostępu do danych organizacji:

projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity
organizations/[ORGANIZATION_ID]/logs/cloudaudit.googleapis.com%2Fdata_access

Nazwa serwisu

Firebase Powiadomienia konsole dzienniki audytu użyć nazwy usługi gcmcontextualcampaign-pa.googleapis.com .

Aby uzyskać więcej informacji dotyczących usług Rejestrowanie, przejdź do usługi mapowania zasobów .

Rodzaje zasobów

Firebase Powiadomienia konsole dzienniki audytu użyciu typu zasobu audited_resource dla wszystkich dzienników kontroli.

Aby uzyskać pełną listę, przejdź do typów zasobów monitorowanych .

Włącz rejestrowanie audytu

Dzienniki kontrolne dostępu do danych są domyślnie wyłączone i nie są zapisywane, chyba że zostaną wyraźnie włączone (wyjątkiem są dzienniki kontrolne dostępu do danych dla BigQuery, których nie można wyłączyć).

Aby uzyskać instrukcje dotyczące włączania niektórych lub wszystkich dzienników kontroli danych dostępowych, przejdź do Konfiguracja dzienników dostępu do danych .

Włączone dzienniki kontrolne dostępu do danych mogą wpływać na ceny logów w usłudze Stackdriver. Przeglądu Ceny sekcji na tej stronie.

Konsola powiadomień Firebase nie zapisuje dzienników kontrolnych aktywności administratora.

Uprawnienia do dziennika kontroli

Uprawnienia i role Cloud Identity and Access Management określają, które dzienniki kontrolne możesz wyświetlać lub eksportować. Dzienniki znajdują się w projektach i niektórych innych jednostkach, w tym organizacjach, folderach i kontach rozliczeniowych. Aby uzyskać więcej informacji, przejdź do Zrozumienie ról .

Aby wyświetlić dzienniki kontrolne dostępu do danych, musisz mieć jedną z następujących ról w projekcie zawierającym dzienniki kontrolne:

Jeśli używasz dzienników inspekcji od podmiotu spoza projektu, takich jak organizacja, a następnie zmienić role projekt do odpowiednich ról organizacyjnych.

Zobacz rejestry

Masz kilka opcji przeglądania wpisów dziennika kontrolnego:

Przeglądarka podstawowa

Aby pobrać wpisy dziennika kontrolnego, możesz użyć podstawowego interfejsu przeglądarki logów w konsoli GCP. Wykonaj następujące czynności:

  1. Przejdź do rejestrowania Stackdriver> Logs (Dzienniki Viewer) w konsoli GCP:

    Przejdź do strony przeglądarki logów

  2. Wybierz istniejący projekt Google Cloud u góry strony lub utwórz nowy projekt.

  3. W pierwszym menu rozwijanym wybierz typ zasobu, którego dzienniki kontrolne chcesz wyświetlić. Można wybrać konkretny zasób lub Global dla wszystkich zasobów.

  4. W drugim menu rozwijanego wybierz typ dziennika, który chcesz wyświetlić: activity na aktywność Admin dzienników kontroli, data_access dla dzienników kontroli danych Access, a system_events dla zdarzeń systemowych dzienników kontroli.

    Jeśli żadna z tych opcji nie jest wyświetlana, oznacza to, że w projekcie nie ma dostępnych dzienników audytu tego typu.

Zaawansowana przeglądarka

Aby pobrać wpisy dziennika kontrolnego, możesz użyć zaawansowanego interfejsu przeglądarki logów w konsoli GCP. Wykonaj następujące czynności:

  1. Przejdź do rejestrowania Stackdriver> Logs (Dzienniki Viewer) w konsoli GCP:

    Przejdź do strony przeglądarki logów

  2. Wybierz istniejący projekt Google Cloud u góry strony lub utwórz nowy projekt.

  3. W pierwszym menu rozwijanym wybierz typ zasobu, którego dzienniki kontrolne chcesz wyświetlić. Można wybrać konkretny zasób lub Global dla wszystkich zasobów.

  4. Kliknij strzałkę w dół (▾) po prawej stronie pola wyszukiwania filtra i wybierz Convert to zaawansowany filtr.

  5. Utwórz filtr, który dodatkowo określi wpisy dziennika, które chcesz wyświetlić. Aby pobrać wszystkie dzienniki kontrolne w swoim projekcie, dodaj następujący filtr. Dostarczyć poprawny [PROJECT_ID] w każdym z nazwami dzienników.

      logName = ("projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity" OR
          OR "projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events"
          OR "projects/[PROJECT_ID]logs/cloudaudit.googleapis.com%2Fdata_access")
    

    Aby uzyskać więcej informacji o filtrach, przejdź do Zaawansowane rejestruje filtry .

API

Aby wyświetlić wpisy w dzienniku kontrolnym za pomocą interfejsu API Stackdriver Logging:

  1. Przejdź do sekcji Spróbuj tego API w dokumentacji dla entries.list metody.

  2. Umieść następujący do części Prośba ciała spróbować tego API formularza. Kliknięcie tego oznakowane postaci automatycznie wypełnia ciało żądanie, ale trzeba będzie dostarczyć poprawny [PROJECT_ID] w każdym z nazwami dzienników.

      {
        "resourceNames": [
          "projects/[PROJECT_ID]"
        ],
        "pageSize": 5,
        "filter": "logName=(projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)"
      }
    
  3. Kliknij Execute.

Więcej informacji na temat zapytań, przejdź do Zaawansowane rejestruje zapytania .

SDK

Aby odczytać wpisy dziennika za pomocą pakietu Cloud SDK, uruchom następujące polecenie. Dostarczyć poprawny [PROJECT_ID] w każdym z nazwami dzienników.

gcloud logging read "logName=(projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)"

Przejdź do wpisów dziennika Reading uzyskać więcej informacji na temat korzystania z cloud SDK.

Dla przykładowego wpisu audyt i jak znaleźć najważniejsze informacje w nim, przejdź do Zrozumienia dzienników kontroli .

Eksportuj dzienniki kontrolne

Dzienniki kontrolne możesz eksportować w taki sam sposób, jak inne rodzaje dzienników. Szczegółowe informacje na temat sposobu eksportowania dzienników, przejdź do dzienników eksportujący . Oto kilka zastosowań eksportowania dzienników kontrolnych:

  • Aby przechowywać dzienniki kontrolne przez dłuższy czas lub korzystać z bardziej zaawansowanych funkcji wyszukiwania, możesz wyeksportować kopie dzienników kontrolnych do Google Cloud Storage, BigQuery lub Google Cloud Pub/Sub. Korzystając z Cloud Pub/Sub, możesz eksportować do innych aplikacji, innych repozytoriów i innych firm.

  • Aby zarządzać dzienniki kontroli w ramach całej organizacji, można utworzyć zagregowane umywalki eksportowych , które mogą eksportować logi z jakichkolwiek lub wszystkich projektów w organizacji.

  • Jeśli włączone dzienniki kontrolne dostępu do danych wypychają projekty nad ich przydziały, możesz wyeksportować dzienniki kontrolne dostępu do danych i wykluczyć je z rejestrowania. Aby uzyskać szczegółowe informacje, przejdź do Wyłączając dzienników .

cennik

Usługa Stackdriver Logging pobiera opłaty za dzienniki kontrolne dostępu do danych, o które wyraźnie prosisz. Konsola powiadomień Firebase nie zapisuje dzienników kontrolnych aktywności administratora ani dzienników kontrolnych zdarzeń systemowych.

Aby uzyskać więcej informacji na temat dzienników kontroli cen, test Stackdriver cen .