Daily Pivot Terms Success

Created by Lara Menéndez · last update July 25, 2019

Getting started

This report calculates the “success” of each search term for the selected date range drilledown by the filter specified. It retrieves the following metrics: number of queries, number of clicks (on first page and next pages), clicks on success, sponsored counts, evolution vs previous period, add to carts and wishlist. When the parameter terms is specified, all the queries that contain the given keyword are shown in the response.

Request

To retrieve data from this report, define the request using all the available params and filters detailed in the box.

First, ensure you get your token.

GET https://api.empathybroker.com/stats/v2/analysis/{Instance_ID}/PivotDistribution

Query Parameters

PARAMETER TYPE
start_date Int (ISO 8601 format)
end_date Int (ISO 8601 format)
filters list[str]
type int
terms str

Bearer Token Get your token

Example request: https://api.empathybroker.com/stats/v2/analysis/ebdemo/PivotDistribution?start_date=2019-07-10&end_date=2019-07-13&filters=lang,scope&lang=es_ES&scope=desktop&terms=camiseta


Response

Once the request is performed, the following KPIs are retrieved shaped in json format:

  • KPIs retrieved for each term drilleddown by specified pivots: total queries, clicks, adds to wishlist, adds to cart, findability, sessions, sponsored clicks, clicks on first page and next pages.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

{
    "data": [
        {
            "query_count": 6979,
            "click_count": 2749,
            "wishlist_count": 0,
            "add2cart_count": 268,
            "checkout_count": 0,
            "conversion_count": 0,
            "success_count": 2749,
            "pivots": [
                {
                    "value": "mobileappandroid",
                    "pivot": "scope"
                }
            ]
        },
        {
            "query_count": 4006,
            "click_count": 678,
            "wishlist_count": 0,
            "add2cart_count": 39,
            "checkout_count": 0,
            "conversion_count": 0,
            "success_count": 486,
            "pivots": [
                {
                    "value": "mobile",
                    "pivot": "scope"
                }
            ]
        },
        {
            "query_count": 2493,
            "click_count": 2986,
            "wishlist_count": 0,
            "add2cart_count": 253,
            "checkout_count": 0,
            "conversion_count": 0,
            "success_count": 2986,
            "pivots": [
                {
                    "value": "mobileappios",
                    "pivot": "scope"
                }
            ]
        },
        {
            "query_count": 1254,
            "click_count": 132,
            "wishlist_count": 0,
            "add2cart_count": 29,
            "checkout_count": 0,
            "conversion_count": 0,
            "success_count": 81,
            "pivots": [
                {
                    "value": "desktop",
                    "pivot": "scope"
                }
            ]
        },
        {
            "query_count": 454,
            "click_count": 50,
            "wishlist_count": 0,
            "add2cart_count": 2,
            "checkout_count": 0,
            "conversion_count": 0,
            "success_count": 37,
            "pivots": [
                {
                    "value": "tablet",
                    "pivot": "scope"
                }
            ]
        }
    ],
    "params": {
        "site_id": "ebdemo",
        "start_date": 1563408000000,
        "end_date": 1563840000000,
        "filters": [],
        "pivots": [
            "scope"
        ],
        "terms": "camiseta",
        "type": 0
    }
}