Development Newsletters
05-10-2022: Zmiany w API Adreal
5. października 2022 wprowadzone zostały zmiany w API badania gemiusAdReal.
Zmiany w parametrach
Parametry periods oraz platform nie będą dłużej używane. W zamian, należy korzystać z parametrów periods_range oraz platforms.
Przykłady
Było:
- https://adreal.gemius.com/api/pl/stats/?periods=week_20220103,week_20220110,week_20220117&platforms=pc&segments=brand_owner,website&metrics=ad_cont
- https://adreal.gemius.com/api/pl/stats/?platform=pc&periods_range=20220103,20220103,week&segments=brand_owner,website&metrics=ad_cont
Będzie:
- https://adreal.gemius.com/api/pl/stats/?periods_range=20220103,20220117,week&platforms=pc&segments=brand_owner,website&metrics=ad_cont
- https://adreal.gemius.com/api/pl/stats/?platforms=pc&periods_range=20220103,20220103,week&segments=brand_owner,website&metrics=ad_cont
Zmiany w prezentacji danych
Wartość procentowa uncertainty, dotychczas zwracana w jako wartość nieliczbowa, będzie teraz zwracana w postaci liczby ułamkowej. Dodatkowo, klucz uncertainty w wyniku będzie zawierał słownik wartości dla każdego wskaźnika osobno, zamiast dotychczasowej jednejwspólnej wartości dla wszystkich metryk.
Example
Was:
Will be:
Limit liczby rekordów
Maksymalna wartość parametru limit dla endpointu /stats/ jest ustawiona na 10000. Jest to maksymalna liczna rekordów, które mogą zostać zwrócone na jednej stronie z wynikami. Aby pobrać wszystkie wyniki zapytania, należy użyć wartości zwracanej w parametrze next, który jest łączem do następnej strony wyników i jest zwracany aż do ostatniej dostępnej strony.
Przykład