AudioGo: Setup guide

AudioGo: Setup guide#

This guide explains how to collect data from AudioGo.

Limitations#

Collecting data from AudioGo comes with the following limitations:

  • This connector has rate limits. API keys on a Free plan have stricter quotas. To avoid errors, try fetching smaller date ranges or fewer records at a time.

  • The monthly quota for Free plan API keys is 10,000 requests.

  • The maximum fetch range per request depends on the number of dimensions selected. For details, see Date range limits.

Creating a datastream to collect data from AudioGo#

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

Authorization: Allow Adverity to access AudioGo#

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

  1. Contact AudioGo support to obtain your API key.

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

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

  2. Click Next.

  3. In API Key, enter your AudioGo API key.

  4. Click Authorize.

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

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

  1. (Optional) Rename your datastream.

  2. In Agency ID, enter the system-generated unique ID for your agency.

  3. In Dimensions, select the dimensions to include in the report. You can select up to 5 dimensions.

    Note

    If Granularity is set to Day, Hour, or Month, you must also select the Time dimension. When using the Geo - Region dimension, Geo - Country must also be selected. When using the Geo - Sub-Region dimension, both Geo - Country and Geo - Region must be selected.

  4. In Metrics, select the metrics to include in the report.

  5. In Granularity, select the time interval for the report. The following options are available:

    • Day (default) — data is aggregated by day.

    • Hour — data is aggregated by hour.

    • Month — data is aggregated by month.

    • Total — data is aggregated across the entire selected date range with no date breakdown.

  6. In Fields, change the list of fields that you want to see in your data extract.

What’s next?#

Advanced AudioGo tips#

Date range limits#

The maximum date range per request depends on the number of dimensions selected and the granularity:

  • When 4 or 5 dimensions are selected with Day, Hour, or Month granularity, the maximum fetch range is 3 months per request.

  • When fewer than 4 dimensions are selected with Day, Hour, or Month granularity, the maximum fetch range is 15 months per request.

  • When Granularity is set to Total, no date range restriction applies.

Rate limits#

The following rate limits apply to the AudioGo API:

Limit

Value

Steady-state rate

1 request / second

Burst rate

5 requests / second

Monthly quota

10,000 requests / month
Contents