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

Wybierz Custom Stream z listy dostępnych integracji.

Wpisz Nazwę źródła danych, np. „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.

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

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.

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 pola | Tryb | Typ |
|---|---|---|
| eventId | NULLABLE | STRING |
| payload | NULLABLE | STRING |
| timestamp | NULLABLE | TIMESTAMP |
| ip | NULLABLE | STRING |
| geo | NULLABLE | RECORD |
| ├─ geo.city | NULLABLE | STRING |
| ├─ geo.region | NULLABLE | STRING |
| ├─ geo.country | NULLABLE | STRING |
| ├─ geo.cityLatitude | NULLABLE | STRING |
| ├─ geo.cityLongitude | NULLABLE | STRING |
