GoogleInteractiveMediaAds Framework Reference

  • IMAAd is a data object representing a single ad.

  • It provides properties like ad ID, title, description, duration, and dimensions from the VAST response.

  • The object includes information about companion ads, UI elements, and ad podding properties.

  • It also indicates whether the ad is linear or non-linear and if it is skippable, along with the skip time offset.

  • Properties related to trafficking parameters, creative details, universal ad IDs, advertiser name, survey URL, deal ID, and wrapper ad information are available.

IMAAd

@interface IMAAd : NSObject

Data object representing a single ad.

  • The ad ID as specified in the VAST response.

    Declaration

    Swift

    var adId: String { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSString *_Nonnull adId;

  • The ad title from the VAST response.

    Declaration

    Swift

    var adTitle: String { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSString *_Nonnull adTitle;

  • The ad description.

    Declaration

    Swift

    var adDescription: String { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSString *_Nonnull adDescription;

  • The source ad server information included in the ad response.

    Declaration

    Swift

    var adSystem: String { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSString *_Nonnull adSystem;

  • The companion ads specified in the VAST response when using DAI. Empty for client-side ads.

    Declaration

    Swift

    var companionAds: [IMACompanionAd] { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSArray<IMACompanionAd *> *_Nonnull companionAds;

  • Content type of the currently selected creative. For linear creatives returns the content type of the currently selected media file. Returns empty string if no creative or media file is selected on this ad.

    Declaration

    Swift

    var contentType: String { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSString *_Nonnull contentType;

  • The duration of the ad from the VAST response.

    Declaration

    Swift

    var duration: TimeInterval { get }

    Objective-C

    @property (nonatomic, readonly) NSTimeInterval duration;

  • The UI elements that will be displayed during ad playback.

    Declaration

    Swift

    var uiElements: [NSNumber] { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSArray<NSNumber *> *_Nonnull uiElements;

  • The width of the ad asset. For non-linear ads, this is the actual width of the ad representation. For linear ads, since they scale seamlessly, we currently return 0 for width.

    Declaration

    Swift

    var width: Int { get }

    Objective-C

    @property (nonatomic, readonly) NSInteger width;

  • The height of the ad asset. For non-linear ads, this is the actual height of the ad representation. For linear ads, since they scale seamlessly, we currently return 0 for height.

    Declaration

    Swift

    var height: Int { get }

    Objective-C

    @property (nonatomic, readonly) NSInteger height;

  • The width of the selected creative as specified in the VAST response.

    Declaration

    Swift

    var vastMediaWidth: Int { get }

    Objective-C

    @property (nonatomic, readonly) NSInteger VASTMediaWidth;

  • The height of the selected creative as specified in the VAST response.

    Declaration

    Swift

    var vastMediaHeight: Int { get }

    Objective-C

    @property (nonatomic, readonly) NSInteger VASTMediaHeight;

  • The bitrate of the selected creative as specified in the VAST response.

    Declaration

    Swift

    var vastMediaBitrate: Int { get }

    Objective-C

    @property (nonatomic, readonly) NSInteger VASTMediaBitrate;

  • Specifies whether the ad is linear or non-linear.

    Declaration

    Swift

    var isLinear: Bool { get }

    Objective-C

    @property (nonatomic, readonly, getter=isLinear) BOOL linear;

  • Specifies whether the ad is skippable.

    Declaration

    Swift

    var isSkippable: Bool { get }

    Objective-C

    @property (nonatomic, readonly, getter=isSkippable) BOOL skippable;

  • The number of seconds of playback before the ad becomes skippable. -1 is returned for non skippable ads or if this is unavailable.

    Declaration

    Swift

    var skipTimeOffset: TimeInterval { get }

    Objective-C

    @property (nonatomic, readonly) NSTimeInterval skipTimeOffset;

  • Set of ad podding properties.

    Declaration

    Swift

    var adPodInfo: IMAAdPodInfo { get }

    Objective-C

    @property (nonatomic, readonly) IMAAdPodInfo *_Nonnull adPodInfo;

  • String representing custom trafficking parameters from the VAST response.

    Declaration

    Swift

    var traffickingParameters: String { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSString *_Nonnull traffickingParameters;

  • Returns the ID of the selected creative for the ad.

    Declaration

    Swift

    var creativeID: String { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSString *_Nonnull creativeID;

  • Returns the ISCI (Industry Standard Commercial Identifier) code for an ad. This is the Ad-ID of the selected creative in the VAST response.

    Declaration

    Swift

    var creativeAdID: String { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSString *_Nonnull creativeAdID;

  • The list of all UniversalAdIds of the selected creative for this ad. Returns an empty array if no universal ad IDs are found.

    Declaration

    Swift

    var universalAdIDs: [IMAUniversalAdID] { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSArray<IMAUniversalAdID *> *_Nonnull universalAdIDs;

  • Deprecated

    Use universalAdIDs instead.

    The UniversalAdId of the selected creative for the ad. Returns the id value or “unknown” if unavailable.

    Declaration

    Swift

    var universalAdIdValue: String { get }

    Objective-C

    @property (nonatomic, copy, readonly) DEPRECATED_MSG_ATTRIBUTE NSString *universalAdIdValue;

  • Deprecated

    Use universalAdIDs instead.

    The registry associated with cataloging the UniversalAdId of the selected creative for the ad. Returns the registry value, or “unknown” if unavailable.

    Declaration

    Swift

    var universalAdIdRegistry: String { get }

    Objective-C

    @property (nonatomic, copy, readonly) DEPRECATED_MSG_ATTRIBUTE NSString *universalAdIdRegistry;

  • The advertiser name as defined by the serving party.

    Declaration

    Swift

    var advertiserName: String { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSString *_Nonnull advertiserName;

  • Returns the URL associated with the survey for the given ad.

    Declaration

    Swift

    var surveyURL: String? { get }

    Objective-C

    @property (nonatomic, copy, readonly, nullable) NSString *surveyURL;

  • Returns the first deal ID present in the wrapper chain for the current ad, starting from the top.

    Declaration

    Swift

    var dealID: String { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSString *_Nonnull dealID;

  • The IDs of the ads, starting with the first wrapper ad.

    Declaration

    Swift

    var wrapperAdIDs: [String] { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSArray<NSString *> *_Nonnull wrapperAdIDs;

  • The IDs of the ads’ creatives, starting with the first wrapper ad.

    Declaration

    Swift

    var wrapperCreativeIDs: [String] { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSArray<NSString *> *_Nonnull wrapperCreativeIDs;

  • Ad systems used for wrapper ads. The ad systems returned begin with the first wrapper ad and continue to each wrapper ad recursively.

    Declaration

    Swift

    var wrapperSystems: [String] { get }

    Objective-C

    @property (nonatomic, copy, readonly) NSArray<NSString *> *_Nonnull wrapperSystems;