Development Newsletters

Release: 01-10-2025

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

Od teraz możliwe będzie utworzenie Adspace - przestrzeni reklamowej - osobno, a przypisać do niej będzie można wiele kont-aliasów z grupy Adspace Manager. Można będzie również połączyć wiele Adspace'ów z jednym kontem z grupy Adspace Manager, wybrać różne poziomy dostępów i cieszyć się prostszym i bardziej intuicyjnym schematem workflow. 

Kluczowe zmiany:
  • 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. 

Naciśnij Tab, aby zobaczyć działania

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.
Operacja GetPlacementsList:

  • 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.
Operacja GetPlacementCategoriesList:

  • 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.
Operacja GetAssignedPlacementCategoriesList:

  • Zmiany w parametrach odpowiedzi: z publisherID na adspaceID.
  • Uwaga: po zakończeniu okresu przejściowego parametry publisherID oraz publisherName zostaną usunięte z odpowiedzi.
Operacja GetPredictionStats:

  • 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

adocean adspace api użytkownicy