Development Newsletters
Release: 01-10-2025
Lista wprowadzanych zmian:
Przygotowaliśmy dużą zmianę w sposobie, w jaki Wydawcy będą mogli uzyskać dostęp
i zarządzać swoją przestrzenią reklamową w AdOcean.
Uwaga: Aby ułatwić użytkownikom przyzwyczajenie się do nowego systemu, a jednocześnie zachować wsteczną kompatybilność, zapewniamy 5-tygodniowy okres przejściowy.
Zmiany w dostępie Wydawcy
- Do tej pory utworzenie nowej powierzchni reklamowej wiązało się automatycznie z utworzeniem użytkownika typu Wydawca.
- Teraz, AdSpace (przestrzeń reklamowa) i konto-alias z grupy Zarządzający AdSpace (wcześniej: Wydawca) to całkowicie osobne jednostki.
- Jeden Zarządzający AdSpace może mieć dostęp do wielu AdSpace.
- Różne poziomy dostępu dla kont Zarządzających AdSpace znacząco ułatwiają współpracę i kontrolę.
Nowa struktura oznacza bardziej elastyczny, intuicyjny i wydajny sposób organizacji przestrzeni reklamowych.
W ramach tej zmiany wprowadzamy również odpowiednie dostosowanie interfejsu i API.
Zmiany w interfejsie
Widok kampanii
W menu kampanii na pasku bocznym zakładka Wydawcy została zastąpiona zakładką AdSpace.
Zakładka Raporty
- Raporty okresowe – właściciel raportu został zmieniony z Wydawcy na AdSpace. Wszyscy użytkownicy z dostępem do danego AdSpace będą mieli teraz automatycznie dostęp do jego raportów.
- Raporty finansowe – użytkownicy z grupy Zarządzający AdSpace mogą wybrać AdSpace, dla którego wyniki chcą obejrzeć.
Zakładka Przestrzeń reklamowa
- Edytuj AdSpace – prezentuje listę dostępnych AdSpace.
- Kolumna i pole "login" zostały usunięte z tabeli i widoku edycji AdSpace. Loginy są teraz dostępne w zakładce Użytkownicy → Zarządzający AdSpace (patrz "Zakładka Użytkownicy" niżej).
- Statystyki – należy wybrać AdSpace, dla którego mają zostać wyświetlone statystyki:
- Inventory – należy wybrać odpowiedni AdSpace, aby wyświetlić statystyki:
Zakładka Użytkownicy
W menu bocznym została dodana nowa zakładka: Zarządzający AdSpace, pozwalająca na zarządzanie nowymi rodzajami aliasów.
Uwaga: podczas okresu przejściowego dostępna będzie opcja "Uwzględnij stare konta wydawców" (“Include old publisher accounts”), umożliwiająca wyświetlenie starych Wydawców.
Kliknięcie w danego Zarządzającego AdSpace otwiera widok edycji, w którym można:
Dostosować poziom dostępu:
- Analityk AdSpace (AdSpace Analyst) – odpowiednik wydawcy bez dostępu do zarządzania kampaniami i przestrzenią reklamową.
- Zarządzający kampaniami w AdSpace (AdSpace campaign manager) – odpowiednik wydawcy z dostępem do zarządzania kampaniami, ale bez zarządzania przestrzenią reklamową.
- Administrator AdSpace i zarządzający kampaniami w AdSpace (AdSpace campaign manager and administrator) – odpowiednik wydawcy z dostępem do zarządzania kampaniami i przestrzenią reklamową.
Oraz przypisać poszczególne AdSpace do wybranego Zarządzającego AdSpace.
Uwaga: obecnie starzy Wydawcy nie mogą zostać przypisani do nowych AdSpace - jest to możliwe tylko dla nowo utworzonych kont z grupy Zarządzający AdSpace. Konta Wydawców będzie natomiast można przypisać do AdSpace po zakończeniu okresu przejściowego (patrz "Zmiany po okresie przejściowym" niżej).
Zmiany w API
Nowe operacje API:
- GetAdspaceInfo – zwraca szczegóły pojedynczego AdSpace.
- GetAdspacesList – zwraca listę AdSpace dostępnych dla danego konta.
- AddAdspace – tworzy nowy AdSpace bez przypisywania użytkownika.
- UpdateAdspace – aktualizuje wybrany AdSpace.
- ActivateAdspaces – aktywuje/deaktywuje wybrany AdSpaces.
- GetAssignedAdspacesList – odpowiednik operacji GetAssignedPublishersList.
- UpdateCampaignAdspaces – przypisuje wybrane AdSpace do wybranej kampanii.
- AddAdspaceAccess – przydziela danemu Zarządzającemu AdSpace dostęp do wybranych AdSpace.
- DeleteAdspaceAccess – usuwa dostęp Zarządzającego AdSpace z wybranych AdSpace.
Zmiany w operacjach:
Operacje adspace_analyst, adspace_campaign_manager i adspace_campaign_manager_and_administrator:
- nowe wartości dla aliasType:
- adspace_analyst – odpowiednik wydawcy bez dostępu do zarządzania kampaniami (trafficAccess="N") i przestrzenią reklamową (adSpaceEditAccess="N").
- adspace_campaign_manager – odpowiednik wydawcy z dostępem do zarządzania kampaniami (trafficAccess="Y"), ale bez zarządzania przestrzenią reklamową (adSpaceEditAccess="N").
- adspace_campaign_manager_and_administrator – odpowiednik wydawcy z dostępem do zarządzania kampaniami (trafficAccess="Y") i przestrzenią reklamową (adSpaceEditAccess="Y").
Operacja UpdateUserAlias:
- od teraz obsługuje nowe wartości aliasType: adspace_analyst, adspace_campaign_manager oraz adspace_campaign_manager_and_administrator
Operacja DeleteUserAlias:
- pozwala na usuwanie nowych typów aliasów.
Operacja GetStatisticCampaignsList:
- Nowy parametr: withCampaignsAssignedToAdspaceManager (działa tak samo jak withCampaignsAssignedToPublisher).
- Uwaga: po zakończeniu okresu przejściowego parametr withCampaignsAssignedToPublisher zostanie usunięty.
- Nowy parametr zapytania i odpowiedzi: adspaceID.
- Uwaga: po zakończeniu okresu przejściowego parametr publisherID nie będzie dłużej dostępny i zostanie usunięty z odpowiedzi.
- Zmiany w parametrach odpowiedzi: z publisherID na adspaceID, z publisherName na adspaceName.
- Uwaga: po zakończeniu okresu przejściowego parametry publisherID oraz publisherName zostaną usunięte z odpowiedzi.
- Zmiany w parametrach odpowiedzi: z publisherID na adspaceID.
- Uwaga: po zakończeniu okresu przejściowego parametry publisherID oraz publisherName zostaną usunięte z odpowiedzi.
- Nowa wartość statsType: adspaces.
- Uwaga: po zakończeniu okresu przejściowego parametr statsType: publishers zostanie usunięty.
Zmiany po okresie przejściowym
Po zakończeniu okresu przejściowego wprowadzone zostaną następujące zmiany:
- Wszystkie stare konta Wydawców zostaną przekonwertowane do kont Zarządzających AdSpace – będą działać w taki sam sposób, jak nowo tworzone konta Zarządzających AdSpace. W konsekwencji, opcja “Zarządzający Kampaniami w AdSpace” zostanie usunięta z widoku Zarządzających AdSpace .
- Niepotrzebne parametry związane ze starymi Wydawcami zostaną usunięte zgodnie z informacjami zawartymi w sekcji "Zmiany w API".
- Lista operacji API, które zostaną usunięte po zakończeniu okresu przejściowego:
- GetPublisherInfo → nowy odpowiednik: GetAdspaceInfo
- GetPublishersList → nowy odpowiednik: GetAdspacesList
- AddPublisher → nowy odpowiednik: AddAdspace
- UpdatePublisher → nowy odpowiednik: UpdateAdspace
- ActivatePublishers → nowy odpowiednik: ActivateAdspaces
- GetAssignedPublishersList → nowy odpowiednik: GetAssignedAdspacesList
- UpdateCampaignPublishers → nowy odpowiednik: UpdateCampaignAdspaces