Integracja Custom Stream z BigQuery

Skonfiguruj Custom Stream w WitCloud i wysyłaj własne dane, takie jak zdarzenia użytkowników, logi czy webhooki, do Google BigQuery za pomocą żądań HTTP.

Aktualizacja

Wprowadzenie

Integracja Custom Stream pozwala wysyłać dowolne własne dane do Google Cloud BigQuery przez dedykowany adres URL kolektora. Niezależnie od tego, czy zbierasz działania użytkowników, wysłane formularze, logi czy zdarzenia z zewnętrznych systemów, to Ty decydujesz, co wysyłasz; każde żądanie jest zapisywane jako nowy wiersz w Twoim datasecie BigQuery.

Instrukcja konfiguracji

Wykonaj poniższe kroki, aby utworzyć Custom Stream. Po jego utworzeniu otrzymasz adres URL kolektora, na który możesz wysyłać dane.

Konfiguracja modułu

Przejdź do Integracje w menu i kliknij Dodaj integrację.

Lista integracji z kilkoma przykładowymi integracjami i przyciskiem Dodaj integrację

Wybierz Custom Stream z listy dostępnych integracji.

Katalog integracji z wybraną integracją Custom Stream

Wpisz Nazwę źródła danych, np. „Custom Stream PL".

Pole Nazwa źródła danych wypełnione przykładową nazwą Custom Stream PL

Kliknij Pokaż ustawienia zaawansowane. Opcja IP klienta określa, co dzieje się z adresem IP nadawcy: Pełny zapisuje go w całości (ustawienie domyślne), Zamaskowany zapisuje jego zamaskowaną wersję, a Brak w ogóle go nie zapisuje.

Otwarte ustawienia zaawansowane z opcjami IP klienta Pełny, Zamaskowany i Brak

Opcja Zbierana lokalizacja pozwala wybrać, które dane geograficzne są zapisywane z każdym wierszem: Region, Kraj, Miasto oraz Szerokość i długość geograficzna. Domyślnie zaznaczone są wszystkie cztery; usuń te, których nie chcesz zbierać.

Pole Zbierana lokalizacja z wyborem danych geograficznych Region, Kraj, Miasto i Szerokość i długość geograficzna

Kliknij Utwórz.

Jak korzystać ze strumienia

Po utworzeniu strumienia otworzy się jego strona. W sekcji Instrukcja konfiguracji kliknij ikonę kopiowania obok Adres URL kolektora, aby skopiować adres Twojego strumienia. Do tej strony możesz wrócić w dowolnym momencie z listy Integracje.

Adres URL kolektora na stronie strumienia po jego utworzeniu (przykład)

Wysyłanie danych

Aby wysłać dane, wykonaj żądanie POST na adres URL kolektora z treścią w formacie JSON. Każde żądanie jest zapisywane jako nowy wiersz w tabeli strumienia w Twoim datasecie BigQuery. Dane możesz też wysłać jako parametry zapytania w żądaniu GET.

Cała treść żądania jest zapisywana jako tekst w kolumnie payload, więc możesz wysyłać dowolne pola. Jedyne pole o szczególnym znaczeniu to eventId: jeśli wyślesz je jako tekst, zostanie zapisane w kolumnie eventId; w przeciwnym razie dla wiersza zostanie wygenerowany unikalny identyfikator. Kolumna timestamp zawiera czas otrzymania żądania.

Adres URL jest unikalny dla Twojego strumienia. Przechowuj go bezpiecznie i nie udostępniaj publicznie.

Przykładowe żądanie

Oto przykładowe żądanie curl:

curl -X POST https://stream.cloud.witbee.com/custom/your-unique-id \
  -H "Content-Type: application/json" \
  -d '{
        "event": "form_submitted",
        "email": "john@example.com",
        "source": "landing_page"
      }'

Schemat danych

Rozwiń poniższą tabelę, aby zobaczyć pełny schemat danych zbieranych z Custom Stream.

Schemat danych tabeli custom_stream
Nazwa polaTrybTyp
eventIdNULLABLESTRING
payloadNULLABLESTRING
timestampNULLABLETIMESTAMP
ipNULLABLESTRING
geoNULLABLERECORD
├─ geo.cityNULLABLESTRING
├─ geo.regionNULLABLESTRING
├─ geo.countryNULLABLESTRING
├─ geo.cityLatitudeNULLABLESTRING
├─ geo.cityLongitudeNULLABLESTRING