Sklik API

Keywords

Back to home

Changelog

Usage

Ads

Api

Autotagging

Banners

Campaigns

Client

Conversions

Dynamictemplates

Groups

Images

Intends

Interests

Keywords

Patterns

Productsets

Queries

Retargeting

Sharedbudgets

Sitelinks

Stats

Themes

keywords.createReport

Create statistic report for keywords.

Parameters

struct user {
string session

Session (as retrieved from client.loginByToken())
int userId

(optional) Managed user ID
}
struct restrictionFilter {
array ids (

(optional) display keyword by given ids
)
array names (

(optional) definition of searching in creative
struct {
string operator

comparison for following operators:

  • CONTAINS: contains
  • NOT_CONTAINS: does not contain
  • PHRASE: phrase (contain phrase)
  • NEGATIVE_PHRASE: negative phrase(does not contain phrase)
  • STARTS_WITH: starts with
  • NOT_STARTS_WITH: does not start with
  • ENDS_WITH: ends with
  • NOT_ENDS_WITH: does not end with
string value

value
}
)
array matchType (

(optional) return only keywords with following states:
string

(optional) type of conformity:

  • broad: broad
  • phrase: phrase
  • exact: exact
)
bool isDeleted

(optional) returns deleted/undeleted. If unassigned returns both.
array mixedStatus (

(optional) return only keywords with following states:
string

states:

  • active: active
  • active-noactive: suspended by system, for continue just change cpc
  • active-never: suspended by system, there is no cpc which can trigger it
  • active-disabled: prohibited keyword
  • suspended: suspended by user
  • deleted: deleted
)
array urls (

(optional) definition of searching in url
struct {
string operator

comparison for following operators:
string value

value
}
)
array maxCpc (

(optional) Max cost per click
struct {
string operator

comparison for following operators:

  • EQ: equal
  • NEQ: not equal
  • GT: greater than
  • GTE: greater than or equal
  • LT: less than
  • LTE: less than or equal
int value

value
}
)
struct group {

(optional) filters for superior group
array ids (

(optional) display kws from next groups (excludes: names)
int

group id
)
array names (

(optional) definition of searching in groups names
struct {
string operator

comparison for following operators:

  • CONTAINS: contains
  • NOT_CONTAINS: does not contains
  • PHRASE: phrase (contains phrase)
  • NEGATIVE_PHRASE: negative phrase(does not contain phrase)
  • STARTS_WITH: starts with
  • NOT_STARTS_WITH: does not start with
  • ENDS_WITH: ends with
  • NOT_ENDS_WITH: does not end with
string value

value
}
)
array mixedStatus (

(optional) return only keywords with following states of their groups:
string

states:

  • active: active
  • noactive: suspended by system
  • suspended: suspended by user
  • deleted: deleted
)
array status (

(optional) returns only keywords with following states of their groups:
string

states:

  • active: active
  • noactive: suspended by system
  • suspend: suspended by user
)
bool isDeleted

(optional) return deleted/undeleted. If unassigned returns both.
}
struct campaign {

(optional) filters for superior campaign
array ids (

(optional) display keywords from next campaigns (excludes: names)
int

campaign id
)
array names (

(optional) definition of search in campaign names
struct {
string operator

comparison for following operators:

  • CONTAINS: contains
  • NOT_CONTAINS: does not contain
  • PHRASE: phrase (contains phrase)
  • NEGATIVE_PHRASE: negative phrase (does not contain phrase)
  • STARTS_WITH: starts with
  • NOT_STARTS_WITH: does not start with
  • ENDS_WITH: ends with
  • NOT_ENDS_WITH: does not end with
string value

value
}
)
array type (

(optional) campaign type:
string

campaign types:

  • context: Display campaign
  • fulltext: Search campaign
  • combined: Combined campaign
  • video: Video campaign
  • product: Product campaign
  • zbozi: Zboži.cz campaign
  • simple: simple ads campaign
)
array status (

(optional) returns only keywords with following states of their campaigns:
string

states:

  • active: active
  • noactive: suspended by system
  • suspend: suspended by user
)
array mixedStatus (

(optional) returns only keywords with following states of their campaigns
string

allowed states:

  • active: active
  • active-exhausted_day_budget: exhausted day budget
  • active-expired_budget: expired budget
  • active-expired_clicks: max number of clicks has been reached
  • active-expired_time: outside time plan
  • active-low_budget: low budget
  • active-waiting: waiting for confirmation
  • suspended: suspended by user
  • deleted: deleted
)
bool isDeleted

(optional) returns deleted/undeleted. If unassigned returns both.
}
array statisticsConditions (

(optional) conditions for statistics
struct {
string columnName

(optional) type of statistic:

  • impressions: type int
  • clicks: type int
  • ctr: type double
  • avgCpc: type double
  • avgPosition: type double (1.0 and greater)
  • conversions: type int
  • conversionRatio: type double (range 0.0 – 1.0)
  • conversionPrice: type double
  • conversionValue: type int
  • transactions: type int
  • pno: type double (range 0.0 – 1.0)
  • quality: type int
  • ishExhaustedBudget: type int
  • ishExhaustedBudgetShare: type double (range 0.0 – 1.0)
  • ishStoppedBySchedule: type int
  • ishStoppedByScheduleShare: type double (range 0.0 – 1.0)
  • ishUnderForestThreshold: type int
  • ishUnderForestThresholdShare: type double (range 0.0 – 1.0)
  • ish: type double
string operator

comparison for following operators:

  • EQ: equal
  • NEQ: not equal
  • GT: greater than
  • GTE: greater than or equal
  • LT: less than
  • LTE: less than or equal
int intValue

(optional) value (excludes: doubleValue)
double doubleValue

(optional) value
}
)
array deviceType (

(optional) Type of device for stats:
string

(optional) type of the device: [default: deviceAll]

  • devicePhone: stats for phone
  • deviceTablet: stats for tablet
  • deviceOther: stats for other device
  • deviceDesktop: stats for desktop
  • deviceAll: stats summary (total)
)
datetime dateFrom

date from
datetime dateTo

date to
}
struct displayOptions {

(optional) Determines which information are returned. [default: see below]
bool includeCurrentDayStats

(optional) Return inaccurate current day statistics. Date range has to contain actual date! [default: False] (only for statGranularity in ["daily", "total"])
string statGranularity

(optional) Granularity of statistics: [default: total]

  • total: do not split
  • daily: split by days
  • weekly: split by weeks
  • monthly: split by months
  • quarterly: split by quarters
  • yearly: split by year
}

Response

struct {
int reportId

id of report
int status

return code
long totalCount

number of entities
string statusMessage

verbal description of return code
string session

Refreshed session
array diagnostics (

(optional) 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-2024

www.seznam.cz Help Contact