Segment-Nielsen-DCR 1.3.3

Segment-Nielsen-DCR 1.3.3

Maintained by Ladan Azita Nasserian, Segment, Brennan Gamwell, Prateek Srivastava, Brienne McNally, Aimee Menne.



Segment-Nielsen-DCR

Circle CI Version License Platform

Installation

The Nielsen App SDK as of version 6.0.0.0 is compatible with Apple iOS version 8.0 and above.

Segment-Nielsen-DCR SDK is available through CocoaPods. To install it, add the following line to your Podfile:

pod "Segment-Nielsen-DCR"

The integration relies on the the Nielsen framework, which can either be installed via Cocoapods or by manually adding the framework. You will need to have a Nielsen representative to get started.

Cocoapods

When using the Nielsen SDK version 6.2.0.0 and above, Nielsen recommends installation via Cocoapods, and Apple recommends using the dynamic framework.

Installation of the Dynamic Nielsen App Framework SDK via Cocoapods requires a Cocoapods version 1.6.1 or higher. Installation of the Static Nielsen App Framework SDK via Cocoapods requires a Cocoapods version 1.4.0 or higher.

  1. Set your repository credentials. The first step is to add the credentials received from Nielsen into your .netrc file. Navigate to your home folder and create a file called .netrc
cd ~/
vi .netrc

You will need to fill out a license agreement form and have the contact information for your Nielsen representative in order to obtain the credentials here. Add the credentials in the following format:

machine raw.githubusercontent.com
login <Nielsen App SDK client>
password <Auth token>
  1. Add the source to your Podfile

Dynamic Framework (Note: you will need to include use_frameworks!)

source 'https://github.com/NielsenDigitalSDK/nielsenappsdk-ios-specs-dynamic.git'

Static Framework

source 'https://github.com/NielsenDigitalSDK/nielsenappsdk-ios-specs.git'
  1. Add the pod to your Podfile

pod NielsenAppSDK

  1. Install the pods

pod install

A list of full instructions can be found here

Manual

Navigate to Nielsen's Engineering Site and download the following Video framework:

There will be an NDA to sign prior to accessing the download. Nielsen requires you fill out your company info and have a Nielsen representative before getting started.

Nielsen also requires the following frameworks, which must be included into Link Binary with Libraries (within app target’s Build Phases)

  • AdSupport.framework
  • SystemConfiguration.framework
  • CoreLocation.framework (Not applicable for International (Germany))
  • libsqlite3

Usage

After you have properly installed the Nielsen App SDK, Register the factory with Segment SDK in the application:didFinishLaunchingWithOptions method of your AppDelegate:

#import <Segment-Nielsen-DCR/SEGNielsenDCRIntegrationFactory.h>

NSString *const SEGMENT_WRITE_KEY = @" ... ";
SEGAnalyticsConfiguration *config = [SEGAnalyticsConfiguration configurationWithWriteKey:SEGMENT_WRITE_KEY];

[config use:[SEGNielsenDCRIntegrationFactory instance]];

[SEGAnalytics setupWithConfiguration:config];

License

Segment-Nielsen-DCR is available under the MIT license. See the LICENSE file for more info.