Do iOS Get Started all the way until finishing step 35

Step Summary

Add the Initialization code for the SDK
Register all the app UIViewControllers to the SDK
Add the tagged Wrappers, and tagged Buttons using the accessabilityLabel
Note the transition events
Add the testing Single Data
Test everything is working
Change everything to production code
Your app is now prepared for monetization with us.

...

Code Block

language	swift

import UIKit
import R89SDK

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // This is for testing purposes, remove it on prod
        R89SDK.shared.setLogLevel(level: LogLevels.debug)
        // This is for testing purposes, remove it on prod
        R89SDK.shared.setDebug()
  
        addTestingSingleTagData()  /* This is a later step */
        
        R89SDK.shared.initialize(
            publisherId: "TestPublisherID", /* This is for testing purposes, change it on prod */
            appId: "TestAppId", /* This is for testing purposes, change it on prod */
            singleLine: true,
            publisherInitializationEvents: nil)
        return true
    }
}

...

Note
This `appID` is not the same as the Manifest App Id Info.plist `GADApplicationIdentifier`you used in previous steps.

Tagged Wrappers

Tagged Wrappers are the container inside which the ads will show, they are normal UIView wrappers with the accessabilityLabel attribute set. You need to add as many as you can, remember that placing a tagged wrapper does not mean we need to use it.

...

Info
If the specified `accessibilityLabel` is detected found in the `UIView`, an ad will be placed inside it based on inserted into it according to the single tag configuration data.

...

This example demonstrates the automatic display of an interstitial ad during the transition from one screen to another (from InitialScreenViewController to NewsPostDetailScreenViewController).

Primarily the transition needs to be configured via the dashboard, but for testing purposes, it could be configured locally by using SingleTagConfigBuilder.shared instance in your code.

Code Block

import UIKit
import R89SDK

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    ...
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        ...
        addTestingSingleTagData()  /* This is a later step */
        R89SDK.shared.initialize(...)
        return true
    }
    
    func addTestingSingleTagData(){
        // Add a Screen that is a UIViewController, the screenName you can get it by logging this in you code ->
        // in viewDidLoad you can use self.name ->
        // on InitialScreenViewController -> InitialScreenViewController
        // on NewsPostDetailScreenViewController -> NewsPostDetailScreenViewController
        
        let screenBuilder = SingleTagConfigBuilder.shared
            .addAdScreenBuilder(isFragment:false,screenName: "InitialScreenViewController")
        
        /* trigger interstitial when we transition from "InitialScreenViewController" (ScreenBuilder.screenName) TO NewsPostDetailScreenViewController */
        screenBuilder.addInterstitial(eventsToTrackTo: "NewsPostDetailScreenViewController",
                                      eventsToTrackButton: nil)
        ...
    }
    ...
}

...

Primarily the button-press needs to be configured via the dashboard, but for testing purposes, it could be configured locally by using SingleTagConfigBuilder.shared instance in your code.

Code Block

language	swift

import UIKit
import R89SDK
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    ...
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        ...
        addTestingSingleTagData()  /* This is a later step */
        R89SDK.shared.initialize(...)
        return true
    }
    
    func addTestingSingleTagData(){
        let screenBuilder = SingleTagConfigBuilder.shared
            .addAdScreenBuilder(isFragment:false,screenName: "InitialScreenViewController")
        ...
        /* trigger an interstitial when a button with this tag is pressed in "InitialScreenViewControllerj" (ScreenBuilder.screenName) */
        screenBuilder.addInterstitial(eventsToTrackTo: nil,
                                      eventsToTrackButton: "buttonplay_video_trailer_tag")
    }
    ...
}

According to the above configuration, the buttonplay_video_trailer_tag must be specified inside the InitialScreenViewController for the button via the accessibilityLabel parameter.

...

Code Block

language	swift

import UIKit
import R89SDK

class InitialScreenViewController: UIViewController {
    ...
    override func viewDidLoad() {
        super.viewDidLoad()
        isModalInPresentation = true
        R89SDK.shared.registerLifecycle(uiViewController: self)
        // Do any additional setup after loading the view.
    }
    
    // The button's press handler method
    @IBAction func showNewsDetailsplayVideoTrailer(_ sender: UIButton) {
        // This method will be called after the interstitial ad is closed.
        ...
    }
    ...
}

...

Adding testing single tag data

Go back to the UIViewController AppDelegate class where we initialized the code, we are going to test all the transitions, tagged wrappers, and tagged buttons you have placed in the app.

Before the initialization method, we called addTestingSingleTagData() that which uses the SingleTagConfigBuilder to create the testing data needed for debugging the sdkSDK.

More info in → https://refinery89.atlassian.net/wiki/x/EgBWTw

Note
When using the `SingleTagConfigBuilder` you are not going to be able to select the ad units that are for production, they are by default the testing config id in https://refinery89.atlassian.net/wiki/x/EABGTw.

Code Block

wide

breakoutMode	language	language	swift

func addTestingSingleTagData(){

SingleTagConfigBuilder.shared.addAdScreenBuilder(isFragment:false,screenName: "InitialScreenViewController")
    .addBanner(wrapperTag: "banner_tag",
     import UIKit
import R89SDK
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    ...
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        ...
        addTestingSingleTagData()
        R89SDK.shared.initialize(...)
        return true
    }
    ...
    func addTestingSingleTagData(){
    
        // Add a Screen that is a UIViewController, the screenName you can get it by logging this in your code ->
        // in viewDidLoad you can use self.name ->
        // on InitialScreenViewController -> InitialScreenViewController
        // on NewsPostDetailScreenViewController -> NewsPostDetailScreenViewController
        
        let screenBuilder = SingleTagConfigBuilder.shared.addAdScreenBuilder(
            isFragment:false,
            screenName: "InitialScreenViewController")
        
        // Add a banner format to the wrapper with the tag bottom_ad_banner_container
        screenBuilder.addBanner(wrapperTag: "bottom_ad_banner_container",
                                getAllWithTag: false, /* Only the first tagged wrapper in "InitialScreenViewController" with this tag will be used for this banner*/
                                wrapperRelativePositionInside: true, /* the ad will be placed inside of the wrapper */
                                wrapperRelativePositionAfter: false)
        
        /* trigger interstitial when we transition from "InitialScreenViewController" (ScreenBuilder.screenName) TO NewsPostDetailScreenViewController */
        screenBuilder.addInterstitial(eventsToTrackTo: "NewsPostDetailScreenViewController",
                                      eventsToTrackButton: nil)
        
        /* trigger an interstitial when a button with this tag is pressed in "InitialScreenViewController" (ScreenBuilder.screenName) */
         getAllWithTagscreenBuilder.addInterstitial(eventsToTrackTo: truenil,
               wrapperRelativePositionInside: true,                wrapperRelativePositionAfter: false)     .addInterstitial(eventsToTrackTo: nil, eventsToTrackButton: "buttonplay_video_trailer_tag")
    }
.addInterstitial(eventsToTrackTo: "SecondSCreenViewController", eventsToTrackButton: nil)    ...
}

Note

This step is for testing purposes and you are only going to see test ads when using this approach, but this is very helpful to us if you provide this peace of code to tell us where you want to place the ads.

Later when in production, this code have been removed and you have hopefully added flexible tagged wrappers and tagged all the button as possible so we can change your ad slots from the server without the need of updating the app.

Go into production

...

Remove the methods `R89SDK.shared.setDebug()` and `addTestingSingleTagData()` .
Change the App id `GADApplicationIdentifier` in the `info.plist` for the production one.
Change the `appId` and `publisherId` in the initialization method for the production ones.
it’s also recommended to remove `R89SDK.shared.setLogLevel(level: LogLevels.DEBUGdebug)` but not needed.

How does it works?

We monitor your app to determine the active screen at any given moment. For each screen, we maintain a record of events and tags that you have supplied, enabling us to place ads in those tagged views or during specific transitions and events from the record.

...

Version	Old Version 12	New Version Current
Changes made by	Robert Apikyan	Abraham Armas Cordero
Saved on	Feb 21, 2025	Mar 05, 2025

Content Comparison

Versions Compared

Key

Step Summary

Tagged Wrappers

Adding testing single tag data

Go into production

How does it works?