Link the Banner to Placement(s)

Links the Banner to Placements (or overwrites the existing links).

URL: /rest-api/banners/{bannerId}/placements.do
Method: PUT
Response format: application/json

Error codes:

  • 401 Unauthorized – authentication error.

Response sample:
200 OK
{"success":true, id:} – success, returns ID of affected Zone record.
{"success":false} – error {"success":false, "error":"permission_denied"} – error due to insufficient privileges.

Parameters:

  • hash – an MD5 digest of a concatenated username's MD5 password and a given timestamp.
  • timestamp – UNIX timestamp in milliseconds used in hash generation.
  • username – the given username.
  • ids – Placements' IDs.
  • append – (optional) boolean parameter to link Banners-Placements without overriding; true/false(default).

Delete the Banner to Placement link(s)

Removes the Banner to Placement link(s).

URL: /rest-api/banners/{bannerId}/placements.do
Method: DELETE
Response format: application/json

Error codes:

  • 401 Unauthorized – authentication error.

Response sample:
200 OK
{"success":true, id:} – success, returns ID of affected Zone record.
{"success":false} – error {"success":false, "error":"permission_denied"} – error due to insufficient privileges.

Parameters:

  • hash – an MD5 digest of a concatenated username's MD5 password and a given timestamp.
  • timestamp – UNIX timestamp in milliseconds used in hash generation.
  • username – the given username.
  • removeIds – Placements' IDs.

Get Linked Placements' List

Gets the list of all Placements linked to the Banners of the following types: SITE_PLACEMENT, NON_STANDARD_SITE_PLACEMENT, MOBILE_SITE_PLACEMENT, VIDEO_PLACEMENT, APPLICATION_PLACEMENT, EMAIL_PLACEMENT.

URL: /rest-api/banners/{bannerId}/placements.do
Method: GET
Response format: application/json

Error codes:

  • 401 Unauthorized – authentication error.

Response sample:
200 OK
[{"id":1, "name":"First Placement"}, ...]

Parameters:

  • hash – an MD5 digest of a concatenated username's MD5 password and a given timestamp.
  • timestamp – UNIX timestamp in milliseconds used in hash generation.
  • username – the given username.

Need more help?

Should you require any additional help with our solutions, do not hesitate to contact Epom technical support at support@epom.com. Our support managers are dedicated to resolving any issues and providing you with solutions and support if you face difficulties or have questions.