Collecting data from BrightEdge

Follow this guide to collect data from BrightEdge and preview the data.

Understanding datastreams and authorizations

When you connect to BrightEdge through Adverity, you authorize Adverity to access your account. Adverity stores this authorization information in an authorization, and stores the data collection configuration in a datastream.

You can create several datastreams using the same authorization. The datastreams collect information from the same source, with the same login credentials, with different configurations.

Limitations

Collecting data from BrightEdge comes with the following limitations:

When using the report types Keyword Volume Trending and Keyword Group Volume Trending, the Search engine field displays values that imply the device type used for the search engine. For example, Google Australia (AU) (T) where the (T) indicates a tablet was used, or Bing Australia (AU) - English (D) where (D) indicates a desktop computer was used. However, the API call to BrightEdge cannot define the device type, and therefore data for all device types is collected.

Creating a datastream using BrightEdge

Connecting to BrightEdge

To connect to BrightEdge, follow these steps:

1. Select the workspace you work with in Adverity and then, in the platform navigation menu, click Datastreams.

2. In the top right corner, click + Create datastream.

3. Search for and click BrightEdge.

4. Choose one of the following options:

   • Click Setup a new authorization and set up the new authorization with your own login credentials.

   • Click Send an access request to ask someone else to set up the new authorization. In the Email field, enter the email address of the person you want to ask to authorize the new authorization.

   • If you already have an authorization to BrightEdge, choose an existing authorization.

5. Click Next.

Choosing what data to collect

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

1. Click Custom configuration.

2. Click Next.

3. (Optional) Rename your datastream.

4. In Report type, select the type of data to collect from BrightEdge. The selected report type determines the additional fields to populate.

5. In Accounts, select the accounts for which to collect data.

6. In Domains, Competitors, Keyword groups, and Search engines, select the domains, competitors, keyword groups, and search engines 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.

7. In Dimensions and Measures, change the list of fields that you want to see in your data extract.

8. In Time frequency, select the time unit in which you want to retrieve your data.

9. Click Next.

Choosing where to transfer your data

To choose where to transfer your data, follow these steps:

1. To assign destinations to your datastream, select their checkboxes. For more information on destinations and their configuration settings, see Introduction to transferring data.

2. Click Next.

Collecting initial data

To collect the initial data, follow these steps:

1. Choose the time period for which data is collected.

2. Click Run fetch.

Previewing data collected from BrightEdge

The fetch collects data from BrightEdge which takes some time. The Overview page of the newly created datastream is now displayed. To preview the collected data, follow these steps:

1. In the All tasks tab, find the task at the top of the list, and click Show extracts.

2. Click the top hyperlink.

3. The data extract is displayed in a table containing the data that you have fetched.

What’s next?

After collecting data from BrightEdge, harmonize your data so that it conforms with Adverity's unified naming and formatting conventions.