Sklik API

Ads

ads.update

This method sets ads attributes (status or connection to Firmy.cz catalog).

Ad title, content and URLs (creative1, creative2, creative3, clickthruText) cannot be changed. Old ad will be deleted and new one will be created and newIds will be provided in response.

Parameters

struct user {
string session Session (as retrieved from client.login())
int userId (optional) User ID
}
array ads (
struct {
int id Ad ID
int requestId (optional) Chosen id to identify item in response and diagnostics
string creative1 (optional) First line of ad (title)
string creative2 (optional) Second line of ad
string creative3 (optional) Third line of ad
string clickthruText (optional) URL that is displayed
string clickthruUrl (optional) URL to which is the user redirected
string status (optional) Change ad status:
  • active: Ad is active
  • suspend: Ad is suspended
string premiseMode (optional) Premise display mode (for connection with catalog Firmy.cz):
  • disabled: Assigned premise is not shown
  • one: Premise specified in premiseId is shown
  • nearest: Client nearest premise is shown
  • inherit: Premise is inherited from campaign
int premiseId (can be null)(only for premiseMode='one') Premise id (or nil; for connection with catalog Firmy.cz)
}
)

Response

struct {
int status Status code
string statusMessage Status code description
string session Refreshed session
array newAdIds ( (optional) Array of new created ads.
int ID of new created ad
)
array diagnostics ( (optional) Array of various diagnostics(warnings, errors, other information)
struct {
...
}
)
}

Response status codes:

List of all possible response status codes:

Diagnostics:

List of all possible diagnostics:

            
        

Copyright © 1996-2018

www.seznam.cz   Help   Contact