Create an ad tag waterfall (iOS)

Increase revenue-generating opportunities in your iOS app with an array of ad tags.


Creating an ad tag waterfall helps you to maximize ad revenue by attempting to show a valid ad to your viewers during an ad break. When you create an ad tag waterfall, you assign an array of ad tags to a single ad break. The player displays the ad of the first tag that returns a valid response.

Use the following steps to create an ad tag waterfall:

  1. Define the ad break offset. In the following example, the ad break is a pre-roll ad break.
  2. Pass an array of ad tags to JWAdBreakBuilder(). If the ad tags are valid, JWAdBreakBuilder() builds a JWAdBreak object.
  3. Follow the remaining steps to set up an ad break with VAST or Google IMA ads.

let adBreak = try? JWAdBreakBuilder()
    .offset(.pre)
    .tags([URL(string:"ad-tag-url-1.xml")!,
           URL(string:"ad-tag-url-2.xml")!,
           URL(string:"ad-tag-url-3.xml")!])
    .build()
JWError *error;
JWAdBreakBuilder *builder = [[JWAdBreakBuilder alloc] init];
[builder tags: @[[NSURL URLWithString:@"ad-tag-url-1.xml"],
                 [NSURL URLWithString:@"ad-tag-url-2.xml"],
                 [NSURL URLWithString:@"ad-tag-url-3.xml"]]];
JWAdOffset *offset = [JWAdOffset preroll];
[builder offset: offset];
JWAdBreak *adBreak = [builder buildAndReturnError:&error];