Publisher – access changes

From now on, you can create Adspace – Advertising space – separately, and assign it to multiple alias accounts called Adspace Managers. With the new Adspace Manager alias, you can connect multiple Adspaces to one alias account, choose different access levels, and enjoy a simpler, more intuitive workflow.

Key changes:

• Until now, creating an advertising space automatically generated a publisher user.
• Now, Adspace (advertising space) and the alias Adspace Manager (formerly publisher) are separate entities.
• One Adspace Manager can have access to multiple Adspaces.
• Different access levels for Adspace Managers make collaboration and control much easier.

This means a more flexible, intuitive, and powerful way to organize your advertising spaces

Interface changes

As a part of this upgrade, we would like to introduce the following changes to the interface.

Campaign view

In the campaign sidebar, the Publishers tab has been replaced with a new AdSpaces tab.

Reports tab

• Period reports tab– the report owner has changed from Publisher to Adspace. All users with access to a given Adspace will now automatically have access to its reports.
• Financial reports tab – users with the Adspace Manager role can select the Adspace they want to view.

Adspace tab

• Edit Adspace tab – shows a list of Adspaces. 

The login column and login field has been removed from the table and from the Adspace edit view.

Logins are now available under Users → Adspace Managers (see Users tab below).

• Statistics tab – you need select the Adspace you want to display statistics for

• Inventory tab– you need select the relevant Adspace to view statistics.

Users tab

A new Adspace Managers tab has been added to the sidebar, allowing you to manage this new alias type.

Please note during the transition period, an option “Include old publisher accounts” is available, which lets you display old publishers.

Clicking on an Adspace Manager opens the edit view, where you can:

Adjust the access level:

• Adspace analyst – equivalent of publisher without access to campaigns or Adspace management (Advertising space management).
• Adspace campaign manager – equivalent of publisher with access to campaign management, but without Adspace management (Advertising space management).
• Adspace campaign manager and administrator – equivalent of publisher with access to both campaign and Adspace management (Advertising space management).

or assign specific Adspaces to the selected Adspace Manager.

Please note old publisher accounts cannot be assigned to new Adspaces. Only newly created Adspace Manager accounts have this capability. It will be possible after the transition period, which is described in detail in Changes after the transition period section below.

API changes

This update will result in changes across the API: 

New API commands:

GetAdspaceInfo – returns details of a single Adspace.

GetAdspacesList – returns a list of Adspaces available for a given account.

AddAdspace – creates a new Adspace without assigning a user.

UpdateAdspace – updates the selected Adspace.

ActivateAdspaces – activates/deactivates selected Adspaces.

GetAssignedAdspacesList – equivalent of GetAssignedPublishersList.

UpdateCampaignAdspaces – assigns selected Adspaces to a given campaign.

AddAdspaceAccess – grants an Adspace Manager access to selected Adspaces.

DeleteAdspaceAccess – removes an Adspace Manager’s access to selected Adspaces.

Changes in commands:

adspace_analyst, adspace_campaign_manager and adspace_campaign_manager_and_administrator commands

• new values for aliasType:
• adspace_analyst – equivalent of a publisher user without access to campaigns (trafficAccess="N") and without Adspace management rights (adSpaceEditAccess="N").
• adspace_campaign_manager – equivalent of a publisher with campaign management rights (trafficAccess="Y") but without Adspace management rights (adSpaceEditAccess="N").
• adspace_campaign_manager_and_administrator – equivalent of a publisher with both campaign management rights (trafficAccess="Y") and Adspace management rights (adSpaceEditAccess="Y").

UpdateUserAlias command

• now supports the new aliasType values: adspace_analyst, adspace_campaign_manager, and adspace_campaign_manager_and_administrator

DeleteUserAlias command

• allows deleting the newly added alias types

GetStatisticCampaignsList   command

• New parameter: withCampaignsAssignedToAdspaceManager (works the same way as withCampaignsAssignedToPublisher).
• Please note, after the transition period, the withCampaignsAssignedToPublisher parameter will be deprecated.

• New parameter: adspaceID.
• The response now includes adspaceID.
• Please note after the transition period, the publisherID parameter will no longer be available and will be removed from the response

• Response change: publisherID to adspaceID, publisherName to adspaceName
• Please note after the transition period, the parameters publisherID and publisherName will be removed from the response.

• Response change: publisherID to adspaceID.
• Please note after the transition period, the parameters publisherID and publisherName will be removed from the response.

• New statsType value: adspaces.
• Please note after the transition period, statsType: publishers will be deprecated.

Changes after the transition period

To help get accustomed to the new system while maintaining backward compatibility, we are providing a 5-week transition period. Once this period ends, the following changes will be applied:

• All old publisher accounts will be converted to the Adspace Manager accounts – they will function the same way as newly created Adspace Manager accounts. Consequently, the “Include old publisher accounts” option will be removed from the Adspace Manager view.
• Legacy old publisher parameters mentioned in the API Changes section above will be removed.
• List of API commands that will be removed after this period:
• GetPublisherInfo → new equivalent: GetAdspaceInfo
• GetPublishersList → new equivalent: GetAdspacesList
• AddPublisher → new equivalent: AddAdspace
• UpdatePublisher → new equivalent: UpdateAdspace
• ActivatePublishers → new equivalent: ActivateAdspaces
• GetAssignedPublishersList → new equivalent: GetAssignedAdspacesList
• UpdateCampaignPublishers → new equivalent: UpdateCampaignAdspaces

api interface