Guida

You can use the Report XML Feed to get the data for your commissions, campaign or trackers. You can customize the data that you request using the details below.

Commission Report

Request URL structure

https://www.bwinpartypartners.it/members/commissionStatsFeed.do?api_key=xxxxxx&api_secret=xxxxxx&groupByOption=xxxx&month=0&year=xxxx&adChannel=0

This request contains:

Parameter Description Required
api_key Your unique access key Yes
api_secret Your secret (used for authentication along with api_key) Yes
  • Security
    To ensure privacy you must use HTTPS for all requests
    You must not share this url with unauthorized partners
  • Query string parameters
    The following table shows the parameters you use in the request
Parameter Description Required Allowed values
groupByOption Option to display data by brand or commission plan Yes BR - By brand
CP - By commission plan
month Month of the year that you want data for Yes 0 - 11 (Jan to Dec)
year Calendar year in four digit format that you want data for Yes Four digit
adChannel The channel the ad is being promoted on - desktop or mobile or both Yes 0 All
1 (Desktop)
2 (Mobile)

Response:

A Commissions Report XML Feed response returns the following keys and values

Key Value
CommissionStats Total commission values aggregated across brands or commission plan
Stats Brand and product wise commission values
Error Error message generated

Error tags and their meaning:

Message Description
No api_key/api_secret entered Authentication has failed as no value was sent in api_key or api_secret parameter
Authentication failed Authentication has failed due to incorrect value being sent in api_key or api_secret parameter
No groupBy option entered No value was sent for groupBy parameter. You need to use BR or CP
Invalid groupBy option The value passed for groupBy parameter is incorrect. You need to use BR or CP
Invalid month The value passed for month parameter is incorrect. You need to use any value from 0-11
Invalid year The value passed for year parameter is incorrect. You need to use a four digit format for the year
Invalid ad channel The value passed for adchannel parameter is incorrect. You need to use 0 - 2
Technical error Our service is unavailable due to maintenance. Please contact support@bwinpartypartners.it or your account manager.
Campaign Report

Request URL structure

https://www.bwinpartypartners.it/members/campaignStatsFeed.do?api_key=xxxxxx&api_secret=xxxxxx&groupByOption=xx&startDate=xxxxxx&endDate=xxxxxx&adChannel=xx

This request contains:

Parameter Description Required
api_key Your unique access key Yes
api_secret Your secret (used for authentication along with api_key) Yes
  • Security
    To ensure privacy you must use HTTPS for all requests
    You must not share this url with unauthorized partners
  • Query string parameters
    The following table shows the parameters you use in the request
Parameter Description Required Allowed values
groupByOption Option to display data by campaign, date or month Yes C - By campaign
D - By date
M - By month
startDate Start date of the duration for which you need data Yes MM/DD/YYYY format
endDate End date of the duration for which you need data Yes MM/DD/YYYY format
adChannel The channel the ad is being promoted on - desktop or mobile or both Yes 0 All
1 (Desktop)
2 (Mobile)

Response:

A Campaign Report XML Feed response returns the following keys and values

Key Value
CampaignStats Total campaign values aggregated across campaign, date or month
Stats Campaign wise values
Error Error message generated

Error tags and their meaning:

Message Description
No api_key/api_secret entered Authentication has failed as no value was sent in api_key or api_secret parameter
Authentication failed Authentication has failed due to incorrect value being sent in api_key or api_secret parameter
No groupBy option entered No value was sent for groupBy parameter. You need to use BR or CP
Invalid groupBy option The value passed for groupBy parameter is incorrect. You need to use C or D or M
No start/end date entered No value was sent for start date or end date parameter. You need to use any value in MM/DD/YYYY format
Invalid start/end date The value passed for start date or end date parameter is incorrect. You need to use any value in MM/DD/YYYY format
Invalid ad channel The value passed for adchannel parameter is incorrect. You need to use 0 - 2
Technical error Our service is unavailable due to maintenance. Please contact support@bwinpartypartners.it or your account manager.
Tracker Report

Request URL structure

https://www.bwinpartypartners.it/members/trackerStatsFeed.do?api_key=xxxx&api_secret=xxxxxx&groupByOption=xx&startDate=xxxxxx&endDate=xxxxxx&adChannel=xx&zoneOption1=xx&zoneOption2=xx&zoneOption3=xx&zoneOption4=xx

This request contains:

Parameter Description Required
api_key Your unique access key Yes
api_secret Your secret (used for authentication along with api_key) Yes
  • Security
    To ensure privacy you must use HTTPS for all requests
    You must not share this url with unauthorized partners
  • Query string parameters
    The following table shows the parameters you use in the request
Parameter Description Required Allowed values
groupByOption Option to display data by tracker, date or month Yes T - By tracker
D - By date
M - By month
startDate Start date of the duration for which you need data Yes MM/DD/YYYY format
endDate End date of the duration for which you need data Yes MM/DD/YYYY format
zoneOption1 Performing trackers No 1 (Performing)
zoneOption2 Promoting trackers No 2 (Performing)
zoneOption3 No activity trackers No 3 ( No activity)
zoneOption4 Inactive trackers No 4 (Inactive)
adChannel The channel the ad is being promoted on - desktop or mobile or both Yes 0 All
1 (Desktop)
2 (Mobile)

Response:

A Tracker Report XML Feed response returns the following keys and values

Key Value
TrackerStats Total values aggregated across all trackers
TrackerData Values aggregated by tracker
Tracker Values for the particular tracker
Error Error message generated

Error tags and their meaning:

Message Description
No api_key/api_secret entered Authentication has failed as no value was sent in api_key or api_secret parameter
Authentication failed Authentication has failed due to incorrect value being sent in api_key or api_secret parameter
No groupBy option entered No value was sent for groupBy parameter. You need to use BR or CP
Invalid groupBy option The value passed for groupBy parameter is incorrect. You need to use BR or CP
No start/end date entered No value was sent for start date or end date parameter. You need to use any value in MM/DD/YYYY format
Invalid start/end date The value passed for start date or end date parameter is incorrect. You need to use any value in MM/DD/YYYY format
Invalid tracker type The value passed in zoneOption1 or zoneOption2 or zoneOption3 or zoneOption4 is invalid. You need to use 1,2,3 and 4
Invalid ad channel The value passed for adchannel parameter is incorrect. You need to use 0 - 2
Technical error Our service is unavailable due to maintenance. Please contact support@bwinpartypartners.it or your account manager.
© 2017 bwin Italia S.R.L. Tutti i diritti riservati. P.I. 05522130961, Via Previati 9 - 20149 Milano - Conc. GAD 15026