Sklik API

Keywords

keywords.stats

Get statistics for keywords.

Parameters

struct user {
string session Session (as retrieved from client.login())
int userId (optional) User ID
}
array keywordIds (
int Keyword ID
)
struct params {
datetime dateFrom Start date (YYYY-MM-DD)
datetime dateTo End date (YYYY-MM-DD)
string granularity Granularity:
  • total: Sum all stats together
  • daily: Split stats by day
  • weekly: Split stats by week
  • monthly: Split stats by month
  • quarterly: Split stats by quarter
  • yearly: Split stats by year
bool splitBySearchQuery (optional) Split report by search queries [default: false]
}

Response

struct {
int status Status code
string statusMessage Status code description
string session Refreshed session
array report ( Statistical report
struct {
int keywordId ID of keyword
array stats (
struct {
datetime date Start date of given period (depends on granularity)
int impressions Number of impressions
int clicks Number of clicks
double ctr Click ratio - how much clicks per one impression (%)
int cpc Cost per click - average cost per one click
int price Total price paid for displaying ads (for clicks or impressions)
double avgPosition Average position of ad in display format
int conversions Number of conversions (how many times user made an order)
double conversionRatio How many conversions per one click (%)
int conversionAvgPrice Price of one conversion
int conversionValue Value of conversions
int conversionAvgValue Average value of conversion
double conversionValueRatio Value / price ratio (%)
int transactions Number of transactions
int transactionAvgPrice Price of one transaction
int transactionAvgValue Average value of one transaction
double transactionAvgCount Average number of transactions per conversion
string searchQuery (optional) When splitted by search query, contains search query.
int lowBudgetLostImpressions Impressions lost because of low budget
int schedulingLostImpressions Impressions lost because of scheduling
int lowRankLostImpressions Impressions lost because of low auction rank
int lowRelevanceLostImpressions Impressions lost because of low ad relevance
double impressionShare Impression share (%)
int quality Quality (1-10)
}
)
}
)
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-2018

www.seznam.cz   Help   Contact