Data Capture Parameters - PromInc/organic-search-analytics GitHub Wiki
For the average user that utilizes the GUI only, these instructions will not be important. However if you wish to utilize this tool for programmatic means, automate it via a CRON job, etc. the following information describes what parameters are necessary.
To initiate the data capture from Google Search Console or Bing Webmaster Tools, a request to data-capture-run.php
is required with the appropriate GET parameters set.
This table describes what parameters are available to be set:
Parameter | Req. | Format | Search Engine | Notes |
---|---|---|---|---|
type | Yes | string | All |
Google: googleSearchAnalytics Bing: bingSearchKeywords |
domain | Yes | string | All | Must match exactly to how it appears in Google Search Console and/or Bing Webmaster Tools. |
date | Yes | yyyy-mm-dd | All |
Google: The date specified is the date for which data will be captured. Bing: The date is irrelevant as Bing pulls back all available data for multiple dates regardless of the date specified. A properly formatted date is still required however. |
mode | No | string | All | Specifies the action to take upon retrieving data from the API. Default: import Options: - import: Import the retrieved data to the database - return: Return all data directly from the Search Engine API response. Data will not be imported to the database. |
row_limit | No | integer | Default: 5000 | |
dimensions | No | string | Comma (,) separate multiple values. | |
filters | No | string | Pipe (|) separate multiple filters with comma (,) separated settings in the order of dimension (required), expression (required), operator (optional, defaults to contains). | |
aggregation_type | No | string | Not set by default. | |
search_type | No | string | Comma (,) separate multiple values. Options: - web - image - video Added in version 2.3.2 |
|
For more information regarding the various parameters allowed by the Google Search Analytics API, read the Google Help documentation. |