Raport sprzedaży z API Allegro i sklepu w Looker Studio - jak go zbudować

Łukasz Palej

Technical Implementation Expert

30.01.2026

Raport sprzedaży z API Allegro i sklepu w Looker Studio - jak go zbudować

Wsparcie programistyczne dla e-commerce

Łukasz PalejTechnical Implementation Expert

Programiści

Raport sprzedaży z API Allegro i sklepu w Looker Studio buduje się w trzech warstwach: skrypt pobiera zamówienia z REST API Allegro i z API sklepu, zapisuje je w jednym miejscu pośrednim (arkuszu Google albo hurtowni BigQuery), a Looker Studio łączy się z tym miejscem i pokazuje wykresy. Looker Studio nie powinien czytać API marketplace bezpośrednio - stabilny raport wymaga własnej, uporządkowanej tabeli zamówień, którą skrypt regularnie aktualizuje.

W tym wpisie pokazujemy, jakie dane warto pobierać, jak działa pobieranie zamówień z API Allegro, kiedy wystarczy arkusz, a kiedy potrzebna jest hurtownia danych, jak zaprojektować tabelę i jakie błędy najczęściej psują liczby w dashboardzie. Tekst jest dla właścicieli sklepów, którzy mają dość ręcznego sklejania eksportów z kilku paneli, i dla programistów, którzy mają taki raport zbudować.

[#wazne] W skrócie: raport sprzedaży w Looker Studio z danych Allegro i sklepu wymaga warstwy pośredniej. Skrypt pobiera zamówienia przez API Allegro (zasób zamówień i dziennik zdarzeń) oraz API sklepu, ujednolica pola i zapisuje je w arkuszu Google lub BigQuery. Looker Studio czyta już gotową tabelę i odświeża wykresy. Programiści Vinson projektują i wdrażają takie raporty dla sprzedawców wielokanałowych.

Czym jest raport sprzedaży w Looker Studio i po co go budować

Looker Studio to bezpłatne narzędzie Google do tworzenia interaktywnych raportów i dashboardów z różnych źródeł danych. Raport sprzedaży w Looker Studio to zestaw wykresów i tabel, które pokazują w jednym miejscu przychód, liczbę zamówień, średnią wartość koszyka i sprzedaż produktów - osobno dla Allegro, sklepu i innych kanałów oraz łącznie.

Panel Allegro i panel sklepu mają własne statystyki, ale każdy liczy po swojemu i pokazuje tylko swój kanał. Sprzedawca, który chce wiedzieć, ile zarobił w tym tygodniu łącznie, które produkty rosną na Allegro, a spadają w sklepie, albo jak zmienił się udział kanałów rok do roku, zwykle eksportuje pliki i skleja je w arkuszu. Własny raport robi to automatycznie i zawsze według tych samych definicji.

Jedna definicja przychodu - np. wartość zamówień brutto bez anulowanych, liczona tak samo dla każdego kanału,
Porównanie kanałów - Allegro, sklep, inne marketplace na jednym wykresie,
Sprzedaż na poziomie SKU - które produkty sprzedają się gdzie, z jaką ceną i w jakiej ilości,
Historia - dane przechowywane dłużej niż w panelach i możliwe do porównania rok do roku,
Udostępnianie - zespół, księgowość czy inwestor widzą raport bez dostępu do kont sprzedażowych.

Taki raport składa się z kilku elementów, z których każdy ma inną rolę. Najczęściej wygląda to tak:

[#chart:wpr44a]

Jak pobrać zamówienia z API Allegro do raportu sprzedaży

Allegro udostępnia REST API, w którym zamówienia (formularze zakupowe) pobiera się zasobem GET /order/checkout-forms. Według poradnika Allegro dla deweloperów parametr limit przyjmuje wartości od 1 do 100, suma offset i limit nie może przekroczyć 10 000, a lista obejmuje zamówienia z ostatnich 12 miesięcy. Zasób pozwala filtrować m.in. po statusie, dacie zakupu (lineItems.boughtAt.gte i lineItems.boughtAt.lte) oraz dacie ostatniej zmiany (updatedAt.gte i updatedAt.lte). Stan na styczeń 2026 - sprawdź aktualną dokumentację Allegro.

Do bieżącej aktualizacji raportu lepiej nadaje się dziennik zdarzeń GET /order/events. Zwraca on zdarzenia, takie jak zakup, uzupełnienie formularza czy gotowość do realizacji, a parametr from pozwala pobrać kolejne zdarzenia od ostatnio przetworzonego identyfikatora. Dokumentacja podaje, że dziennik obejmuje zdarzenia z ostatnich 60 dni, a zdarzenia mogą przychodzić nie po kolei i powtarzać się (stan na styczeń 2026 - sprawdź aktualną dokumentację Allegro). Dlatego skrypt po zdarzeniu powinien pobrać aktualną wersję zamówienia i zapisać ją, nadpisując poprzednią.

Zasób API Allegro	Do czego w raporcie	Na co uważać
GET /order/checkout-forms	Pierwsze załadowanie historii i okresowe porównanie	Limit 100 na stronę, offset + limit do 10 000, ostatnie 12 miesięcy
GET /order/events	Bieżące aktualizacje nowych i zmienionych zamówień	Zdarzenia z 60 dni, możliwe duplikaty i zła kolejność
GET /order/checkout-forms/{id}	Pobranie aktualnej wersji jednego zamówienia	Zapis przez nadpisanie, nie dopisanie

Wszystkie zapytania wymagają tokenu dostępu OAuth wydanego dla konta sprzedawcy, a aplikacja musi być zarejestrowana w portalu Allegro dla deweloperów. Dokumentacja opisuje główny limit 9000 zapytań na minutę na Client ID; po jego przekroczeniu API odpowiada kodem 429 i blokuje Client ID na minutę (stan na styczeń 2026 - sprawdź aktualną dokumentację Allegro). Przy raportach dziennych ten limit rzadko jest problemem, ale skrypt i tak powinien obsłużyć błąd 429 i odczekać przed ponowieniem.

[#tip] Zapisuj w tabeli identyfikator ostatnio przetworzonego zdarzenia z dziennika Allegro. Jeśli skrypt przerwie pracę, przy następnym uruchomieniu zacznie od tego miejsca, zamiast pobierać wszystko od nowa albo pomijać zamówienia.

Bezpłatna konsultacja programistyczna

Potrzebujesz programisty do sklepu, integracji lub automatyzacji?

Wycena zadania w 24 h w dni robocze
Integracje, API, feedy i poprawki w sklepie
Rozliczenie godzinowe albo za projekt

Konsultację poprowadzi Łukasz Palej, Technical Implementation Expert

Zobacz szczegóły usługi →

Dane ze sklepu internetowego - jak je dołączyć do raportu

Sklepy na popularnych platformach mają własne API z listą zamówień, zwykle z filtrem po dacie zmiany i stronicowaniem. Zasada jest ta sama jak przy Allegro: skrypt pobiera zamówienia zmienione od ostatniego uruchomienia i nadpisuje je w tabeli pośredniej. Jak wygląda komunikacja przez API, tokeny i stronicowanie w praktyce, opisujemy na przykładzie integracji WooCommerce z Allegro - wtyczka czy własne rozwiązanie.

Najważniejsze jest ujednolicenie danych. Allegro i sklep inaczej nazywają statusy, inaczej zapisują koszt dostawy i inaczej identyfikują produkty. Zanim dane trafią do wspólnej tabeli, skrypt powinien przypisać każdemu zamówieniu kanał, zamienić statusy na wspólny słownik (np. nowe, opłacone, wysłane, anulowane), zapisać kwoty jako liczby w jednej walucie i dopasować pozycje do SKU z katalogu sklepu. Bez tego wykres porównujący kanały będzie porównywał różne rzeczy.

Arkusz Google czy BigQuery jako źródło dla Looker Studio

Looker Studio ma wbudowane połączenia m.in. z Arkuszami Google i z BigQuery. Według dokumentacji Google dane z Arkuszy można odświeżać co 15 minut, co godzinę, co 4 lub co 12 godzin (domyślnie co 15 minut), a dane z BigQuery w zakresie od 1 do 50 minut lub od 1 do 12 godzin (domyślnie co 12 godzin). Stan na styczeń 2026 - sprawdź aktualną dokumentację Looker Studio. Wybór warstwy pośredniej zależy przede wszystkim od liczby zamówień i tego, jak długą historię chcesz trzymać:

[#chart:wpr44c]

Arkusz Google jest szybki do uruchomienia i zrozumiały dla każdego w firmie. Ma jednak ograniczoną liczbę komórek, wolniej działa przy dużych tabelach i łatwo go przypadkiem zepsuć ręczną edycją. BigQuery to hurtownia danych Google Cloud, rozliczana za przechowywanie i przetwarzanie zapytań, która dobrze znosi miliony wierszy i pozwala liczyć widoki w SQL. Dla sklepu z kilkuset zamówieniami miesięcznie arkusz zwykle wystarczy na start, a przejście na BigQuery można zaplanować, gdy raport zacznie zwalniać.

Jak zbudować raport sprzedaży w Looker Studio krok po kroku

Kolejność prac, którą stosujemy przy takich wdrożeniach, wygląda tak:

[#chart:wpr44b]

Struktura tabeli zamówień jest ważniejsza niż wygląd wykresów. Dobrze sprawdza się jedna tabela na poziomie pozycji zamówienia, w której każdy wiersz to jeden produkt w jednym zamówieniu:

kanał - allegro, sklep, inny marketplace,
order_id i line_id - identyfikator zamówienia w kanale i pozycji, razem jako klucz unikalny,
data zakupu i data ostatniej zmiany - zapisane w jednej strefie czasowej,
status wspólny - po zamianie na firmowy słownik statusów,
sku, nazwa, ilość, cena jednostkowa - jako liczby, nie tekst,
koszt dostawy i waluta - dostawa przypisana do zamówienia, nie do każdej pozycji.

Przykład zapytania w BigQuery, które przygotowuje dzienne podsumowanie dla Looker Studio (nazwy tabel umowne): SELECT DATE(bought_at) AS dzien, kanal, SUM(ilosc * cena) AS przychod, COUNT(DISTINCT order_id) AS zamowienia FROM sprzedaz.pozycje WHERE status != 'anulowane' GROUP BY dzien, kanal. Taki widok jest szybszy i tańszy w odczycie niż liczenie wszystkiego w samym raporcie.

[#checklista] Przed oddaniem raportu: liczba zamówień z wybranego dnia zgadza się z panelem Allegro i panelem sklepu; anulowane zamówienia są wykluczone lub oznaczone; kwoty są liczbami w jednej walucie; daty są w jednej strefie czasowej; skrypt zapisuje znacznik ostatniej synchronizacji widoczny w raporcie; dostęp do raportu ma tylko lista osób uzgodniona z właścicielem.

Jakie wskaźniki pokazać w raporcie sprzedaży z Allegro i sklepu

Dobry dashboard zaczyna się od kilku liczb, na które zarząd patrzy codziennie: przychodu, liczby zamówień i średniej wartości zamówienia, każdej z podziałem na kanały i z porównaniem do poprzedniego okresu. Druga strona raportu może pokazywać sprzedaż według SKU i kategorii, a trzecia - udział anulacji i zwrotów w każdym kanale. W Looker Studio warto dodać filtr dat i kanału, który działa na wszystkie wykresy naraz, oraz widoczną datę ostatniej synchronizacji danych. Więcej wykresów nie zawsze znaczy lepiej: raport, który mieści się na jednym ekranie i odpowiada na trzy najważniejsze pytania, będzie używany częściej niż rozbudowany zestaw zakładek, do którego nikt nie zagląda. Wskaźniki marżowe dodawaj dopiero wtedy, gdy masz wiarygodne koszty zakupu z ERP.

Najczęstsze błędy w raportach sprzedaży z API

Większość rozbieżności między raportem a panelem sprzedawcy ma kilka powtarzalnych przyczyn:

Dopisywanie zamiast nadpisywania - każde zdarzenie dodaje nowy wiersz i zamówienie liczy się kilka razy.
Anulowane zamówienia w przychodzie - raport nie aktualizuje statusów po zakupie.
Strefy czasowe - zamówienia z okolic północy trafiają do innego dnia niż w panelu.
Kwoty jako tekst - przecinek dziesiętny lub symbol waluty blokuje sumowanie.
Brak obsługi błędów API - wygasły token lub błąd 429 przerywa skrypt, a raport po cichu przestaje się aktualizować.

Ostatni punkt jest szczególnie podstępny, bo wykresy wyglądają poprawnie, tylko kończą się kilka dni wcześniej. Dlatego skrypt powinien wysyłać alert, gdy synchronizacja się nie powiedzie, a raport pokazywać datę ostatniej aktualizacji. Gdy danych z wielu kanałów przybywa, a raport ma zasilać też inne procesy, warto rozważyć wspólną warstwę integracyjną - kiedy się to opłaca, wyjaśniamy we wpisie o własnym middleware między sklepem, ERP i marketplace.

Ile kosztuje i gdzie uruchomić skrypt do raportu sprzedaży

Sam Looker Studio w wersji podstawowej jest bezpłatny. Koszty to przede wszystkim praca programisty przy budowie i utrzymaniu skryptu, miejsce, w którym skrypt działa (np. Google Apps Script przy arkuszu, funkcja w chmurze albo serwer firmy), oraz ewentualne opłaty za BigQuery zgodne z cennikiem Google Cloud. Przy arkuszu i małej skali koszt infrastruktury jest zwykle pomijalny, przy hurtowni zależy od ilości danych i zapytań - sprawdź aktualny cennik Google Cloud.

Skrypt pobierający dane z API Allegro trzeba też utrzymywać. Allegro publikuje zmiany i wycofania zasobów w aktualnościach dla deweloperów, tokeny wymagają odświeżania, a sklep może zmienić wersję API po aktualizacji. Warto mieć osobę odpowiedzialną za integrację i prostą dokumentację: skąd pochodzą dane, jak liczony jest przychód i co zrobić, gdy synchronizacja się zatrzyma.

Jak Vinson pomaga zbudować raport sprzedaży z API Allegro i sklepu

Zapewniamy wsparcie programistyczne dla sklepów i sprzedawców: integracje, automatyzacje, poprawki i rozwój sklepów oraz narzędzi. Przy raportach sprzedaży zaczynamy od ustalenia definicji (co jest przychodem, które statusy liczymy), potem piszemy skrypty pobierające dane z API Allegro i sklepu, projektujemy tabelę w arkuszu lub BigQuery i budujemy dashboard w Looker Studio z alertem o przerwanej synchronizacji. Jako agencja e-commerce z Allegro Ads Partner+ i Google Partner łączymy raport z danymi z kampanii. Szczegóły znajdziesz na stronie Wsparcie programistyczne dla e-commerce.

Najczęściej zadawane pytania

Czy Looker Studio ma gotowy konektor do Allegro?

Google nie udostępnia wbudowanego konektora Allegro w Looker Studio; istnieją konektory partnerskie firm zewnętrznych, których zakres i cenę trzeba sprawdzić u dostawcy. Najbardziej przewidywalne rozwiązanie to własny skrypt, który pobiera zamówienia z API Allegro do arkusza lub BigQuery. Wtedy masz pełną kontrolę nad definicjami i historią danych.

Jak często może się odświeżać raport sprzedaży w Looker Studio?

Zależy to od dwóch rzeczy: jak często skrypt pobiera dane z API i jak ustawiona jest świeżość danych w Looker Studio. Dla Arkuszy Google dokumentacja podaje odświeżanie od 15 minut do 12 godzin, dla BigQuery od 1 minuty do 12 godzin. Dla większości sprzedawców wystarcza aktualizacja co godzinę lub kilka razy dziennie.

Czy do raportu z API Allegro potrzebny jest programista?

Tak, jeśli raport ma działać automatycznie. Trzeba zarejestrować aplikację w Allegro, obsłużyć autoryzację OAuth, stronicowanie, limity zapytań i błędy oraz zaprojektować tabelę danych. Marketer może potem samodzielnie rozbudowywać wykresy w Looker Studio na gotowych danych.

Arkusz Google czy BigQuery - co wybrać na start?

Arkusz wystarczy przy kilkuset zamówieniach miesięcznie i krótkiej historii, bo jest prosty i nie generuje kosztów chmury. BigQuery warto wybrać, gdy zamówień są tysiące, raport ma obejmować kilka lat albo dane mają zasilać też inne analizy. Przejście z arkusza do BigQuery jest możliwe później, jeśli tabela ma dobrą strukturę.

Dlaczego raport pokazuje inną sprzedaż niż panel Allegro?

Najczęściej dlatego, że raport liczy anulowane zamówienia, dubluje zamówienia przy aktualizacjach albo używa innej strefy czasowej niż panel. Różnica może też wynikać z innej definicji przychodu, np. z dostawą lub bez. Warto porównać listę numerów zamówień z jednego dnia w obu miejscach.

Dobrze zaprojektowany raport sprzedaży z API Allegro i sklepu oszczędza godziny ręcznych eksportów i daje jedną wersję liczb dla całej firmy. Jeśli chcesz zbudować taki dashboard w Looker Studio, sprawdź wsparcie programistyczne Vinson.