ATAdLoadingDelegate

For details about the extra parameter in some delegate methods, you can click here to view.

About the explanation of Ad Source and Ad Placement:

A single Ad Placement can be configured with multiple Ad Sources. Therefore, a single load operation may receive multiple Ad Source callbacks. The event indicating that all Ad Sources have finished loading is received through the Ad Placement callbacks didFinishLoadingADWithPlacementID: or didFailToLoadADWithPlacementID:error:.

Copy

@protocol ATAdLoadingDelegate<NSObject>

 
/// Callback when the ad loads successfully
/// - Parameter placementID: Ad Placement ID
- (void)didFinishLoadingADWithPlacementID:(NSString *)placementID;

/// Callback when the ad load fails
/// - Parameter placementID: Ad Placement ID
/// - Parameter error: Object containing error information
- (void)didFailToLoadADWithPlacementID:(NSString*)placementID
                                 error:(NSError*)error;

@optional

/// Received impression revenue
/// - Parameters:
///   - placementID: Ad Placement ID
///   - extra: Extra parameters, used for the developer to receive information
- (void)didRevenueForPlacementID:(NSString *)placementID
                              extra:(NSDictionary *)extra;

/// Callback for when a specific Ad Source within the Ad Placement starts loading an ad
/// - Parameter placementID: Ad Placement ID
/// - Parameter extra: Specific information about the Ad Source
- (void)didStartLoadingADSourceWithPlacementID:(NSString *)placementID
                                         extra:(NSDictionary*)extra;
/// Callback for when a specific Ad Source within the Ad Placement loads an ad successfully
/// - Parameter placementID: Ad Placement ID
/// - Parameter extra: Specific information about the Ad Source
- (void)didFinishLoadingADSourceWithPlacementID:(NSString *)placementID
                                          extra:(NSDictionary*)extra;

/// Callback for when a specific Ad Source within the Ad Placement fails to load an ad
/// - Parameter placementID: Ad Placement ID
/// - Parameter extra: Specific information about the Ad Source
/// - Parameter error: Object containing error information
- (void)didFailToLoadADSourceWithPlacementID:(NSString*)placementID
                                       extra:(NSDictionary*)extra
                                       error:(NSError*)error;

/// Callback for when a specific bidding Ad Source within the Ad Placement starts bidding
/// - Parameter placementID: Ad Placement ID
/// - Parameter extra: Specific information about the Ad Source
- (void)didStartBiddingADSourceWithPlacementID:(NSString *)placementID
                                         extra:(NSDictionary*)extra;

/// Callback for when a specific bidding Ad Source within the Ad Placement bids successfully
/// - Parameter placementID: Ad Placement ID
/// - Parameter extra: Specific information about the Ad Source
- (void)didFinishBiddingADSourceWithPlacementID:(NSString *)placementID
                                          extra:(NSDictionary*)extra;

/// Callback for when a specific bidding Ad Source within the Ad Placement's bidding fails
/// - Parameter placementID: Ad Placement ID
/// - Parameter extra: Specific information about the Ad Source
/// - Parameter error: Object containing error information
- (void)didFailBiddingADSourceWithPlacementID:(NSString*)placementID
                                        extra:(NSDictionary*)extra
                                        error:(NSError*)error;

@end

ATAdAdapter

ATBannerDelegate

Last modified: 2026-07-08Powered by

Outline