Integracja Facebook Catalog z BigQuery



📢 Wprowadzenie

Ten moduł integruje się z Facebook Catalog API (Meta Graph API), umożliwiając zbieranie danych katalogu produktów i zapisywanie ich w Google Cloud BigQuery. Zyskaj głębszy wgląd w dane i optymalizuj wyniki swojego katalogu produktów dzięki regularnemu zbieraniu danych.


📝 Instrukcja Konfiguracji

Postępuj zgodnie z poniższą instrukcją, aby połączyć Facebook Catalog z BigQuery. Po zakończeniu konfiguracji dane będą automatycznie przesyłane do Twojego projektu BigQuery.

💡 Wskazówka: Upewnij się, że posiadasz dostęp administratora do Meta Business i katalogów produktów, które chcesz zbierać, przed rozpoczęciem konfiguracji.

🔧 Konfiguracja Modułu

Przejdź do zakładki Integracje w menu > Kliknij przycisk Dodaj integrację.





Wybierz Facebook Catalog z listy dostępnych integracji.





Wpisz nazwę kolektora, np. "Facebook Catalog Collect".





🔑 Autoryzacja

💡 Wskazówka: Jeśli masz już utworzony token Facebook Catalog i nadal posiada on właściwe uprawnienia, po prostu wybierz go z listy rozwijanej i pomiń ten krok.

Kliknij przycisk Authorize.





W oknie Facebooka:

  • Zaloguj się na Facebooku i wybierz konto, którego chcesz użyć.
  • Na ekranie „Review WitCloud's access request" potwierdź uprawnienia „Manage your product catalogues" oraz „Manage your business" (zakresy catalog_management, business_management).
  • Kliknij przycisk Save.





Z powrotem w WitCloud wybierz katalogi Facebook, które chcesz eksportować.




💡 Wskazówka: Możesz wybrać wiele katalogów jednocześnie — WitCloud utworzy osobny kolektor danych dla każdego z nich.


Opcjonalnie rozwiń sekcję Advanced, aby ustawić Data freshness (hours) — czyli jak często katalog ma być odświeżany (minimum 4, maksimum 12 godzin; wartość domyślna 4) — oraz aby zawęzić listę Tables to collect, jeśli nie potrzebujesz wszystkich tabel.


Kliknij Create, aby zakończyć konfigurację.




Gotowe! Dane z Facebook Catalog będą teraz synchronizowane z BigQuery, dostarczając Ci szczegółowych informacji na temat wyników Twojego katalogu produktów.


⏳ Synchronizacja Danych

Dane Facebook Catalog to migawka bieżącego stanu Twojego katalogu produktów, więc nie ma tu kroku z zakresem dat historycznych — każde uruchomienie nadpisuje partycję z danego dnia najnowszym stanem.


Harmonogram synchronizacji danych zostanie utworzony automatycznie i będzie działał z częstotliwością ustawioną w polu Data freshness (co 4–12 godzin, domyślnie 4). Więcej informacji na ten temat znajdziesz tutaj.


📊 Schemat Danych

Rozwiń tabele poniżej, aby zobaczyć pełny schemat danych zbieranych z Facebook Catalog.


🔎 Kliknij, aby zobaczyć schemat danych tabeli fb_catalog_products
🔎 Kliknij, aby zobaczyć schemat danych tabeli fb_catalog_product_sets