Skip to content
Book a demo

Connect documentation

All documentation
Documentation

Hawk DSP: Setup guide

On this page

This guide explains how to collect data from Hawk DSP.

Limitations

Collecting data from Hawk DSP comes with the following limitations:

  • Data older than 367 days cannot be queried due to an API limitation. If such a query is attempted, a user-facing error appears.

Creating a datastream to collect data from Hawk DSP

The basics of creating a datastream to collect data from any data source are explained in our guide to Collecting data in Adverity. This guide contains information about the specific steps to create a datastream to fetch data from Hawk DSP.

Authorization: Allow Adverity to access Hawk DSP

You can authorize Adverity to access Hawk DSP using either your credentials or an API key.

To authorize Adverity using your credentials:

  1. If you choose Access using your credentials or Access using someone else’s credentials, in Set up or edit Organizations, you or the person granting access must choose one of the following options:

    • Choose Grant access to all items, including those created in the future to give Adverity Organizations to access all existing items and all items created in the future.

    • Choose Select specific items to which you want to grant access to only give Adverity Organizations to access the selected items. Adverity will not automatically have access to items created in the future. You will need to grant Adverity access to any items created in the future.

To authorize Adverity using an API key:

  1. In API Key, enter your Hawk DSP API key.

  2. In Organization IDs, enter the IDs of the organizations for which to collect data.

Configuration: Choose the data you want to collect from Hawk DSP

To choose what data to collect and customize the Hawk DSP datastream configuration, follow these steps:

  1. (Optional) Rename your datastream.

  2. In Organizations, select the organizations for which to collect data. If you do not select any items in a drop-down list, Adverity collects data for all items in the drop-down list.

  3. In Dimensions, select the dimensions to include in your data extract. The Device Type Name dimension maps device-type codes to human-readable labels.

What’s next?