com.day.cq.analytics.sitecatalyst

Interface SitecatalystWebservice

public interface SitecatalystWebservice

Field Summary

Fields

Modifier and Type	Field and Description
static String	PN_COMPANY Property name for company
static String	PN_PASSWORD Property name for password
static String	PN_REPORTSUITE Property name for report suite
static String	PN_REPORTSUITES Property name for report suites
static String	PN_SECRET Property name for secret
static String	PN_SERVER Property name for server
static String	PN_USERNAME Property name for username

Method Summary

Methods

Modifier and Type	Method and Description
void	checkCredentials(String company, String username, String password) Deprecated.
boolean	deleteClassifications(Configuration configuration, String classificationView, String[] reportSuites, int divNum, int parentDivNum) Deletes a classification from one or more reportSuites.
JSONArray	getClassifications(Configuration configuration, String classificationView, String[] reportSuites, int relationId) Retrieves a list of classifications (associated with the specified element) for each of the specified reportSuites.
String	getEvars(Configuration configuration, String rsid) Returns a JSON representation of conversion variables (eVar's) for a report suite rsid.
String	getEvars(SitecatalystAccount account, String rsid) Deprecated.
String	getLoginKey(String company, String username, String password) Deprecated.
String	getLoginKey(String server, String company, String username, String password) Returns the login key (shared secret) for the provided company,username and password combination.
String	getMetrics(Configuration configuration, String rsID) Retrieves a list of possible valid elements for a report.
String	getPages(Configuration configuration, Integer limit, String pagename, String rsid, Integer start) Returns a JSON representation of pages matching the page name pagename for the report suite rsid.
String	getPages(SitecatalystAccount account, Integer limit, String pagename, String rsid, Integer start) Deprecated.
String	getReport(Configuration configuration, String reportID) Returns a report with report identifier reportID.
String	getReport(SitecatalystAccount account, String rsid) Deprecated.
String	getReportStatus(Configuration configuration, String reportID) Deprecated. Use getReport(Configuration, String) instead.
String	getReportStatus(SitecatalystAccount account, String rsid) Deprecated. Use getReport(Configuration, String) instead.
String	getReportSuites(Configuration configuration) Returns a JSON representation of report suites for a Configuration.
String	getReportSuites(SitecatalystAccount account) Deprecated.
String	getSuccessEvents(Configuration configuration, String rsid) Returns a JSON representation of success events (event's) for the report suite rsid.
String	getSuccessEvents(SitecatalystAccount account, String rsid) Deprecated.
String	getSynchronousReport(Configuration configuration, String reportType, JSONObject reportDescription) Returns a report of type reportType and report description reportDescription.
String	getTrackingServer(Configuration configuration, String rsid) Returns the tracking server URI for a specified ReportSuiteID ( rsid).
String	getTrackingServer(SitecatalystAccount account, String rsid) Deprecated.
String	getTrafficVars(Configuration configuration, String rsid) Returns a JSON representation of traffic variables (prop's) for a report suite rsid.
String	getTrafficVars(SitecatalystAccount account, String rsid) Deprecated.
String	queuePageViewReport(Configuration configuration, String rsid, String date) Queues a report of type pageView for a report suite rsid and the report date date
String	queuePageViewReport(SitecatalystAccount account, String rsid, String date) Deprecated.
String	queueReport(Configuration configuration, String reportType, JSONObject reportDescription) Queues a report of type reportType with the reportDescription.
boolean	saveClassifications(Configuration configuration, String classificationView, boolean campaignView, String name, int parentDivNum, String[] reportSuites, boolean update) Saves a classification for each of the specified reportSuites.

Field Detail

PN_COMPANY

static final String PN_COMPANY

Property name for company

See Also:

Constant Field Values

PN_USERNAME

static final String PN_USERNAME

Property name for username

See Also:

Constant Field Values

PN_SECRET

static final String PN_SECRET

Property name for secret

See Also:

Constant Field Values

PN_SERVER

static final String PN_SERVER

Property name for server

See Also:

Constant Field Values

PN_PASSWORD

static final String PN_PASSWORD

Property name for password

See Also:

Constant Field Values

PN_REPORTSUITE

static final String PN_REPORTSUITE

Property name for report suite

See Also:

Constant Field Values

PN_REPORTSUITES

static final String PN_REPORTSUITES

Property name for report suites

See Also:

Constant Field Values

Method Detail

checkCredentials

@Deprecated
void checkCredentials(String company,
                               String username,
                               String password)
                      throws SitecatalystException

Deprecated.

Checks SiteCatalyst credentials by issuing the API call Company.GetReportSuites.

Parameters:

company -

username -

password -

Throws:

SitecatalystException - - if an error occurs, authentication or authorization fails.

getLoginKey

@Deprecated
String getLoginKey(String company,
                            String username,
                            String password)
                   throws SitecatalystException

Deprecated.

Returns the login key (shared secret) for the provided company,username and password combination.

Parameters:

company - Company

username - Username

password - Password

Throws:

SitecatalystException

getLoginKey

String getLoginKey(String server,
                 String company,
                 String username,
                 String password)
                   throws SitecatalystException

Returns the login key (shared secret) for the provided company,username and password combination.

Parameters:

server - Server end point URL

company - Company

username - Username

password - Password

Throws:

SitecatalystException

getReportSuites

@Deprecated
String getReportSuites(SitecatalystAccount account)
                       throws SitecatalystException

Deprecated.

Get report suites for account.

Parameters:

account - SitecatalystAccount

Returns:

JSON String representation of report suites.

Throws:

SitecatalystException

See Also:

getReportSuites(Configuration)

getReportSuites

String getReportSuites(Configuration configuration)
                       throws SitecatalystException

Returns a JSON representation of report suites for a Configuration.

Parameters:

configuration - Web service support configuration

Returns:

JSON string

Throws:

SitecatalystException

getTrackingServer

@Deprecated
String getTrackingServer(SitecatalystAccount account,
                                  String rsid)
                         throws SitecatalystException

Deprecated.

Gets configured tracking server for a report suite.

Parameters:

account - SitecatalystAccount

rsid - Report suite ID

Returns:

Throws:

SitecatalystException

See Also:

getTrackingServer(Configuration, String)

getTrackingServer

String getTrackingServer(Configuration configuration,
                       String rsid)
                         throws SitecatalystException

Returns the tracking server URI for a specified ReportSuiteID ( rsid).

Parameters:

configuration - Web service support configuration

rsid -

Returns:

Throws:

SitecatalystException

getEvars

@Deprecated
String getEvars(SitecatalystAccount account,
                         String rsid)
                throws SitecatalystException

Deprecated.

Gets EVars for a report suite.

Parameters:

account - SitecatalystAccount

rsid - Report suite ID

Returns:

Throws:

SitecatalystException

See Also:

getEvars(Configuration, String)

getEvars

String getEvars(Configuration configuration,
              String rsid)
                throws SitecatalystException

Returns a JSON representation of conversion variables (eVar's) for a report suite rsid.

Parameters:

configuration - Web service support configuration

rsid -

Returns:

Throws:

SitecatalystException

getTrafficVars

@Deprecated
String getTrafficVars(SitecatalystAccount account,
                               String rsid)
                      throws SitecatalystException

Deprecated.

Gets TrafficVars for a report suite.

Parameters:

account - SitecatalystAccount

rsid - Report suite ID

Returns:

Throws:

SitecatalystException

See Also:

getTrackingServer(Configuration, String)

getTrafficVars

String getTrafficVars(Configuration configuration,
                    String rsid)
                      throws SitecatalystException

Returns a JSON representation of traffic variables (prop's) for a report suite rsid.

Parameters:

configuration - Web service support configuration

rsid -

Returns:

Throws:

SitecatalystException

queueReport

String queueReport(Configuration configuration,
                 String reportType,
                 JSONObject reportDescription)
                   throws SitecatalystException

Queues a report of type reportType with the reportDescription.

Parameters:

configuration - Web service support configuration

reportType - The type of report to queue

reportDescription - The reportDescription JSON to use

Returns:

Throws:

SitecatalystException

Since:

5.6

queuePageViewReport

@Deprecated
String queuePageViewReport(SitecatalystAccount account,
                                    String rsid,
                                    String date)
                           throws SitecatalystException

Deprecated.

Queues a page view report for a report suite.

Parameters:

account - SitecatalystAccount

rsid - Report suite ID

date -

Returns:

Throws:

SitecatalystException

See Also:

queuePageViewReport(Configuration, String, String)

queuePageViewReport

String queuePageViewReport(Configuration configuration,
                         String rsid,
                         String date)
                           throws SitecatalystException

Queues a report of type pageView for a report suite rsid and the report date date

Parameters:

configuration - Web service support configuration

rsid -

date -

Returns:

Throws:

SitecatalystException

getReportStatus

@Deprecated
String getReportStatus(SitecatalystAccount account,
                                String rsid)
                       throws SitecatalystException

Deprecated. Use getReport(Configuration, String) instead.

Gets report status for report suite.

Parameters:

account - SitecatalystAccount

rsid - Report suite ID

Returns:

Throws:

SitecatalystException

See Also:

getReportStatus(Configuration, String)

getReportStatus

@Deprecated
String getReportStatus(Configuration configuration,
                                String reportID)
                       throws SitecatalystException

Deprecated. Use getReport(Configuration, String) instead.

Returns status of a report with report identifier reportID.

Parameters:

configuration - Web service support configuration

reportID -

Returns:

Throws:

SitecatalystException

getReport

@Deprecated
String getReport(SitecatalystAccount account,
                          String rsid)
                 throws SitecatalystException

Deprecated.

Gets report for report suite.

Parameters:

account - SitecatalystAccount

rsid - Report suite ID

Returns:

Throws:

SitecatalystException

See Also:

getReport(Configuration, String)

getReport

String getReport(Configuration configuration,
               String reportID)
                 throws SitecatalystException

Returns a report with report identifier reportID.

Parameters:

configuration - Web service support configuration

reportID -

Returns:

Throws:

SitecatalystException

getSynchronousReport

String getSynchronousReport(Configuration configuration,
                          String reportType,
                          JSONObject reportDescription)
                            throws SitecatalystException

Returns a report of type reportType and report description reportDescription.

Parameters:

configuration - Web service support configuration

reportType - the type of report to queue

reportDescription - the reportDescription json to use

Returns:

Throws:

SitecatalystException

Since:

5.6

getMetrics

String getMetrics(Configuration configuration,
                String rsID)
                  throws SitecatalystException

Retrieves a list of possible valid elements for a report. Some accounts may not have access to certain metrics. The metrics returned by GetMetrics reflect those restrictions. See more information on this API method at https://marketing.adobe.com/developer/en_US/documentation/analytics-reporting-1-4/r-getmetrics

Parameters:

configuration - Web service support configuration

rsID - The reporting suite id

Returns:

response String

Throws:

SitecatalystException

getSuccessEvents

@Deprecated
String getSuccessEvents(SitecatalystAccount account,
                                 String rsid)
                        throws SitecatalystException

Deprecated.

Gets SuccessEvents for a report suite.

Parameters:

account - SitecatalystAccount

rsid - Report suite ID

Returns:

Throws:

SitecatalystException

See Also:

getSuccessEvents(Configuration, String)

getSuccessEvents

String getSuccessEvents(Configuration configuration,
                      String rsid)
                        throws SitecatalystException

Returns a JSON representation of success events (event's) for the report suite rsid.

Parameters:

configuration - Web service support configuration

rsid -

Returns:

Throws:

SitecatalystException

getPages

@Deprecated
String getPages(SitecatalystAccount account,
                         Integer limit,
                         String pagename,
                         String rsid,
                         Integer start)
                throws SitecatalystException

Deprecated.

Gets a list of Pages for a report suite.

Parameters:

account -

limit -

pagename -

rsid -

start -

Returns:

Throws:

SitecatalystException

See Also:

getPages(Configuration, Integer, String, String, Integer)

getPages

String getPages(Configuration configuration,
              Integer limit,
              String pagename,
              String rsid,
              Integer start)
                throws SitecatalystException

Returns a JSON representation of pages matching the page name pagename for the report suite rsid.

Parameters:

configuration - Web service support configuration

limit - Max. number of pages

pagename - Name of the page

rsid - Report Suite ID

start - Start point for paging

Returns:

Throws:

SitecatalystException

getClassifications

JSONArray getClassifications(Configuration configuration,
                           String classificationView,
                           String[] reportSuites,
                           int relationId)
                             throws SitecatalystException

Retrieves a list of classifications (associated with the specified element) for each of the specified reportSuites.

Parameters:

configuration - Web service support configuration

classificationView - The ID of the element whose classifications are being retrieved. The possible type IDs include the following elements.

• campaign Classification applied to the Campaign report.
• days_between_buys Classification applied to the Days Between Buys report.
• days_till_purchase Classification applied to the Days Until Purchase report.
• domain Classification applied to the Domain report.
• evar1-75 Classification applied to the specified eVar report (evar1, evar2, etc.)
• first_touch_marketing_channel Classification applied to the First Touch Marketing Channel report.
• first_touch_marketing_channel_detail Classification applied to the detailed First Touch Marketing Channel report.
• last_touch_marketing_channel Classification applied to the Last Touch Marketing Channel report.
• last_touch_marketing_channel_detail Classification applied to the detailed Last Touch Marketing Channel report.
• loyalty Classification applied to the Loyalty report.
• media Classification applied to the Media report.
• page Classification applied to the Page report.
• page_type1-77 Classification applied to a specific Page Type report.
• page_type1 Site Sections
• page_type2 Servers
• page_type3-77 Custom Insight (Props) 1 - 75.
• mvvar45-47 Classification applied to a List Var report, mvvar45 - mvvar47 = listvar1 - listvar3.
• product Classification applied to the Product report.
• sitetime Classification applied to the Site Time report.
• state Classification applied to the State report.
• survey Classification applied to the Survey report.
• tnt Classification applied to the Adobe Target report.
• visitdepth Classification applied to the Visit Depth report.
• visitnum Classification applied to the VisitNum report.
• zipcode Classification applied to the Zip Code report.

reportSuites - A list of report suite IDs.

relationId - (Optional) Numeric ID of the variable for which you want to retrieve associated classifications or -1.

Returns:

A JSONArray of JSONObjects containing information about a report suite's classifications.The objects are of the following structure:

{
rsid: (int),
site_title: (string),
classifications: [{
classifications: [{
child_nodes: [{
rel_id: (int),
userid: (int),
div_name: (string),
div_num: (int),
parent_div_num: (int),
campaign_view_flag: (int),
type: (int),
order: (int),
child_nodes: (array)
}],
div_name: (string),
div_num: (int),
rel_id: (int)
}],
in_queue: (int),
status: (int)
}]
}

Throws:

SitecatalystException

Since:

5.7

saveClassifications

boolean saveClassifications(Configuration configuration,
                          String classificationView,
                          boolean campaignView,
                          String name,
                          int parentDivNum,
                          String[] reportSuites,
                          boolean update)
                            throws SitecatalystException

Saves a classification for each of the specified reportSuites.

Parameters:

configuration - Web service support configuration

classificationView - The ID of the element whose classifications are being retrieved. The possible type IDs include the following elements.

• campaign Classification applied to the Campaign report.
• days_between_buys Classification applied to the Days Between Buys report.
• days_till_purchase Classification applied to the Days Until Purchase report.
• domain Classification applied to the Domain report.
• evar1-75 Classification applied to the specified eVar report (evar1, evar2, etc.)
• first_touch_marketing_channel Classification applied to the First Touch Marketing Channel report.
• first_touch_marketing_channel_detail Classification applied to the detailed First Touch Marketing Channel report.
• last_touch_marketing_channel Classification applied to the Last Touch Marketing Channel report.
• last_touch_marketing_channel_detail Classification applied to the detailed Last Touch Marketing Channel report.
• loyalty Classification applied to the Loyalty report.
• media Classification applied to the Media report.
• page Classification applied to the Page report.
• page_type1-77 Classification applied to a specific Page Type report.
• page_type1 Site Sections
• page_type2 Servers
• page_type3-77 Custom Insight (Props) 1 - 75.
• mvvar45-47 Classification applied to a List Var report, mvvar45 - mvvar47 = listvar1 - listvar3.
• product Classification applied to the Product report.
• sitetime Classification applied to the Site Time report.
• state Classification applied to the State report.
• survey Classification applied to the Survey report.
• tnt Classification applied to the Adobe Target report.
• visitdepth Classification applied to the Visit Depth report.
• visitnum Classification applied to the VisitNum report.
• zipcode Classification applied to the Zip Code report.

campaignView - Determines whether to treat this classification like a campaign.

name - Visible name of the classification.

parentDivNum - Contains the parent classification's div_num if this is a sub-classification; otherwise it is 0.

reportSuites - A list of report suite IDs.

update - Enables the classification when set to true, disabled it otherwise.

Returns:

Returns true if the update operation is successful, false otherwise

Throws:

SitecatalystException

Since:

5.7

deleteClassifications

boolean deleteClassifications(Configuration configuration,
                            String classificationView,
                            String[] reportSuites,
                            int divNum,
                            int parentDivNum)
                              throws SitecatalystException

Deletes a classification from one or more reportSuites.

Parameters:

configuration - Web service support configuration

classificationView - The ID of the element whose classifications are being retrieved. The possible type IDs include the following elements.

• campaign Classification applied to the Campaign report.
• days_between_buys Classification applied to the Days Between Buys report.
• days_till_purchase Classification applied to the Days Until Purchase report.
• domain Classification applied to the Domain report.
• evar1-75 Classification applied to the specified eVar report (evar1, evar2, etc.)
• first_touch_marketing_channel Classification applied to the First Touch Marketing Channel report.
• first_touch_marketing_channel_detail Classification applied to the detailed First Touch Marketing Channel report.
• last_touch_marketing_channel Classification applied to the Last Touch Marketing Channel report.
• last_touch_marketing_channel_detail Classification applied to the detailed Last Touch Marketing Channel report.
• loyalty Classification applied to the Loyalty report.
• media Classification applied to the Media report.
• page Classification applied to the Page report.
• page_type1-77 Classification applied to a specific Page Type report.
• page_type1 Site Sections
• page_type2 Servers
• page_type3-77 Custom Insight (Props) 1 - 75.
• mvvar45-47 Classification applied to a List Var report, mvvar45 - mvvar47 = listvar1 - listvar3.
• product Classification applied to the Product report.
• sitetime Classification applied to the Site Time report.
• state Classification applied to the State report.
• survey Classification applied to the Survey report.
• tnt Classification applied to the Adobe Target report.
• visitdepth Classification applied to the Visit Depth report.
• visitnum Classification applied to the VisitNum report.
• zipcode Classification applied to the Zip Code report.

reportSuites - A list of report suite IDs.

divNum - The numeric index of the classification in its group, which can be obtained from getClassifications(Configuration, String, String[], int)

parentDivNum - Contains the parent classification's div_num if this is a sub-classification; otherwise it is 0.

Returns:

Returns true if the deletion operation is successful, false otherwise.

Throws:

SitecatalystException

Since:

5.7