Nielsen DCR Module for AMP iOS

Ease of integration and Nielsen certification is this module’s goal, as well as reducing boilerplate code to achieve the integration.

Installation

Just import the AmpNielsenDCR.framework in your project. For more information check out the AmpCore’s documentation.

*Note: Make sure to add the frameworks as Embedded Binaries or you’ll get an error about a missing image. *

How to Use

Let’s first import the required frameworks:

import AmpCore
import AmpNielsenDCR

Then, let’s add the related variables in our UIViewController:

    var ampPlayer: AmpPlayer!
    var ampNielsen:AmpNielsenDCRManager!

And it’s time to instantiate them now, in your viewDidLoad function:

    // Instantiate player

    self.ampPlayer = AmpPlayer(parentView: self.view)
    self.ampPlayer.autoplay = true
    self.ampPlayer.setLicense(license)

    // Register yourself as an observer if required
    self.ampPlayer.registerObserver(self)

    // Instantiate the Nielsen Manager
    self.ampNielsen = AmpNielsenDCRManager(player: self.ampPlayer)

    // Afterwards, let's ask our `ampPlayer` to handle our stream
    self.ampPlayer.handleUrl(url)

IF you want to show a WebView with the Nielsen’s opt-out URL, you can add the following code:

    @IBAction func showOptOutWebsite(sender: AnyObject) {
        // Assuming we have a view controller, with an identifier of `webView`, and named `WebViewController`
        let webView = self.storyboard?.instantiateViewControllerWithIdentifier("webView") as! WebViewController
        // We assign the view controller's properties
        webView.url = self.ampNielsen.getOptOutURL()
        webView.nielsen = self.ampNielsen
        // Pause the player while we present the view controller
        self.ampPlayer.pause()
        // Present the view controller,
        self.presentViewController(webView, animated: true, completion: nil)
    }

Now, for reference, see an example of a WebViewController:

import UIKit
import AmpNielsenDCR

public class WebViewController: UIViewController, UIWebViewDelegate {

    public var url:String?
    public var nielsen:AmpNielsenDCRManager?

    @IBOutlet weak var webView: UIWebView!

    override public func viewDidLoad() {
        let nURL = NSURL(string: url!)
        let request = NSURLRequest(URL: nURL!)
        self.webView.scalesPageToFit = true
        self.webView.delegate = self
        self.webView.loadRequest(request)
    }

    public override func viewDidAppear(animated: Bool) {
        self.webView.center = self.view.center
    }

    @IBAction func close(sender: AnyObject) {
        self.dismissViewControllerAnimated(true, completion: nil)
    }

    // MARK: Web View Delegate

    public func webView(webView: UIWebView, shouldStartLoadWithRequest request: NSURLRequest, navigationType: UIWebViewNavigationType) -> Bool {
        let command:String = "\(request.URL!)"

        if command == kNielsenWebClose {
            self.dismissViewControllerAnimated(true, completion: nil)
            return false
        }

        if let nielsenDCR = self.nielsen {
            return !nielsenDCR.userOptOut(command)
        }else {
            return false
        }
    }
}

And that’s basically it, with just those few steps, you have a working integration between AMP and Nielsen DCR.

Need help?

If you need help trying to integrate the player on your project, or you want to report issues or problems you can send a email to amp-sdk-support@akamai.com