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 Zarządzający AdSpace ("AdSpace Manager"). Można będzie również połączyć wiele AdSpace z jednym kontem z grupy Zarządzający AdSpace, 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 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. 

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

adocean adspace api użytkownicy