Aura: Setup guide

Aura: Setup guide#

This guide explains how to collect data from Aura.

Limitations#

Collecting data from Aura comes with the following limitations:

  • The Aura API only supports fetching data from the last 6 months.

Creating a datastream to collect data from Aura#

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 Aura.

Authorization: Allow Adverity to access Aura#

Before creating an authorization to give Adverity access to Aura, perform the following actions:

  1. Obtain an API token from Aura with the Reporting permission scope.

To set up a new authorization to fetch data from Aura, follow these steps:

  1. In the Authorization step of the datastream wizard, click Access Aura using your credentials.

  2. Click Next.

  3. In Secret, enter your Aura API token.

  4. Click Authorize.

  5. If you choose Access using your credentials or Access using someone else’s credentials, in Set up or edit Authorizations, 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 access to 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 access to 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.

    Warning

    If you use your credentials to grant Adverity access to Aura, all the items available to you using your credentials will be visible in the Authorizations page to all Adverity users with permission to edit this authorization.

    If someone else uses their credentials to grant Adverity access to Aura, the same applies to the items available using their credentials.

    This is important to consider if you do not want all Adverity users with permission to edit the authorization to be able to see the details of the authorization items. For more information about user permissions, see Managing user permissions.

Configuration: Choose the data you want to collect from Aura#

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

  1. (Optional) Rename your datastream.

  2. In Report type, select the type of data to collect from Aura.

  3. In Dimensions, select the dimensions by which to break down the data, for example country, device manufacturer, or day.

    Note

    The day dimension is selected by default. Aura requires a date dimension to be included in every request.

  4. In Metrics, select the metrics to collect, for example impressions, clicks, installs, launches, completions, or spend.

  5. (Optional) In Campaign, select one or more campaigns to filter the data. If no campaigns are selected, data for all campaigns is collected.

What’s next?#

Contents