Mobile App Integration

To integrate a mobile app with CitrusAd, the integration compared to web is nearly identical! As CitrusAd is backend to backend integrated, your requests for ads will be identical to the requests you send on desktop and mobile web. The only difference is that as apps do not support JS libraries, you will need to make a backend request to our click and impression endpoints. This method of reporting clicks and impressions is advised in a standard integration regardless of desktop, mobile web, or app.

Reporting Impressions

To report an impression you will 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 would be:

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 will 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 would be:

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.