Skip to content

Data Capture Parameters

PromInc edited this page Jan 7, 2016 · 2 revisions

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 Google Default: 5000
dimensions No string Google Comma (,) separate multiple values.
filters No string Google 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 Google Not set by default.
search_type No string Google 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.
Clone this wiki locally