REPORTS Clicks API Version 5 (DEPRECATED)

Ron Torres

Modified on: Fri, 18 Sep, 2015 at 5:43 PM

REPORTS Clicks API Version 5

Updated on 2014-03-31
Latest Version: Version 7
Deprecated Version: V1, V4, V5, V6
Requests Allowed: GET & SOAP

Summary:

Exports all clicks info filtered by campaign, affiliate offer, advertiser, or creative.

You can also obtain this from within your CAKE instance by going to the Reports main tab then the Clicks sub tab where you are allowed to export.

Resource/WSDL Page:

http://<your_domain_here>/api/5/reports.asmx?op=Clicks

Parameters

api_key
Required
Type: STRING
Length (Max/Min): 50

This api_key will provide you with the ability to export Clicks for your instance. You can obtain this api_key from within CAKE >> Setup >> Permissions in the API Key list.

Example Value:

Fo35NRAqvFLXoZxqB4aViaiYM7iVMhh

start_date
Required
Type: DATETIME
Length (Max/Min): N/A

Report Start Date [MM/DD/YYYY HH:MM:SS]

Example Values: 12/31/2013 15:16:17

end_date
Required
Type: DATETIME
Length (Max/Min): N/A

Report End Date [MM/DD/YYYY HH:MM:SS]

Example Values: 12/31/2013 15:16:17

affiliate_id
Required
Type: INTEGER
Length (Max/Min): N/A

This is the identifier for a unique Affiliate. This can be found on any Affiliate card.

Example Values: 1234

advertiser_id
Required
Type: INTEGER
Length (Max/Min): N/A

This is the identifier for a unique Advertiser. This can be found on any Affiliate card.

Example Values: 1234

offer_id
Required
Type: INTEGER
Length (Max/Min): N/A

This is the identifier for a unique Offer. This can be found on any Offer card.

Example Values: 1234

campaign_id
Required
Type: INTEGER
Length (Max/Min): N/A

This is the identifier for a unique campaign. You can obtain the campaign ID from your CAKE instance on the campaign card. To get there, go to the advertiser tab >> offers >> choose an offer to open the offer card >> campaign tab >> choose a campaign >> ID.

Example Values: 1234

creative_id
Required
Type: INTEGER
Length (Max/Min): N/A

This is the identifier for a unique creative. You can obtain the creative ID from your CAKE instance on the offer card. To get there, go to the advertiser tab >> offers >> choose an offer to open the offer card >> creatives tab >> choose a creative >> ID.

Example Values: 1234

include_tests
Required
Type: BOOL
Length (Max/Min): N/A

The following values can only be used for this parameter (TRUE or FALSE).

Example Values: TRUE

start_at_row
Required
Type: INTEGER
Length (Max/Min): N/A

Must pass at least 0 as value, which means start at the beginning of the data set.

Example Values: 3

row_limit
Required
Type: INTEGER
Length (Max/Min): N/A

Must pass at least 0 as value, which means no limit.

Example Values: 3

**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/5/reports.asmx/Clicks?api_key=dNJFmId9rI&start_date=01/01/2012+12:00:00&end_date=01/02/2012+12:00:00&affiliate_id=4410&advertiser_id=0&offer_id=0&campaign_id=0&creative_id=0&include_tests=TRUE&start_at_row=1&row_limit=5

Sample XML Response:

<click_report_response>
<success>true</success>
<row_count>5</row_count>
<clicks>
    <click>
      <click_id>305777</click_id>
      <visitor_id>1281728</visitor_id>
      <request_session_id>292990</request_session_id>
      <click_date>2012-01-01T12:00:41.25</click_date>
      <affiliate>
        <affiliate_id>4410</affiliate_id>
        <affiliate_name>Affilate 4410</affiliate_name>
      </affiliate>
      <advertiser>
        <advertiser_id>1</advertiser_id>
        <advertiser_name>Rename Advertiser</advertiser_name>
      </advertiser>
      <offer>
        <offer_id>-1</offer_id>
        <offer_name>Offer -1</offer_name>
      </offer>
      <campaign_id>-1</campaign_id>
      <creative>
        <creative_id>326</creative_id>
        <creative_name>326 - Best Creative</creative_name>
      </creative>
      <sub_id_1>594</sub_id_1>
      <sub_id_2>slava021209</sub_id_2>
      <sub_id_3/>
      <sub_id_4/>
      <sub_id_5/>
      <ip_address>192.168.1.1</ip_address>
      <user_agent>Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.1.2) Gecko/20090729 Firefox/3.5.2 GTB6 (.NET CLR 3.5.30729)</user_agent>
      <referrer_url/>
      <request_url>http://caketrk.com/?a=40&c=282&s1=51447</request_url>
      <redirect_url>http://www.cakemarketing.com</redirect_url>
      <country>
        <country_code>CA</country_code>
        <country_name>Canada</country_name>
      </country>
      <disposition>Geotarget Mismatch</disposition>
      <total_clicks>1</total_clicks>
    </click>
    <click>
      <click_id>305807</click_id>
      <visitor_id>1281755</visitor_id>
      <request_session_id>293017</request_session_id>
      <click_date>2012-01-01T12:14:36.667</click_date>
      <affiliate>
        <affiliate_id>4410</affiliate_id>
        <affiliate_name>Affilate 4410</affiliate_name>
      </affiliate>
      <advertiser>
        <advertiser_id>1</advertiser_id>
        <advertiser_name>Rename Advertiser</advertiser_name>
      </advertiser>
      <offer>
        <offer_id>163</offer_id>
        <offer_name>WALMART Gift Card - UK</offer_name>
      </offer>
      <campaign_id>1010</campaign_id>
      <creative>
        <creative_id>326</creative_id>
        <creative_name>326 - Best Creative</creative_name>
      </creative>
      <sub_id_1>1430</sub_id_1>
      <sub_id_2/>
      <sub_id_3/>
      <sub_id_4/>
      <sub_id_5/>
      <ip_address>192.168.1.1</ip_address>
      <user_agent>Mozilla/5.0 (Windows; U; Windows NT 6.0; en-US; rv:1.9.0.16) Gecko/2009120208 Firefox/3.0.16 GTB6 (.NET CLR 3.5.30729)</user_agent>
      <referrer_url/>
      <request_url>http://caketrk.com/?a=40&c=282&s1=51447</request_url>
      <redirect_url>http://www.cakemarketing.com</redirect_url>
      <country>
        <country_code>US</country_code>
        <country_name>United States</country_name>
      </country>
      <disposition/>
      <total_clicks>1</total_clicks>
    </click>
    <click>
      <click_id>305825</click_id>
      <visitor_id>1281771</visitor_id>
      <request_session_id>293034</request_session_id>
      <click_date>2012-01-01T12:24:17.427</click_date>
      <affiliate>
        <affiliate_id>4410</affiliate_id>
        <affiliate_name>Affilate 4410</affiliate_name>
      </affiliate>
      <advertiser>
        <advertiser_id>1</advertiser_id>
        <advertiser_name>Rename Advertiser</advertiser_name>
      </advertiser>
      <offer>
        <offer_id>163</offer_id>
        <offer_name>WALMART Gift Card - UK</offer_name>
      </offer>
      <campaign_id>1010</campaign_id>
      <creative>
        <creative_id>326</creative_id>
        <creative_name>326 - Best Creative</creative_name>
      </creative>
      <sub_id_1>36</sub_id_1>
      <sub_id_2/>
      <sub_id_3/>
      <sub_id_4/>
      <sub_id_5/>
      <ip_address>192.168.1.1</ip_address>
      <user_agent>Mozilla/5.0 (compatible; Yahoo! Slurp/3.0; http://help.yahoo.com/help/us/ysearch/slurp)</user_agent>
      <referrer_url/>
      <request_url>http://caketrk.com/?a=40&c=282&s1=51447</request_url>
      <redirect_url>http://www.cakemarketing.com</redirect_url>
      <country>
        <country_code>US</country_code>
        <country_name>United States</country_name>
      </country>
      <disposition/>
      <total_clicks>1</total_clicks>
    </click>
    <click>
      <click_id>305826</click_id>
      <visitor_id>1281772</visitor_id>
      <request_session_id>293035</request_session_id>
      <click_date>2012-01-01T12:24:17.52</click_date>
      <affiliate>
        <affiliate_id>4410</affiliate_id>
        <affiliate_name>Affilate 4410</affiliate_name>
      </affiliate>
      <advertiser>
        <advertiser_id>1</advertiser_id>
        <advertiser_name>Rename Advertiser</advertiser_name>
      </advertiser>
      <offer>
        <offer_id>163</offer_id>
        <offer_name>WALMART Gift Card - UK</offer_name>
      </offer>
      <campaign_id>1010</campaign_id>
      <creative>
        <creative_id>326</creative_id>
        <creative_name>326 - Best Creative</creative_name>
      </creative>
      <sub_id_1>36</sub_id_1>
      <sub_id_2/>
      <sub_id_3/>
      <sub_id_4/>
      <sub_id_5/>
      <ip_address>192.168.1.1</ip_address>
      <user_agent>Mozilla/5.0 (compatible; Yahoo! Slurp/3.0; http://help.yahoo.com/help/us/ysearch/slurp)</user_agent>
      <referrer_url/>
      <request_url>http://caketrk.com/?a=40&c=282&s1=51447</request_url>
      <redirect_url>http://www.cakemarketing.com</redirect_url>
      <country>
        <country_code>US</country_code>
        <country_name>United States</country_name>
      </country>
      <disposition/>
      <total_clicks>2</total_clicks>
    </click>
    <click>
      <click_id>305902</click_id>
      <visitor_id>1281840</visitor_id>
      <request_session_id>293103</request_session_id>
      <click_date>2012-01-01T13:19:17.313</click_date>
      <affiliate>
        <affiliate_id>4410</affiliate_id>
        <affiliate_name>Affilate 4410</affiliate_name>
      </affiliate>
      <advertiser>
        <advertiser_id>1</advertiser_id>
        <advertiser_name>Rename Advertiser</advertiser_name>
      </advertiser>
      <offer>
        <offer_id>163</offer_id>
        <offer_name>WALMART Gift Card - UK</offer_name>
      </offer>
      <campaign_id>1010</campaign_id>
      <creative>
        <creative_id>326</creative_id>
        <creative_name>326 - Best Creative</creative_name>
      </creative>
      <sub_id_1>2515</sub_id_1>
      <sub_id_2>HM1204</sub_id_2>
      <sub_id_3/>
      <sub_id_4/>
      <sub_id_5/>
      <ip_address>192.168.1.1</ip_address>
      <user_agent>Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 6.1; WOW64; Trident/4.0; GTB6.3; SLCC2; .NET CLR 2.0.50727; .NET CLR 3.5.30729; .NET CLR 3.0.30729; Media Center PC 6.0; InfoPath.2; OfficeLiveConnector.1.4; OfficeLivePatch.1.3)</user_agent>
      <referrer_url/>
      <request_url>http://caketrk.com/?a=40&c=282&s1=51447</request_url>
      <redirect_url>http://www.cakemarketing.com</redirect_url>
      <country>
        <country_code>US</country_code>
        <country_name>United States</country_name>
      </country>
      <disposition/>
      <total_clicks>1</total_clicks>
    </click>
</clicks>
</click_report_response>

Example Error Messages:

Error Message	Likely Cause
Invalid API Key	API Key does not exist or is expired