Explain a change
explain_changeWhy a site's visits, pageviews or visitors changed between a range and the period before, the one get_site_summary compares with, in one call. The answer's caveats are the rules that apply to its figures, such as drivers never adding up across dimensions: read them before reporting any figure, and pass on those that change what it means. For each dimension, channel, source, path, country, device, utm_campaign, asn unless dimensions names others, the values that moved most, each with its count in both periods, delta, change and beyond_site: how far it moved beyond keeping its share of the site, which sums to nought across a dimension. drivers are the values across every dimension that moved beyond the site past the noise rule, most first; within, the first driver's own drivers, under its filter. Dimensions are cuts of the same visits, so drivers overlap: never add them across dimensions. noise marks a change too small to read into, and broad a change spread across the site. without_value and rest make each dimension add up to totals' delta. metric is visits unless asked; under a goal filter every count is conversions and metric is refused. Name the site, range and filters as for get_site_summary, but for entry and exit and all time; skipped says which dimensions were not read, and why. The periods are compared in whole days. With a period before starting before the first counted day, no_change says why nothing is explained.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | With from: the last day, as YYYY-MM-DD, not after today. | |
| days | No | The last this many days, ending today unless ending says yesterday. | |
| from | No | With to: the first day, as YYYY-MM-DD. | |
| limit | No | How many values of each dimension, 5 by default. | |
| range | No | A preset, as get_site_summary's range says what each covers. | |
| domain | Yes | A domain from list_sites, or any public site's. | |
| ending | No | With days: the last day, today by default. | |
| metric | No | The count explained, visits by default, as traffic is measured. | |
| filters | No | Each narrows every figure to what has exactly that value, case and all, so google is not Google; all must hold. | |
| dimensions | No | The dimensions to look across, each once, at most 8. |