Insights Hub

Insights Hub provides comprehensive analytics and reporting capabilities for advertising and brand performance data, enabling businesses to access detailed insights, track campaign effectiveness, and optimize marketing strategies through advanced data analysis and visualization tools.

Power end-to-end data operations for your Insights Hub API with Nexla. Our bi-directional Insights Hub connector is purpose-built for Insights Hub, 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 Insights Hub or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Insights Hub 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 an Insights Hub credential, you need to identify the test URL for authentication. Insights Hub uses no authentication for API requests, but requires a test URL to validate the credential configuration.

To prepare for credential creation, ensure you have the following:

1. Data Feed URL: You should have access to your Insights Hub data feed URL or Nexset's Data Feed API URL. This URL will be used to fetch data from the Insights Hub endpoint.

2. Test URL: You can use the default Nexla Echo URL (https://test-be.nexla.com/echo) for testing authentication, or you can enter your Nexset's Data Feed API URL if you have one available.

The Insights Hub connector uses no authentication, which means API requests are made without authentication headers or tokens. The test URL is used to validate that the credential configuration is correct and that the endpoint is accessible. For detailed information about Insights Hub API endpoints and data feed access, refer to the Insights Hub documentation or your Nexset configuration.

Authenticate

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 – NBC Insights Hub

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

3. Insights Hub uses no authentication for API requests, so no additional credential fields are required beyond the name and description entered above.

   The Insights Hub connector uses no authentication, which means API requests are made without authentication headers or tokens. The test URL is used to validate that the credential configuration is correct and that the endpoint is accessible.

   You can use the default Nexla Echo URL (https://test-be.nexla.com/echo) for testing, or you can enter your Nexset's Data Feed API URL if you have one available. The test URL should be accessible and return a valid response to confirm the credential configuration.

4. 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 Insights Hub connector tile, then select the credential that will be used to connect to your Insights Hub data feed, and click Next; or, create a new Insights Hub 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 Insights Hub 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.

Get Reporting Data By Advertiser & Brand

This endpoint template fetches reporting data from a Nexset's Data Feed URL based on advertiser ID and brand name. Use this template when you need to retrieve advertising and brand performance reporting data for specific advertisers and brands from the Insights Hub data feed.

• Enter the advertiser ID in the Advertiser ID field. This is the unique identifier of the advertiser you wish to fetch reporting data for. The advertiser ID is used to filter the reporting data to only include data for the specified advertiser.
• Enter the brand name in the Brand Name field. This is the name of the brand you wish to fetch reporting data for. The brand name is used to filter the reporting data to only include data for the specified brand.

This endpoint sends a POST request to the Insights Hub data feed URL with the advertiser ID and brand name in the request body. The endpoint fetches reporting data from a Nexset's Data Feed URL, which provides advertising and brand performance data. The advertiser ID and brand name are used to filter the reporting data to only include data for the specified advertiser and brand combination.

The endpoint returns reporting data in JSON format, which may include various metrics and dimensions related to advertising performance and brand analytics. Ensure you have the correct advertiser ID and brand name to retrieve the desired reporting data.

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

Insights Hub data sources can also be manually configured to ingest data from any valid Insights Hub endpoint or Nexset's Data Feed URL, including endpoints not covered by the pre-built templates or chained API calls. 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, date/time and lookup macros, path to data, metadata, and request headers. Insights Hub endpoints typically use the POST method against your Nexset's Data Feed API URL (e.g., https://dataops-sync.nexla.io/sync/65168?api_key=...).

For reporting data requests, the request body should be JSON in the form {"advertiser_id": {advertiser_id}, "brand_name": "{brand_name}"}, and the Response Data Path should be set to $[*] to extract all items from the response array. Adjust these values to match the structure returned by your specific Insights Hub endpoint.

Once all of the relevant settings have been configured, click the Next button to proceed with the rest of the data flow configuration, or click Save to save the data source configuration for later use.