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

adreal api