Reporting impressions & clicks

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.