GoogleInteractiveMediaAds Framework Reference

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 (readonly, copy, nonatomic) NSString *adId;
  • The ad title from the VAST response.

    Declaration

    Swift

    var adTitle: String! { get }

    Objective-C

    @property (readonly, copy, nonatomic) NSString *adTitle;
  • The ad description.

    Declaration

    Swift

    var adDescription: String! { get }

    Objective-C

    @property (readonly, copy, nonatomic) NSString *adDescription;
  • The source ad server information included in the ad response.

    Declaration

    Swift

    var adSystem: String! { get }

    Objective-C

    @property (readonly, copy, nonatomic) NSString *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 (readonly, copy, nonatomic) NSArray<IMACompanionAd *> *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 (readonly, copy, nonatomic) NSString *contentType;
  • The duration of the ad from the VAST response.

    Declaration

    Swift

    var duration: TimeInterval { get }

    Objective-C

    @property (readonly, nonatomic) NSTimeInterval duration;
  • The UI elements that will be displayed during ad playback.

    Declaration

    Swift

    var uiElements: [NSNumber]! { get }

    Objective-C

    @property (readonly, copy, nonatomic) NSArray<NSNumber *> *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 (readonly, nonatomic) 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 (readonly, nonatomic) NSInteger height;
  • The width of the selected creative as specified in the VAST response.

    Declaration

    Swift

    var vastMediaWidth: Int { get }

    Objective-C

    @property (readonly, nonatomic) NSInteger VASTMediaWidth;
  • The height of the selected creative as specified in the VAST response.

    Declaration

    Swift

    var vastMediaHeight: Int { get }

    Objective-C

    @property (readonly, nonatomic) NSInteger VASTMediaHeight;
  • The bitrate of the selected creative as specified in the VAST response.

    Declaration

    Swift

    var vastMediaBitrate: Int { get }

    Objective-C

    @property (readonly, nonatomic) NSInteger VASTMediaBitrate;
  • Specifies whether the ad is linear or non-linear.

    Declaration

    Swift

    var isLinear: Bool { get }

    Objective-C

    @property (readonly, getter=isLinear, nonatomic) BOOL linear;
  • Specifies whether the ad is skippable.

    Declaration

    Swift

    var isSkippable: Bool { get }

    Objective-C

    @property (readonly, getter=isSkippable, nonatomic) 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 (readonly, nonatomic) NSTimeInterval skipTimeOffset;
  • Set of ad podding properties.

    Declaration

    Swift

    var adPodInfo: IMAAdPodInfo! { get }

    Objective-C

    @property (readonly, strong, nonatomic) IMAAdPodInfo *adPodInfo;
  • String representing custom trafficking parameters from the VAST response.

    Declaration

    Swift

    var traffickingParameters: String! { get }

    Objective-C

    @property (readonly, copy, nonatomic) NSString *traffickingParameters;
  • Returns the ID of the selected creative for the ad.

    Declaration

    Swift

    var creativeID: String! { get }

    Objective-C

    @property (readonly, copy, nonatomic) NSString *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 (readonly, copy, nonatomic) NSString *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 (readonly, copy, nonatomic)
        NSArray<IMAUniversalAdID *> *universalAdIDs;
  • 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 (readonly, copy, nonatomic) NSString *universalAdIdValue;
  • 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 (readonly, copy, nonatomic) NSString *universalAdIdRegistry;
  • The advertiser name as defined by the serving party.

    Declaration

    Swift

    var advertiserName: String! { get }

    Objective-C

    @property (readonly, copy, nonatomic) NSString *advertiserName;
  • Returns the URL associated with the survey for the given ad.

    Declaration

    Swift

    var surveyURL: String! { get }

    Objective-C

    @property (readonly, copy, nonatomic) 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 (readonly, copy, nonatomic) NSString *dealID;
  • The IDs of the ads, starting with the first wrapper ad.

    Declaration

    Swift

    var wrapperAdIDs: [String]! { get }

    Objective-C

    @property (readonly, copy, nonatomic) NSArray<NSString *> *wrapperAdIDs;
  • The IDs of the ads’ creatives, starting with the first wrapper ad.

    Declaration

    Swift

    var wrapperCreativeIDs: [String]! { get }

    Objective-C

    @property (readonly, copy, nonatomic) NSArray<NSString *> *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 (readonly, copy, nonatomic) NSArray<NSString *> *wrapperSystems;