SVSAdPlacement

@interface SVSAdPlacement : NSObject <NSCoding, NSCopying>

Class used to create instream video ad placement.

  • Initialize a new instance of SVSAdPlacement.

    Declaration

    Objective-C

    - (nonnull instancetype)initWithSiteId:(unsigned long)siteId
                                    pageId:(unsigned long)pageId
                                  formatId:(unsigned long)formatId;

    Parameters

    siteId

    The siteId created on the Smart AdServer manage interface. Create a new site Id for every unique application on your network.

    pageId

    The pageId created on the Smart AdServer manage interface. It is recommanded to create a new page id for every unique screen in your application.

    formatId

    The formatId created on the Smart AdServer manage interface. It is recommanded to create a new format Id for every type of ad you will integrate in your application.

    Return Value

    An initialized instance of SVSAdPlacement.

  • Initialize a new instance of SVSAdPlacement.

    Declaration

    Objective-C

    - (nonnull instancetype)initWithSiteId:(unsigned long)siteId
                                  pageName:(nonnull NSString *)pageName
                                  formatId:(unsigned long)formatId;

    Parameters

    siteId

    The siteId created on the Smart AdServer manage interface. Create a new site Id for every unique application on your network.

    pageName

    The pageName created on the Smart AdServer manage interface. It is recommanded to create a new page name for every unique screen in your application.

    formatId

    The formatId created on the Smart AdServer manage interface. It is recommanded to create a new format Id for every type of ad you will integrate in your application.

    Return Value

    An initialized instance of SVSAdPlacement.

  • Returns an initialized SVSAdPlacement object.

    Declaration

    Objective-C

    + (nonnull instancetype)adPlacementWithSiteId:(unsigned long)siteId
                                           pageId:(unsigned long)pageId
                                         formatId:(unsigned long)formatId;

    Parameters

    siteId

    The siteId created on the Smart AdServer manage interface. Create a new site Id for every unique application on your network.

    pageId

    The pageId created on the Smart AdServer manage interface. It is recommanded to create a new page id for every unique screen in your application.

    formatId

    The formatId created on the Smart AdServer manage interface. It is recommanded to create a new format Id for every type of ad you will integrate in your application.

    Return Value

    An initialized instance of SVSAdPlacement.

  • Returns an initialized SVSAdPlacement object.

    Declaration

    Objective-C

    + (nonnull instancetype)adPlacementWithSiteId:(unsigned long)siteId
                                         pageName:(nonnull NSString *)pageName
                                         formatId:(unsigned long)formatId;

    Parameters

    siteId

    The siteId created on the Smart AdServer manage interface. Create a new site Id for every unique application on your network.

    pageName

    The pageName created on the Smart AdServer manage interface. It is recommanded to create a new page name for every screen in your application.

    formatId

    The formatId created on the Smart AdServer manage interface. It is recommanded to create a new format Id for every type of ad you will integrate in your application.

    Return Value

    An initialized instance of SVSAdPlacement.

  • Returns an initialized SVSAdPlacement object corresponding to a test video ad breaks.

    A test video ad breaks will always deliver and will always be from a specific type. You can use these tests to verify that your integration will work properly with all types of ads.

    Available test video ad breaks are listed in the SVSAdPlacementTest object.

    Warning

    If you set a test placement, make sure to remove it before submitting your application to the App Store.

    Declaration

    Objective-C

    + (nonnull instancetype)adPlacementForTestAd:(SVSAdPlacementTest)type;

    Parameters

    type

    The type of ad breaks you want to get for ad calls.

    Return Value

    An initialized instance of SVSAdPlacement corresponding to a test video ad breaks.

  • A string representing a set of keywords that will be passed to Smart AdServer to receive more relevant advertising.

    Keywords are typically used to target ad campaign insertions at specific user segments. They should be formatted as comma-separated key-value pairs (e.g. gender=female,age=27).

    On the Smart AdServer manage interface, keyword targeting options can be found under the Targeting / Keywords section when managing campaign insertions.

    The global targeting will be used if no targeting is set for a given Ad Break.

    Declaration

    Objective-C

    @property (readwrite, copy, nonatomic, nullable)
        NSString *globalKeywordsTargeting;
  • A string representing a set of keywords that will be passed to Smart AdServer to receive more relevant ads when performing an Ad call for a Preroll Ads.

    If null, the globalKeywordsTargeting will be used.

    Declaration

    Objective-C

    @property (readwrite, copy, nonatomic, nullable)
        NSString *preRollKeywordsTargeting;
  • A string representing a set of keywords that will be passed to Smart AdServer to receive more relevant ads when performing an Ad call for a Midroll Ads.

    If null, the globalKeywordsTargeting will be used.

    Declaration

    Objective-C

    @property (readwrite, copy, nonatomic, nullable)
        NSString *midRollKeywordsTargeting;
  • A string representing a set of keywords that will be passed to Smart AdServer to receive more relevant ads when performing an Ad call for a Postroll Ads.

    If null, the globalKeywordsTargeting will be used.

    Declaration

    Objective-C

    @property (readwrite, copy, nonatomic, nullable)
        NSString *postRollKeywordsTargeting;
  • A Long representing the siteId that should be passed to Smart AdServer to receive advertising.

    Declaration

    Objective-C

    @property (readonly, nonatomic) unsigned long siteId;
  • A Long representing the page id (if page name is not set) that should be passed to Smart AdServer to receive advertising.

    Declaration

    Objective-C

    @property (readonly, nonatomic) unsigned long pageId;
  • A String representing the page name (if page id is not set) that should be passed to Smart AdServer to receive advertising.

    Declaration

    Objective-C

    @property (readonly, nonatomic, nullable) NSString *pageName;
  • A Long representing the format id that should be passed to Smart AdServer to receive instream advertising format.

    Declaration

    Objective-C

    @property (readonly, nonatomic) unsigned long formatId;