DT FairBid enables you to access detailed information for each impression through the impressions callback APIs. The information includes, for example, which demand source served the ad, the expected or exact revenue associated with it. In addition, it contains granular details to allow you to analyze and, ultimately, optimize both your ad monetization and user acquisition strategies. 

To enrich and elaborate the insights you can get, this information can be called by two different APIs that refers to different stages at the impression lifetime:

• Once the ad is being shown (onShow) - starting from DT FairBid 2.3.0
• Before the ad is being shown, once there is a Fill – an ad available to display (onAvailable) - starting from DT FairBid 3.11.0

Glossary Table

- (void)interstitialDidShow:(nonnull NSString *)placementId impressionData:(nonnull FYBImpressionData *)impressionData;
- (void)interstitialDidFailToShow:(nonnull NSString *)placementId withError:(nonnull NSError *)error impressionData:(nonnull FYBImpressionData *)impressionData;

optional func interstitialDidShow(_ placementId: String, impressionData: FYBImpressionData)
optional func interstitialDidFail(toShow placementId: String, withError error: Error, impressionData: FYBImpressionData)

- (void)rewardedDidShow:(nonnull NSString *)placementId impressionData:(nonnull FYBImpressionData *)impressionData;
- (void)rewardedDidFailToShow:(nonnull NSString *)placementId withError:(nonnull NSError *)error impressionData:(nonnull FYBImpressionData *)impressionData;

optional func rewardedDidShow(_ placementId: String, impressionData: FYBImpressionData)
optional func rewardedDidFail(toShow placementId: String, withError error: Error, impressionData: FYBImpressionData)

- (void)bannerDidShow:(FYBBannerAdView *)banner impressionData:(nonnull FYBImpressionData *)impressionData;

optional func bannerDidShow(_ banner: FYBBannerAdView, impressionData: FYBImpressionData)

- (void)interstitialDidShow:(NSString *)placementId impressionData:(FYBImpressionData *)impressionData
{
    NSLog(@"Placement %@ has been shown with a net payout of %@ %@ with accuracy: %d and impression depth: %i", placementId, impressionData.netPayout, impressionData.currency, impressionData.priceAccuracy, impressionData.impressionDepth);
}

func interstitialDidShow(_ placementId: String, impressionData: FYBImpressionData) {
    let currency = impressionData.currency ?? "(nil)"
    let payout = impressionData.netPayout?.doubleValue ?? 0
    let accuracy = impressionData.priceAccuracy
    let impressionDepth = impressionData.impressionDepth
    print("Placement \(placementId) has been shown with a net payout of \(payout) \(currency) with accuracy: \(accuracy) and impression depth: \(impressionDepth)")
}

Placement 12345 has been shown with a net payout of 4.000000 USD
with accuracy: PREDICTED and impression depth: 1

func interstitialIsAvailable(_ placementId: String) {
    let impressionData = FYBInterstitial.impressionData(placementId)
}
            

func rewardedIsAvailable(_ placementId: String) {
    let impressionData = FYBRewarded.impressionData(placementId)
}
            

Impression Depth

Impression depth represents the amount of impressions in a given session per ad format (Rewarded, Interstitial and Banner).

Impression depth can be directly accessed from each ad format class (access all code snippets here). Alternatively, it can be accessed through the ImpressionLevelData object as shown in the snippets above.

The impression depth for each ad format will keep increasing throughout the session as more ads get displayed.

It is reset only when:

• The session ends (app is killed)
• SDK considers the session has “timed out” 

Session Timeout

Session timeout or “session background timeout” represents the amount of time the user needs to spend with the app in the background before we consider them to be back to user engagement levels similar to a fresh new session. At this point, for all ad formats, the impression depth is reset to 0.

The Session timeout value is 30 minutes by default. 

Snippets

The example below illustrates how you can access the impressionDepth value for all ad formats (Rewarded, Interstitial and Banner),

NSUInteger impressionDepth = FYBRewarded.impressionDepth;

NSUInteger impressionDepth = FYBInterstitial.impressionDepth;

NSUInteger impressionDepth = FYBBanner.impressionDepth;

let impressionDepth = FYBBanner.impressionDepth

let impressionDepth = FYBInterstitial.impressionDepth

let impressionDepth = FYBRewarded.impressionDepth