Nielsen Digital Ad Ratings

Nielsen Digital Ad Ratings provides comprehensive measurement and analytics for digital advertising campaigns, offering detailed insights into ad performance, audience reach, and campaign effectiveness across various digital platforms and devices.

Power end-to-end data operations for your Nielsen Digital Ad Ratings API with Nexla. Our bi-directional Nielsen Digital Ad Ratings connector is purpose-built for Nielsen Digital Ad Ratings, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Nielsen Digital Ad Ratings or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Nielsen Digital Ad Ratings workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

• Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
• Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
• API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
• Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Before creating a Nielsen Digital Ad Ratings credential, you need to obtain your OAuth2 Client ID, Client Secret, Username, and Password from your Nielsen Digital Ad Ratings account. Nielsen Digital Ad Ratings uses OAuth2 2-legged authentication for all API requests.

To obtain your Nielsen Digital Ad Ratings OAuth2 credentials, follow these steps:

1. Sign in to your Nielsen Digital Ad Ratings account using your administrator credentials, or contact your Nielsen account representative to set up API access.

2. Navigate to your account settings or API management section in the Nielsen Digital Ad Ratings portal.

3. Look for the API Credentials or OAuth2 section in your account settings.

4. If you don't have OAuth2 credentials yet, click Create Client or Generate Credentials to create a new OAuth2 client application.

5. Configure your OAuth2 client settings:

   • Enter a name or description for the client (e.g., "Nexla Integration")
   • Review and select the permissions or scopes for the client

6. Click Create or Generate to create the OAuth2 client.

7. After the OAuth2 client is created, you will see the Client ID and Client Secret. Copy these values immediately.

8. Identify your Username and Password. These are your Nielsen Digital Ad Ratings account credentials that will be used for OAuth2 authentication.

9. Store all credentials securely, as you will need them to configure your Nexla credential. The Client Secret and Password are sensitive information and should be kept confidential.

The OAuth2 credentials are used to obtain access tokens for API requests to the Nielsen Digital Ad Ratings API. The Client ID and Client Secret are used in the OAuth2 token exchange, and the Username and Password are used for authentication. OAuth2 uses 2-legged authentication, which means the token exchange happens directly without user authorization. If your credentials are compromised, you should immediately revoke them in your Nielsen Digital Ad Ratings account settings and generate new ones. For detailed information about OAuth2 authentication, available endpoints, and API access, refer to the Nielsen Digital Ad Ratings API documentation.

Authenticate

Credentials required

Field	Required	Secret	Description
Client ID	Yes	No	Nielsen Digital Ad Ratings Client ID
Client Secret	Yes	Yes	Nielsen Digital Ad Ratings Client Secret
Username	Yes	No	Username
Password	Yes	No	Password

Create a credential in Nexla

1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Nielsen Digital Ad Ratings

2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

3. Enter your Nielsen Digital Ad Ratings Client ID in the Client ID field. This is the Client ID you obtained from your Nielsen Digital Ad Ratings account settings (API Credentials or OAuth2 section). The Client ID is used in the OAuth2 token exchange to obtain access tokens.

4. Enter your Nielsen Digital Ad Ratings Client Secret in the Client Secret field. This is the Client Secret you obtained from your Nielsen Digital Ad Ratings account settings. The Client Secret is used in the OAuth2 token exchange and is sensitive information that must be kept confidential.

5. Enter your Nielsen Digital Ad Ratings Username in the Username field. This is your Nielsen Digital Ad Ratings account username that will be used for OAuth2 authentication.

6. Enter your Nielsen Digital Ad Ratings Password in the Password field. This is your Nielsen Digital Ad Ratings account password that will be used for OAuth2 authentication. The Password is sensitive information and must be kept confidential.

   Your Nielsen Digital Ad Ratings OAuth2 credentials can be found in your Nielsen Digital Ad Ratings account settings under the API Credentials or OAuth2 section. The Client ID and Client Secret are obtained from your OAuth2 client application settings. The Username and Password are your Nielsen Digital Ad Ratings account credentials.

   OAuth2 authentication uses 2-legged authentication, which means the token exchange happens directly without user authorization. The Client ID, Client Secret, Username, and Password are used together to obtain access tokens for API requests.

   If your credentials are compromised, you should immediately revoke them in your Nielsen Digital Ad Ratings account settings and generate new ones. The Client Secret and Password provide access to your Nielsen Digital Ad Ratings account data and should be treated as sensitive information. Keep your credentials secure and do not share them publicly.

   For detailed information about OAuth2 authentication, available endpoints, and API access, see the Nielsen Digital Ad Ratings API documentation.

7. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Nielsen Digital Ad Ratings connector tile, then select the credential that will be used to connect to your Nielsen Digital Ad Ratings account, and click Next; or, create a new Nielsen Digital Ad Ratings credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Nielsen Digital Ad Ratings endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

UniverseEstimateReference

This endpoint template provides population base information for each reportable demographic from the Nielsen Digital Ad Ratings API. Use this template when you need to retrieve universe estimate reference data, which contains population base information for demographic segments used in digital ad ratings reporting.

• This endpoint automatically retrieves universe estimate reference data. No additional configuration is required beyond selecting this endpoint template. The endpoint sends a POST request to retrieve the reference data.

This endpoint returns population base information for each reportable demographic, which is used as reference data for digital ad ratings reporting. The universe estimate reference data provides the population base for demographic segments, which is essential for calculating reach, frequency, and other ad ratings metrics.

For detailed information about universe estimate reference data, API response structures, and demographic information, see the Nielsen Digital Ad Ratings API documentation.

Method reference

This endpoint template returns the list of all available methods with method definitions from the Nielsen Digital Ad Ratings API. Use this template when you need to discover available reporting methods, method definitions, and method configurations for digital ad ratings reporting.

• This endpoint automatically retrieves method reference data. No additional configuration is required beyond selecting this endpoint template. The endpoint sends a POST request to retrieve the method reference data.

This endpoint returns the list of all available methods with method definitions, which provides information about available reporting methods, method configurations, and method parameters for digital ad ratings reporting. Use this endpoint to discover which methods are available and how to configure them for your reporting needs.

For detailed information about method reference data, available methods, and method definitions, see the Nielsen Digital Ad Ratings API documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

Nielsen Digital Ad Ratings data sources can also be manually configured to ingest data from any valid Nielsen Digital Ad Ratings API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, request body, path to data, and request headers.

Nielsen Digital Ad Ratings API endpoints typically use the POST method and are rooted at https://api.developer.nielsen.com/watch/dar/reporting/v1/, e.g. https://api.developer.nielsen.com/watch/dar/reporting/v1/UniverseEstimateReference. Use $[*] as the Response Data Path to extract all items from the response array, or a more specific JSONPath expression based on your endpoint's response structure.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Nielsen Digital Ad Ratings data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.