REPORTS Clicks API Version 12
Updated on 07-20-2017
Current Version: Version 12
Deprecated Version: V7, V9, v10, v11
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/12/reports.asmx?op=Clicks
Parameters:
|
api_key Required Type: STRING Length (Max/Min): 50 |
Must be a valid API key (existing and NOT expired) Example Values: 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] When the time stamp is excluded 00:00:00 is assumed. Data on end date will not be included. 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. Obtained via EXPORT Affiliates API Example Values: 1234 |
|
advertiser_id Required Type: INTEGER Length (Max/Min): N/A |
This is the identifier for a unique Advertiser. Obtained via EXPORT Advertisers API Example Values: 1234 |
|
offer_id Required Type: INTEGER Length (Max/Min): N/A |
This is the identifier for a unique Offer. Obtained via EXPORT Offers API Example Values: 1234 |
|
campaign_id Required Type: INTEGER Length (Max/Min): N/A |
This is the identifier for a unique campaign. Obtained via EXPORT Campaigns API Example Values: 1234 |
|
creative_id Required Type: INTEGER Length (Max/Min): N/A |
This is the identifier for a unique Creative. Obtained via EXPORT Creatives API Example Values: 1234 |
|
price_format_id Required Type: INTEGER Length (Max/Min): N/A |
Obtained via GET PriceFormats API Version 1. Pass 0 for all Example Values: TRUE |
|
include_tests Required Type: BOOL Length (Max/Min): N/A |
Example Values: True, False |
|
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 |
|
include_duplicates Required Type: BOOLEAN Length (Max/Min): 50 |
Includes all clicks if 'true' **Duplicate click data is only available up to the 1st day of the previous month. Example Values: 'yes' |
**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:
Sample XML Response:
<click_report_response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://cakemarketing.com/api/12/"> <success>true</success> <row_count>1</row_count> <clicks> <click> <click_id>4626602</click_id> <visitor_id>5668290</visitor_id> <tracking_id>1609510</tracking_id> <request_session_id>4923658</request_session_id> !<--Change to support GUID format---> <click_date>2017-06-20T23:38:47.403</click_date> <udid>Device ID1230</udid> <source_affiliate> <source_affiliate_id xmlns="API:id_name_store">-1</source_affiliate_id> <source_affiliate_name xmlns="API:id_name_store">Affiliate -1</source_affiliate_name> </source_affiliate> <brand_advertiser> <brand_advertiser_id xmlns="API:id_name_store">1</brand_advertiser_id> <brand_advertiser_name xmlns="API:id_name_store">CAKE</brand_advertiser_name> </brand_advertiser> <site_offer> <site_offer_id xmlns="API:id_name_store">-1</site_offer_id> <site_offer_name xmlns="API:id_name_store">Offer -1</site_offer_name> </site_offer> <site_offer_contract> <site_offer_contract_id xmlns="API:id_name_store">-1</site_offer_contract_id> <site_offer_contract_name xmlns="API:id_name_store">Offer Contract -1</site_offer_contract_name> </site_offer_contract> <channel> <channel_id>1</channel_id> <channel_name>Affiliate</channel_name> </channel> <campaign> <campaign_id>-1</campaign_id> <campaign_name>My Campaign Name</campaign_name> <campaign_type> <campaign_type_id>1</campaign_type_id> <campaign_type_name>Standard</campaign_type_name> </campaign_type> </campaign> <creative> <creative_id xmlns="API:id_name_store">-1</creative_id> <creative_name xmlns="API:id_name_store">-1</creative_name> </creative> <sub_id_1/> <sub_id_2/> <sub_id_3/> <sub_id_4/> <sub_id_5/> <ip_address>91.230.47.3</ip_address> <user_agent/> <referrer_url/> <search_term/> <request_url>http://192.168.101.140/</request_url> <redirect_url>http://www.amazon.com</redirect_url> <country> <country_code xmlns="API:id_name_store">RU</country_code> <country_name xmlns="API:id_name_store">Russian Federation</country_name> </country> <region> <region_code xmlns="API:id_name_store">MOW</region_code> <region_name xmlns="API:id_name_store">Moskva</region_name> </region> <isp> <isp_id xmlns="API:id_name_store">69255</isp_id> <isp_name xmlns="API:id_name_store">Regionalnaya Kompaniya Svyazi Ltd.</isp_name> </isp> <disposition>Base Tracking Domain Redirect</disposition> <duplicate>false</duplicate> <duplicate_clicks>0</duplicate_clicks> <total_clicks>1</total_clicks> </click> </clicks> </click_report_response>