Twitter Ads: Setup guide#

This guide explains how to collect data from Twitter Ads.

Introduction#

For a list of the fields that you can collect from Twitter Ads, see Twitter Ads.

You can retrieve information for cards created through Twitter Ads API or ads.twitter.com. You cannot retrieve information for cards created through the Twitter user interface.

Prerequisites#

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

  • Ensure that the Twitter user who sets up the authorization has one of the following roles:

    • Ad Manager

    • Account Administrator

Creating a datastream to collect data from Twitter 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 Twitter Ads.

Authorization: Allow Adverity to access Twitter Ads#

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

    Warning

    If you use your credentials to grant Adverity access to Twitter Ads, 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 Twitter Ads, 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 Twitter Ads#

Note

This connector reports data in Coordinated Universal Time (UTC).

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

  1. (Optional) Rename your datastream.

  2. In Accounts, select the 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. (Optional) Select the Exclude accounts checkbox to exclude the selected accounts.

  4. In Report type, select the type of data to collect from Twitter Ads. The fields you need to configure in the following steps differ according to the report type you select.

  5. In Level, select the type of data to collect from Twitter Ads. The configuration options below may change depending on the selected level.

  6. In Metadata type, select the type of the metadata that you want to collect.

  7. In Date filter, select the field that you want to use to define the fetch date range.

  8. In Accounts, select the accounts to include in the report.

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

  10. In Placement, select the ad placement type. If you do not select any items in a drop-down list, Adverity collects data for all items in the drop-down list.

  11. In Granularity, select the time unit in which you want to retrieve your data.

  12. Select the Include mentions and replies checkbox to collect data for mentions and replies to your tweets.

  13. In Campaigns, select the campaigns 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.

  14. Select the Include inactive campaigns checkbox to include campaigns older than 90 days.

  15. Select the Include empty rows checkbox to include the rows for which all metrics are zero.

  16. In Segmentation, select how to segment your data.

  17. Select the Media screenshots enabled checkbox to capture media screenshots.

What’s next?#

Advanced Twitter Ads tips#

For advanced configuration and best practices, see Advanced Twitter Ads tips.