ClickExport API V2

Updated on 2014-04-02

Current Version: 9

Requests Allowed: HTTP GET / HTTP POST / SOAP 1.1 / SOAP 1.2

 

Summary:

Include description that was added to the API categorization page here.

Where in the clients instance can this be done without the use of the API?

 

Resource/WSDL Page:

http://<your_domain_here>/api/2/reports.asmx?op=ClickExport

 

Parameters

api_key
Required Value
Type: STRING

Admin API key.

Example Values: Obtained from the Setup tab - Permissions sub tab.

start_date
Required Value
Type: DATETIME

Start date for your report

Example Values: MM/DD/YYYY

end_date
Required Value
Type: DATETIME

End date for your report

Example Values: MM/DD/YYYY

affiliate_id
Required Value/Optional?
Type: INT

Limit results to a specific affiliate onlyl

Example Values: 0 returns all affiliates

offer_id
Required Value/Optional?
Type: INT

Limit results to a specific offer only.

Example Values: 0 returns all offers

include_tests
Required Value/Optional?
Type: BOOL

Limit results to non-test clicks only.

Example Values: TRUE, FALSE

 **Note all optional parameters still need to be passed through in the actual call. These parameters do not need a value (therefore you can use a null value). 

 

Example Request

GET

http://demo.cakemarketing.com/api/2/reports.asmx/ClickExport?api_key=dNJFmId9rI&start_date=01/01/2012+12:00:00&end_date=01/01/2012+17:00:00&affiliate_id=4410&offer_id=0&include_tests=TRUE

 

Sample XML Response:

<?xml version="1.0" encoding="utf-8"?>
<ArrayOfClick xmlns="http://cakemarketing.com/api/2/">
  <Click>
    <click_id>int</click_id>
    <visitor_id>int</visitor_id>
    <request_session_id>int</request_session_id>
    <click_date>dateTime</click_date>
    <affiliate_id>int</affiliate_id>
    <affiliate_name>string</affiliate_name>
    <offer_id>int</offer_id>
    <offer_name>string</offer_name>
    <advertiser_id>int</advertiser_id>
    <advertiser_name>string</advertiser_name>
    <campaign_id>int</campaign_id>
    <creative_id>int</creative_id>
    <creative_name>string</creative_name>
    <subid_1>string</subid_1>
    <subid_2>string</subid_2>
    <subid_3>string</subid_3>
    <subid_4>string</subid_4>
    <subid_5>string</subid_5>
    <ip_address>string</ip_address>
    <country>string</country>
    <user_agent>string</user_agent>
    <referrer_url>string</referrer_url>
    <request_url>string</request_url>
    <redirect_url>string</redirect_url>
    <disposition>string</disposition>
    <paid_action>string</paid_action>
    <total_clicks>int</total_clicks>
  </Click>
  <Click>
    <click_id>int</click_id>
    <visitor_id>int</visitor_id>
    <request_session_id>int</request_session_id>
    <click_date>dateTime</click_date>
    <affiliate_id>int</affiliate_id>
    <affiliate_name>string</affiliate_name>
    <offer_id>int</offer_id>
    <offer_name>string</offer_name>
    <advertiser_id>int</advertiser_id>
    <advertiser_name>string</advertiser_name>
    <campaign_id>int</campaign_id>
    <creative_id>int</creative_id>
    <creative_name>string</creative_name>
    <subid_1>string</subid_1>
    <subid_2>string</subid_2>
    <subid_3>string</subid_3>
    <subid_4>string</subid_4>
    <subid_5>string</subid_5>
    <ip_address>string</ip_address>
    <country>string</country>
    <user_agent>string</user_agent>
    <referrer_url>string</referrer_url>
    <request_url>string</request_url>
    <redirect_url>string</redirect_url>
    <disposition>string</disposition>
    <paid_action>string</paid_action>
    <total_clicks>int</total_clicks>
  </Click>
</ArrayOfClick>

 

Example Error Messages: 

Error Message

Likely Cause

List Error message or messages here. Make sure you separate each error per table

What is the likely cause of this error?