{"id":21762035,"url":"https://github.com/segment-integrations/analytics-ios-integration-nielsen-dtvr","last_synced_at":"2025-03-21T04:41:33.168Z","repository":{"id":50958287,"uuid":"188468291","full_name":"segment-integrations/analytics-ios-integration-nielsen-dtvr","owner":"segment-integrations","description":"The Nielsen DTVR analytics-ios integration. ","archived":false,"fork":false,"pushed_at":"2021-05-26T18:59:27.000Z","size":108,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-02-28T22:50:40.644Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/segment-integrations.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-05-24T18:17:05.000Z","updated_at":"2021-05-26T18:59:27.000Z","dependencies_parsed_at":"2022-09-09T23:40:59.119Z","dependency_job_id":null,"html_url":"https://github.com/segment-integrations/analytics-ios-integration-nielsen-dtvr","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/segment-integrations%2Fanalytics-ios-integration-nielsen-dtvr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/segment-integrations%2Fanalytics-ios-integration-nielsen-dtvr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/segment-integrations%2Fanalytics-ios-integration-nielsen-dtvr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/segment-integrations%2Fanalytics-ios-integration-nielsen-dtvr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/segment-integrations","download_url":"https://codeload.github.com/segment-integrations/analytics-ios-integration-nielsen-dtvr/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244739944,"owners_count":20501990,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-26T12:10:42.731Z","updated_at":"2025-03-21T04:41:33.147Z","avatar_url":"https://github.com/segment-integrations.png","language":"Objective-C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Segment Nielsen DTVR Integration\n\n## Installation\n\nThe Nielsen App SDK as of version 6.0.0.0 is compatible with iOS 8.0 and above.\n\nThe Segment-Nielsen DTVR SDK is not available through [CocoaPods](http://cocoapods.org) trunk due to Nielsen's SDK being in a private spec repo. To install the Segment-Nielsen-DTVR pod, add the following line to your Podfile:\n\n```ruby\npod \"Segment-Nielsen-DTVR\", :git =\u003e 'https://github.com/segment-integrations/analytics-ios-integration-nielsen-dtvr.git', :tag =\u003e '1.0.2'\n```\n\nThe integration relies on the Nielsen App SDK framework, which can either be installed via CocoaPods or by manually adding the framework.\nYou will need to have a Nielsen representative before getting started.\n\n## Xcode 12\n\nThe Nielsen Cocoapod (8.0.0.0) specifies iOS 8.0 as its minimum target.  This has the negative effect of generating ones Cocoapod workspace with invalid values.  To fix this, the following script can be added to the end of the `Podfile`:\n\n```\npost_install do |installer|\n  installer.pods_project.targets.each do |target|\n    target.build_configurations.each do |config|\n      config.build_settings.delete 'IPHONEOS_DEPLOYMENT_TARGET'\n    end\n  end\nend\n```\n\nThis will remove the deployment target settings and fall back to what has been specified within the Xcode Project itself.\n\nIt should also be noted that the Nielsen Cocoapod does not include an `arm64` slice.  It may be necessary for  `EXCLUDED_ARCHS[sdk=iphonesimulator*]` to be set to exclude `arm64` in your project.\n\n### CocoaPods\n\nWhen using the Nielsen SDK version 6.2.0.0 and above, Nielsen recommends installation via CocoaPods, and Apple recommends using the dynamic framework.\n\nRequirements for CocoaPods:\nDynamic Framework - version 1.6.1 or higher\nStatic Framework - version 1.4.0 or higher\n\n1. Set repository credentials\nThe 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\n```\ncd ~/\nvi .netrc\n```\n\nAdd the credentials in the following format:\n```\nmachine raw.githubusercontent.com\nlogin \u003cNielsen App SDK client\u003e\npassword \u003cAuth token\u003e\n```\n\nYou 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](https://engineeringportal.nielsen.com/docs/Special:Downloads)\n\n2. Add the source to your Podfile:\n\n  Dynamic Framework (Note: you will need to include `use_frameworks!`)\n```\nsource 'https://github.com/NielsenDigitalSDK/nielsenappsdk-ios-specs-dynamic.git'\n```\nStatic Framework\n```\nsource 'https://github.com/NielsenDigitalSDK/nielsenappsdk-ios-specs.git'\n```\n\n3. Add the pod to your Podfile:\n\n`pod NielsenAppSDK`\n\nThere are several other pods available, and can be found in the [Nielsen Digital Measurement iOS Artifactory Guide](https://engineeringportal.nielsen.com/docs/Digital_Measurement_iOS_Artifactory_Guide)\n\n4. Install pods\n\n`pod install`\n\nThe full instructions from Nielsen can be found [here](https://engineeringportal.nielsen.com/docs/Digital_Measurement_iOS_Artifactory_Guide)\n\n### Manual\n\nNavigate to the [Nielsen Downloads](https://engineeringportal.nielsen.com/docs/Special:Downloads) page to download the iOS SDK.\nYou will need to fill out a license agreement form and have the contact information for your Nielsen representative ready.\n\nOnce extracted, add the static NielsenAppApi.framework to the project and ensure it's in the `Frameworks` folder, and that it is linked.\n\nNielsen also requires the following frameworks, which must be included into Link Binary with Libraries (within app target’s Build Phases) - NOTE - if using the dynamic framework, these will dynamically be linked and there is no need to manually link these.\n  - AdSupport.framework\n  - SystemConfiguration.framework\n  - CoreLocation.framework (Not applicable for International (Germany))\n  - libsqlite3\n\n## Usage\n\nRegister the factory with the Segment SDK in the `application:didFinishLaunchingWithOptions` method of your `AppDelegate`:\n\n`#import \u003cSegment-Nielsen-DTVR/SEGNielsenDTVRIntegrationFactory.h\u003e`\n\n```\nNSString *const SEGMENT_WRITE_KEY = @\" ... \";\nSEGAnalyticsConfiguration *config = [SEGAnalyticsConfiguration configurationWithWriteKey:SEGMENT_WRITE_KEY];\n\n[config use:[SEGNielsenDTVRIntegrationFactory instance]];\n\n[SEGAnalytics setupWithConfiguration:config];\n```\n\n## Sample\n\nSee the example application under `Example/` for a demonstration of integration with the Nielsen App SDK and Segment-Nielsen DTVR Integration with a sample custom video player.\n\n## License\n\nSegment-Nielsen DTVR is available under the MIT license. See the LICENSE file for more info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsegment-integrations%2Fanalytics-ios-integration-nielsen-dtvr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsegment-integrations%2Fanalytics-ios-integration-nielsen-dtvr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsegment-integrations%2Fanalytics-ios-integration-nielsen-dtvr/lists"}