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".