Development Newsletters

Release: 12-10-2016

Lista wprowadzanych zmian:

  • Nowe szablony kreacji dla mobile - Mobile pull, Shake banner
  • Poprawki w szablonach kreacji Adtiles, Slider, Carousel i Cube 3D
  • Zmiany w API AO

Nowe szablony kreacji dla mobile

Mobile pull

Mobile Pull to kreacja składająca się z dwóch komponentów. Reklama rozpoczyna się od kreacji umieszczonej na górze lub na dole strony, a po pionowym przeciągnięciu rozwija się na pełny ekran.
W szablonie można wykorzystać pliki HTML5 lub obrazki.

Shake banner

W kreacji Shake banner, treść reklamy jest początkowo ukryta i zostaje wyświetlona po potrząśnięciu urządzeniem.
Szablonu obsługuje pliki graficzne.

Poprawki w szablonach kreacji Adtiles, Slider, Carousel i Cube 3D

Wprowadzamy następujące zmiany w poszczególnych szablonach:

  • w Cube3D - możliwość wyświetlenia formatu na warstwie
  • w AdTiles, Slider, Carosuel, Cube 3D - możliwość edycji strzałki i dodania własnej (uwaga: strzałka musi być symetryczna i zwrócona w prawo)
  • w AdTiles:
    • możliwość rozwinięcia w jednym z czterech kierunków
    • ustawienia z-index

Zmiany w API AO

Wprowadzane zmiany nie są kompatybilne wstecz.

W związku z wprowadzeniem nowej wersji modułu obliczeniowego statystyk kampanii, w API AO zostaną wprowadzone następujące zmiany:

  • Dla operacji GetBasicStatsLite:
    • Parametr sortField zostanie zastąpiony przez parametr sortStatName
    • Dla timeUnitName!=General, pole timeUnit zostanie na wyjściu zastąpione przez period
    • Jeśli dla danego wskaźnika nie ma dostępnych żadnych danych, zamiast wartości "NULL" zostanie zwrócona wartość “0”
    • Zmianie ulegnie format daty w polu period i w szczegółach kampanii dla opcji humanDates i showDetails. Przykłady:
      • "2016-09" zamiast "201609" dla timeUnitName=Month
      • "2016-09-19,2016-09-26" zamiast "20160919" dla timeUnitName=Week
      • "2016-09-20" zamiast "20160920" dla timeUnitName=Day
      • "2016-09-20 15:00 zamiast "2016092015" dla timeUnitName=Hour
    • Jeśli operacja zostanie użyta dla kampanii, w której dataTo, dataFrom, updateDate nie zostały zdefiniowane, zamiast komunikatu NoStatsAvailable zostanie zwrócone "-".
    • Parametr sortOrder jako wartość domyślną będzie przyjmował desc zamiast asc. Jeśli sortOrder zostanie użyte bez zdefiniowanej wartości sortStatName, nie będzie zwracany błąd - operacja zostanie wykonana z pominięciem tego parametru.
    • Dodane zostaną następujące parametry: domainName, limit, showDetails, humanDates, showNames
    • Dla parametru statNames zmieniony zostanie typ z AdOceanListType(AdOceanAlNumType(1, 100, ".")) na AdOceanAlNumListType(".")
    • Dla parametrów sortStatName oraz SortField zmieniony zostanie typ z AdOceanListType(AdOceanAlNumType(1, 100, ".")) na AdOceanAlNumType(1, 100, ".")
    • Zmiany w komunikatach błędów:
      • "No campaignid" zamiast "No No campaignid"
      • "No statnames" zamiast "No No statnames"
      • "statnames has a non-alphanumeric character." zamiast "In statnames: element has a non-alnum character."
      • "You can't give X, since timeunit, lowertimeunit and/or uppertimeunit can't be given for General timeunitname." zamiast "You can't give X, since lowertimeunit and/or uppertimeunit can't be given for General timeunitname.", gdzie X oznacza timeunit, lowertimeunit lub uppertimeunit.
      • "Bad sortStatName." zamiast "Wrong sortField."
    • Jeśli zostanie użyty parametr upperlimit lub lowerlimit, zostanie sprawdzone czy drugi z parametrów również został użyty.
    • Jeśli wartości parametrów upperlimit i lowerlimit będą puste, zamiast komunikatu błędu zostanie zwrócona pusta lista statystyk.
    • W zależności od przekazanych parametrów, zwrócone zostaną nowe parametry:
      • campaignFrom, campaignTo, dataFrom, dataTo, updateTS, campaignState, campaignModel – dla showDetails = Y
      • campaignTime – dla timeUnitName = General
      • orderID – dla orderID lub Order w domainName
      • creativeID – dla creativeID lub Creative w domainName
      • placementID – dla placementID lub Placement w domainName
      • orderName – dla orderID z showNames = Y lub showDetails = Y
      • creativeName – dla creativeID z showNames = Y lub showDetails = Y
      • placementName – dla placementID z showNames = Y lub showDetails = Y
      • placementCategoryID, placementCategoryName, publisherID, publisherName – dla placementID z showDetails = Y
      • creativeCategoryID, creativeCategoryName – dla creativeID z showDetails = Y
      • campaignID
      • campignName
      • campaignType
      • advertiserID
      • advertiserName
      • periodName
    • dla operacji GetVideoStats
      • Parametr sortField zostanie zastąpiony przez sortStatName
      • Dla timeUnitName!=General, pole timeUnit zostanie na wyjściu zastąpione przez period
      • Jeśli operacja zostanie użyta dla kampanii, w której dataTo, dataFrom, updateDate nie zostały zdefiniowane, zamiast komunikatu NoStatsAvailable zostanie zwrócone "-".
      • Parametr sortOrder jako wartość domyślną będzie przyjmował desc zamiast asc. Jeśli sortOrder zostanie użyte bez zdefiniowanej wartości sortStatName, nie będzie zwracany błąd - operacja zostanie wykonana z pominięciem tego parametru.
      • Dodane zostaną następujące parametry: domainName, limit, showDetails, humanDates, showNames
      • Dla parametru statNames zmieniony zostanie typ z AdOceanListType(AdOceanAlNumType(1, 100, ".")) na AdOceanAlNumListType(".")
      • Dla parametrów sortStatName oraz SortField zmieniony zostanie typ z AdOceanListType(AdOceanAlNumType(1, 100, ".")) na AdOceanAlNumType(1, 100, ".")
      • Zmiany w komunikatach błędów:
        • "No campaignid" zamiast "No No campaignid"
        • "No statnames" zamiast "No No statnames"
        • "statnames has a non-alphanumeric character." zamiast "In statnames: element has a non-alnum character."
        • "You can't give X, since timeunit, lowertimeunit and/or uppertimeunit can't be given for General timeunitname." zamiast "You can't give X, since lowertimeunit and/or uppertimeunit can't be given for General timeunitname.", gdzie X oznacza timeunit, lowertimeunit lub uppertimeunit.
        • "Bad sortStatName." zamiast "Wrong sortField."
      • Jeśli zostanie użyty parametr upperlimit lub lowerlimit, zostanie sprawdzone czy drugi z parametrów również został użyty.
      • Jeśli wartości parametrów upperlimit i lowerlimit będą puste, zamiast komunikatu błędu zostanie zwrócona pusta lista statystyk.
      • W zależności od przekazanych parametrów, zwrócone zostaną nowe parametry:
        • campaignFrom, campaignTo, dataFrom, dataTo, updateTS, campaignState, campaignModel – dla showDetails = Y
        • campaignTime – dla timeUnitName = General
        • orderID – dla orderID lub Order w domainName
        • creativeID – dla creativeID lub Creative w domainName
        • placementID – dla placementID lub Placement w domainName
        • orderName – dla orderID z showNames = Y lub showDetails = Y
        • creativeName – dla creativeID z showNames = Y lub showDetails = Y
        • placementName – dla placementID z showNames = Y lub showDetails = Y
        • placementCategoryID, placementCategoryName, publisherID, publisherName – dla placementID z showDetails = Y
        • creativeCategoryID, creativeCategoryName – dla creativeID z showDetails = Y
        • campaignID
        • campignName
        • campaignType
        • advertiserID
        • advertiserName
        • periodName
      • dla operacji GetTechStats oraz GetFreqStats :
        • W przypadku braku parametru sortStatName zastosowana zostanie inna kolejność sortowania: zamiast sortowania po plansID rekordy sortowane będą wg orderID, creativeID, placementID
        • Liczby zostaną zaokrąglone do 6 miejsca po przecinku, zamiast dotychczasowego 4
        • Dodane zostaną nowe parametry:
          • placementCategoryID
          • creativeFormID
          • creativeTypeID
          • filteredReportID
          • CreativeCategoryID
        • Parametr CreativeCategoryName będzie mógł przyjmować formę: form_name|type_name lub form_name lub type_name lub "-"
        • Jeśli podana zostanie nieprawidłowa nazwa statystyki, zamiast komunikatu błędu NoStatsAvailable zwrócony zostanie komunikat BadParam z informacją "WrongStatNames".
        • Dodane zostaną nowe parametry w wyniku operacji: recordsNumber, dataFrom, dataTo, updateDate, requiresReset,TimeZoneAbbre
        • Jeśli użyty zostanie tylko jeden z parametrów lowerlimit i upperlimit, zwrócony zostanie komunikat błędu zawierający must set zamiast should set
      • Dla operacji GetTechStats oraz GetTechStatNames, dostępna będzie nowa wartość parametru statDomainName parameter: "deviceType"
      • Operacja GetFreqStatNames będzie zwracała nazwy statystyk, bez potrzeby definiowania parametrów

      Ponadto, w kolejnych tygodniach zostaną wprowadzone dalsze zmiany:

      W dniu 19.09:

      Operacja GetBasicStats będzie działać w taki sam sposób jak operacja GetBasicStatsLite. W tym celu dla operacji GetBasicStats:

      • Dodany zostanie nowy parametr closedTimeUnitInterval
      • Jeśli wartość parametru timeUnit będzie wykraczać poza czas trwania kampanii, zostanie zwrócony błąd BadTimeRange
      • Jeśli nie zostaną podane parametry lowertimeunit i uppertimeunit, zwrócona lista statystyk będzie pusta
      • Jeśli użyte zostanie TimeUnitName=Week, statystyki dla tygodnia zostaną zwrócone po podaniu któregokolwiek z dni należących do tego tygodnia
      • Jeśli jako wartość parametru sortStatName podane zostanie 'timeUnit', będzie możliwe posortowanie wyników po jednostce czasu
      • Jeśli timeUnit, lowerTimeUnit lub upperTimeUnit zostaną użyte z timeUnitName=General, zamiast komunikatu błędu BadParam zwrócny zostanie status NoConsistence

      W dniu 02.11:

      W związku z pokrywaniem się funkcjonalności operacji GetBasicStats i GetBasicStatsLite, operacja GetBasicStatsLite zostanie usunięta.

      adocean api mobile