SmartNews Ads: Setup guide

SmartNews Ads: Setup guide#

This guide explains how to collect data from SmartNews Ads.

Prerequisites#

Before you start collecting data from SmartNews Ads, perform all of the following actions:

  • Ensure that you have access to the SmartNews Ads API. To request API access, fill out the Developer Application Form.

  • Create your API credentials by following these steps:

    1. Once your developer application is approved, log in to Business Manager.

    2. Navigate to the Developer Apps management section and select Register developer app information.

    3. For the app name, enter the exact name you used when you submitted the Developer Application Form and select Save and generate API client secret.

    4. Note and securely store your client secret. Your client secret will only be displayed once at generation.

    For more information, see the SmartNews Ads documentation.

Creating a datastream to collect data from SmartNews Ads#

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 SmartNews Ads.

Authorization: Allow Adverity to access SmartNews Ads#

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

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

  2. Click Next.

  3. In Client ID, enter your SmartNews Ads client ID.

  4. In Client secret, enter your SmartNews Ads client secret.

  5. Click Authorize.

Configuration: Choose the data you want to collect from SmartNews Ads#

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

  1. (Optional) Rename your datastream.

  2. In Accounts, select the ad accounts 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 Report type, select the type of data to collect from SmartNews Ads. The available options are:

    • Campaign insights: Collect performance data at the campaign level.

    • Ad group insights: Collect performance data at the ad group level.

    • Ad insights: Collect performance data at the ad level.

    The selected report type determines the additional fields to populate.

  4. Depending on the selected report type, select the campaigns, ad groups, or ads 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.

  5. In Dimensions, select the dimensions to include in your report.

  6. In Metrics, select the metrics to include in your report.

    Note

    You must select at least one dimension or metric.

  7. In Breakdown period, select how you want the collected data to be broken down.

  8. In Click attribution window, select the attribution window for counting conversions based on clicks. This calculates the conversions that occur within the specified time window after a click.

  9. In Viewable impressions attribution window, select the attribution window for counting conversions based on viewable impressions. This calculates the conversions that occur within the specified time window after a viewable impression.

What’s next?#

Contents