12. Need more help
• https://ws.webtrends.com/v3/Reporting/help
13. Basic Query Parameters
• format={html|json|xml|xml2|csv}
• period_type={agg|indv|trend}
• totals={all|only|none}
• suppress_error_codes={true|false}
• start_period and end_period
– Can be explicitly defined
• <yyyy>[m<MM>d<dd>h<HH>] (e.g. 2012m03d12)
– Can use date macros
• current_year, current_month, current_day,
current_hour, current_day_midnight
14. Basic Query Parameters
• format={html|json|xml|xml2|csv}
• period_type={agg|indv|trend}
• totals={all|only|none}
*For use in Excel
• suppress_error_codes={true|false} suppress_error_codes
must be set to true!!!
• start_period and end_period
– Can be explicitly defined
• <yyyy>[m<MM>d<dd>h<HH>] (e.g. 2012m03d12)
– Can use date macros
• current_year, current_month, current_day,
current_hour, current_day_midnight
23. Excel: Rolling 28-Day Report
• Building on the concepts in the prior example
https://ws.webtrends.com/v3/Reporting/
profiles/47839/Keymetrics/?
totals=none&start_period=current_da
y-28&end_period=current_day&perio
d_type=trend&format=html&suppress_e
rror_codes=true
24. Excel: Rolling 28-Day Report
• Building on the concepts in the prior example
https://ws.webtrends.com/v3/Reporting/
profiles/47839/Keymetrics/?
totals=none&start_period=current_da
y-28&end_period=current_day&perio
d_type=trend&format=html&suppress_e
rror_codes=true
https://ws.webtrends.com/v3/Reporting/
profiles/47839/Keymetrics/?
totals=none&start_period=current_da
y-56&end_period=current_day-29&pe
riod_type=trend&format=html&suppress
_error_codes=true
26. New API Features
Exciting new API features allow users to sort
and apply complex filtering logic to their
results
• Two new query parameters
– sortby
– query
27. Get Sorted!!!
• As an example, let’s say you’re interested in the top performing ad
campaigns over the course of the prior month.
https://ws.webtrends.com/v3/Reporting/
profiles/47839/reports/2Ht766mdyx6/?
totals=all&start_period=current_month-
1&end_period=current_month-1&period
_type=agg&format=html&measures=5*6
&suppress_error_codes=true
28. Get Sorted!!!
• As an example, let’s say you’re interested in the top performing ad
campaigns over the course of the prior month.
https://ws.webtrends.com/v3/Reporting/
profiles/47839/reports/2Ht766mdyx6/?
totals=all&start_period=current_month-
1&end_period=current_month-1&period
_type=agg&format=html&measures=5*6
&suppress_error_codes=true
https://ws.webtrends.com/v3/Reporting/
profiles/47839/reports/2Ht766mdyx6/?
totals=all&start_period=current_month-
1&end_period=current_month-1&period
_type=agg&sortby=1&format=html&me
asures=5*6&suppress_error_codes=tru
e
29. For Those With a Keen
https://ws.webtrends.com/v3/Reporting/
profiles/47839/reports/2Ht766mdyx6/?
totals=all&start_period=current_month-
1&end_period=current_month-1&period
_type=agg&format=html&measures=5*
6&suppress_error_codes=true
30. For Those With a Keen
https://ws.webtrends.com/v3/Reporting/
profiles/47839/reports/2Ht766mdyx6/?
totals=all&start_period=current_month-
1&end_period=current_month-1&period
_type=agg&format=html&measures=5*
6&suppress_error_codes=true
31. Query On!
• Users can apply complex filtering logic
to their results by constructing a query
• A query is comprised of conditional
statements linked together by standard
boolean operators
{ AND | OR }
32. A Simple Example
• For example:
– Let’s say you need to assemble a
report for international site pages
https://ws.webtrends.com/v3/
Reporting/profiles/28197/reports/
oOEWQj3sUo6/?query=Page
NOTLIKE *com/
*&totals=all&start_period=current_
month-1&end_period=current_mon
th&period_type=agg&format=html
&suppress_error_codes=true
33. A Simple Example
• For example:
– Let’s say you need to assemble a
report for international site pages
https://ws.webtrends.com/v3/
Reporting/profiles/28197/reports/
oOEWQj3sUo6/?query=Page
NOTLIKE *com/* AND Page
NOTLIKE *test/
*&totals=all&start_period=current_
month-1&end_period=current_mon
th&period_type=agg&format=html
&suppress_error_codes=true
34. Webtrends API Version Updates
Will Force a Will Force a Will not Force a
Major Version Point Version Version Update
Update Update
A change that A change that A change to
has the potential will not impact address specific
to break an current needs to meet
application using applications internal
this version requirements
40. The Webtrends Developer Network
• In order to download the DC API you must have a
Webtrends Developer Network account
https://developer.webtrends.com/
41. Downloading the DC API
• Once registered you will have access to enter the Data
IN section of the Developer Network
https://developer.webtrends.com/
42. Downloading the DC API
• On the right side of the page there will be a link to
‘Sample Client Code’
https://developer.webtrends.com/community/dc/
43. Downloading the DC API
• Download the Sample.zip file
https://developer.webtrends.com/docs/DOC-1151
46. Top 5 Take-Aways
• The DX API allows you to rapidly present
report data in Excel
• The New DX API features allow you to
quickly sort and filter your data
• The DX API versioning allows you to
gracefully navigate the API landscape
• Webtrends Generator provides an easy to
use GUI that allows you to quickly construct
REST requests
• Send data from your mobile apps using the
DC API!!!
47. Thank You
Brad Gross, Program Manager
Paul Lawbaugh, Senior Program Manager
Webtrends
brad.gross@webtrends.com