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 alias Adspace Manager (wcześniej: Wydawca) to całkowicie osobne jednostki.
- Jeden Adspace Manager może mieć dostęp do wielu Adspace'ów.
- Różne poziomy dostępu dla kont Adspace Manager 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ą Adspaces.
Zakładka Raporty
- Raporty okresowe – właścicel 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 Adspace Manager mogą wybrać Adspace, dla którego wyniki chcą obejrzeć.
Zakładka Przestrzeń reklamowa
- Edytuj Adspace – prezentuje listę Adspace'ów.
- Kolumna i pole "login" zostały usunięte z tabeli i widoku edycji Adspace. Loginy są teraz dostępne w zakładce Użytkownicy → Adspace Managers (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: Adspace Managers, pozwalająca na zarządzanie nowym rodzajem aliasu.
Uwaga: podczas okresu przejściowego dostępna będzie opcja “Include old publisher accounts”, umożliwiająca wyświetlenie starych Wydawców.
Kliknięcie w danego Adspace Managera otwiera widok edycji, w którym można:
Dostosować poziom dostępu:
- Analityk Adspace – odpowiednik wydawcy bez dostępu do zarządzania kampaniami i przestrzenią reklamową.
- Manager kampanii Adspace – odpowiednik wydawcy z dostępem do zarządzania kampaniami, ale bez zarządzania przestrzenią reklamową.
- Administrator i manager kampanii Adspace – odpowiednik wydawcy z dostępem do zarządzania kampaniami i przestrzenią reklamową.
Oraz przypisać poszczególne Adspace'y do wybranego Adspace Managera.
Uwaga: obecnie starzy Wydawcy nie mogą zostać przypisani do nowych Adspace'ów - jest to możliwe tylko dla nowo utworzonych kont z grupy Adspace Manager. 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'ów 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'y do wybranej kampanii.
- AddAdspaceAccess – przydziela danemu Adspace Managerowi dostęp do wybranych Adspace'ów.
- DeleteAdspaceAccess – usuwa dostęp Adspace Managera z wybranych Adspace'ów.
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 uznany za przestarzały.
- 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 uznany za przestarzały.
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 Adspace Manager – będą działać w taki sam sposób, jak nowo tworzone konta Adspace Manager. W konsekwencji, opcja “Include old publisher accounts” zostanie usunięta z widoku Adspace Manager.
- 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