Advertiser Reporting API

Advertiser Reporting API  is used to retrieve the reports for campaigns which you have setup in your Vertoz account. To retrieve the report, the Advertiser has to pass the token along with the request.

1. Generate Unique Token:

 To receive an authorization token, the user has to login with their own user name and password. To generate the unique token the user has to call the following API:

POST: https://api.vertoz.com/reportip/authforpublisher?userName=(Vertoz_registered_email_id)&password=(password)

Request Method: POST

Request Parameters:

Parameters

Is required

Description

Type
UserName

Yes

 Allows the existing users to log in with their user name.

 String
password  Yes  Allows the existing users to log in with their password.

String

Response Parameters:

Parameters

Type

Description

tokenId

String

Generates the tokenId for a particular session.
fullname String  Returns the full name of the logged user.

emailid

String

Returns the email ID of the logged user.

1. Request API:

Method: POST

URL: https://api.vertoz.com/reportip/authforpublisher?userName=vertoz.dsp@vertoz.com&password=abcdXYZ

2. Response in JSON:

{

“message”: “Sucess”,

“tokenId”: “09820911213431880”,

“statusCode”: 200

}

2. Get Report:

Use tokenId  from the above response to generate reports for a specified data range,

GET: https://api.vertoz.com/reportip/advertiserStatsDetail/6?fromDate=2017-11-01&toDate=2017-11-10

Request Method: GET

Request Parameters

Parameters

Is Required

 Description

Type
fromDate

Yes

Represents the start date and includes the records of the from date. The supported format is DD-MM-YYYY.

 String
 toDate

Yes

 Represents the end date and includes the records of the to date. The supported format is DD-MM-YYYY.

String

Response Parameters

Parameter

Type

Description

message

String

Is used to give information about the response.

report

String

Displays the bidder report.

statusCode

int

Displays the status code of the request.

Example:

 1. Request API:

Method: GET

URL: https://api.vertoz.com/reportip/advertiserStatsDetail/6?fromDate=2017-11-01&toDate=2017-11-10

2. Response in CSV:

reportdate,total_spend,total_imprsn,clicks,campaignBudget
2017-11-01,13.633350000000627,54446,0,400.0
2017-11-02,14.359930000000132,58281,0,400.0
2017-11-03,2.542379999999918,12628,0,400.0
2017-11-04,1.417970000000028,7085,0,400.0

Parameter

Type

Description

reportdate

String

Represents the report date.

total_spend

String

Displays the total spend of all the campaigns as per the reportdate.

total_imprsn

int

Displays the total number of impressions as per the reportdate.

clicks

double

Displays the total number of clicks as per the reportdate.

icampaignBudget

double

Displays the budget set during the creation of the campaign.