The recommended way of reporting impressions and clicks is directly to CitrusAd's /resource/
endpoint. Impressions are reported to the first-i
resource, and clicks are reported to the second-c
resource.
Before you are able to report impressions and clicks, you will need to get your Base URL from your Technical Account Manager.
Calling endpoints should occur within the app or website.
With CitrusAd, the integration of a mobile app is almost identical to the integration of a website. As CitrusAd is integrated 'backend to backend', your ad requests will be identical to the requests you send on desktop and mobile. As apps do not support JS libraries, you will need to make a backend request to our click and impression endpoints.
Reporting impressions
To report an impression, you need to send a GET request in the format below:
https://$BASE_URL.citrusad.com/v1/resource/first-i/AD_ID
The AD_ID
will be the adId
returned to you with the ad you are reporting an impression for. An example GET request will look like the below:
https://$BASE_URL.citrusad.com/v1/resource/first-i/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
In the above, display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
is the adId
you are reporting an impression for.
Reporting clicks
To report a click, you need to send a GET request in the format below:
https://$BASE_URL.citrusad.com/v1/resource/second-c/AD_ID
The AD_ID
will be the adId
returned to you with the ad you are reporting a click for. An example GET request will look like the below:
https://$BASE_URL.citrusad.com/v1/resource/second-c/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
In the above, display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
is the adId
you are reporting a click for.