Development Newsletters

Release: 05-08-2020

Lista wprowadzanych zmian:

Zmiany w AddSpace/GetSpace

Przygotowaliśmy zmiany w narzędziu AddSpace/GetSpace. Nowy interfejs będzie dostępny pod adresem addspace.adocean.pl. Zalogować się można albo za pomocą loginu i hasła, albo za pomocą ID otwartej wcześniej w API sesji.

Get Placements

Aby pobrać listę placementów należy najpierw sprawdzić ID wydawcy w API, a następnie podać jego wartość w formularzu oraz wybrać kodowanie i separator.

Interfejs zwróci plik CSV z istniejącym drzewkiem placementów, na przykład:

Publisher name
,"gemius",FOLDER
,,"contact","None","fr:Mobile display"
,,"Homepage",MASTER
,,,"Billboard","Billboard 750x100","c:nowa","c:750x100","sr:750x100","fr:Billboard"

gdzie:

  • c: - kategoria
  • sr: - restrykcje w zakresie wymiarów kreacji
  • fr: - restrykcje w zakresie formatów kreacji


Add Placements

Aby dodać placementy należy przygotowac plik z drzewkiem placementów i dodać go w interfejsie. Plik może zostać przygotowany jako CSV lub TXT. Wszystkie nazwy i wartości muszą być opakowane w cudzysłowy. Nazwy standardowych folderów należy oznaczyć poprzez napis FOLDER (bez cudzysłowów), a węzłów master - przez MASTER  (również bez cudzysłowów) - tak jak w niżej przedstawionym przykładzie ("Przykładowa zawartość upladowanego pliku"). Kodowanie i separator należy wybrać zgodnie ze specyfiką przygotowanego pliku.

Typ placementu zawsze wymieniony jest jako druga wartość i nie posiada dodatkowych oznaczeń.

Aby tylko dodać placement (bez modyfikacji istniejących), pozostałe ustawienia należy pozostawić niezmienione.

Aby zmodyfikować istniejące placementy należy wybrać ustawienie: Update: Y.

Aby dodać lub zmodyfikować restrykcje, należy również wybrać ustawienie: Process restrictions: Y.    

Przykładowa zawartość upladowanego pliku:

Publisher name
,"gemius",FOLDER
,,"contact","None","fr:Mobile display"
,,"Homepage",MASTER
,,,"Billboard","Billboard 750x100","c:nowa","c:750x100","fr:Billboard"
,"gemius_video",MASTER,"Video VAST3"
,,"gemius_video_1"
,"gemius_programmatic",MASTER,"AOSSP Bidding in Prebid"
,,"gemius_programmatic_1"

Aby usunąć kategorię/restrykcję należy usunąć odpowiednie wartości z przesyłanego pliku. W prezentowanym wyżej przykładzie usunięta została wartość "sr:750x100", a więc usunięte zostaną restrykcje z placementu "Billboard". Parametry dodane bez prefixu zostaną zignorowane.

Nazwy placementów nie mogą się powtarzać w ramach jednego węzła (zwykłego czy typu master). W przypadku zamieszczenia w pliku dwóch placementów o nazwie: "Billboard", aktualizacja nie będzie możliwa i musi zostać przeprowadzona przez API lub bezpośrednio w interfejsie AdOcean.

Profile placementów

Możliwe jest również dodame placementów pod węzeł master oraz przypisanie profilu placementu: wystarczy zamieścić nazwę profilu po oznaczeniu MASTER, tak jak w prezentowanym wyżej przykładzie ("AOSSP Bidding in Prebid"). Można dodać dowolny profil placementu, ale tylko jeśli nie wymaga on ustawienia dodatkowych parametrów. W przypadku profili video, należy zdefiniować również część "Values for newly created video placements".


add space adocean get space