Integracja Custom Stream z BigQuery

📢 Wprowadzenie

Moduł Custom Stream umożliwia przesyłanie dowolnych danych niestandardowych bezpośrednio do Google Cloud BigQuery za pomocą zapytania HTTP. Niezależnie od tego, czy rejestrujesz działania użytkowników, przesłania formularzy, logi czy dane z zewnętrznych usług (Webhooki) — ta elastyczna integracja daje Ci pełną kontrolę nad tym, jakie dane są zbierane i jak są strukturyzowane, umożliwiając analizę w czasie rzeczywistym dostosowaną do Twoich potrzeb.

📝 Przewodnik konfiguracyjny

Wykonaj poniższe kroki, aby połączyć Custom Stream z BigQuery. Po zakończeniu konfiguracji dane będą automatycznie przesyłane do Twojego projektu BigQuery.

🔧 Konfiguracja modułu

Przejdź do sekcji Collect w menu > Kliknij Create Data Collect.

Z listy dostępnych integracji wybierz Custom Stream.

Wprowadź Collect Name, np. „Custom Stream Collect”.

Za pomocą opcji Client IP możesz zdecydować, czy chcesz zbierać adresy IP dla streamowanych danych.

Za pomocą opcji Collect location możesz zdecydować, które dane geograficzne chcesz zbierać.

⏳ Jak korzystać ze streamu

Po zakończeniu konfiguracji otrzymasz Collector URL. Ten adres umożliwia przesyłanie niestandardowych danych bezpośrednio do BigQuery w czasie rzeczywistym.

📬 Wysyłanie danych

Aby wysłać dane, wykonaj zapytanie POST na swój Custom Stream URL z ładunkiem JSON. Każde zapytanie zostanie zapisane jako nowy wiersz w tabeli BigQuery.

🔐 Ważne: Adres URL jest unikalny dla Twojej integracji. Zachowaj go w bezpiecznym miejscu i nie udostępniaj publicznie.

✅ Przykładowe zapytanie

Poniżej przykład zapytania 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",
        "timestamp": "2025-05-07T10:15:00Z",
        "source": "landing_page"
      }'

📊 Schemat danych

Rozwiń poniższe tabele, aby zobaczyć pełny schemat danych zbieranych przez Custom Stream.