Ipsos Synthesio

For more general information on data collection in Redbird, check out: Getting Started With Data Collection

This guide explains how to set up access and collect data from the Synthesio platform which collects social media metrics. You can extract this data in Redbird by either selecting queries or uploading your own from a file. You will need API access enabled on your Synthesio account to use this collect App.

If you cannot see the Synthesio collection app in the left-side panel on the workflow canvas, refer to: Enabling Collection Apps Guide

Inputting Credentials

1. Click the person icon located in the upper right-hand corner of the page
2. Click Account Settings
3. Click Apps
4. Navigate to Synthesio
5. Click on the settings cog associated with you Synthesio API. You will need
   1. Client ID
   2. Client Secret
   3. Username
   4. Password
6. Input the credentials
7. Click Done

Creating a Collection

1. Double-click on the node to enter configuration mode
2. Enter the collection name in the textbox next to Configuration Name\
   
   
   \
   
   
3. If you have queries you wish to pull data for that you haven't set up on the Synthesio platform, you can upload a query file listing these. Do this by clicking Choose File -> Upload
4. In the Parameters section you can choose to pull Analytics (just the metrics) or full Mentions themselves.
5. You can then configure your collection by selecting the following from the drop-downs:
   1. The dashboard within Synthesio that you are pulling data from
   2. The topic structure: Either topics and subtopics, or topics only
   3. (for Analytics only) Time granularity: Day, month, or year
   4. (for Mentions only) Whether you wish to include Retweets or not
   5. Channel Type: Earned, owned or both
   6. The country filter you wish to apply (you can choose multiple)
   7. The Topic(s) you wish to include (if you have set these up on the platform)
6. Update Method allows you to select how you want your data to aggregate when you run future data pulls. Append keeps the historical data and adds the future data pulls below. Replace deletes the historical data and generates the new data in its place.
7. Initial Data Load allows you to upload historical data in bulk as a one-off in the event that you have the data saved on your computer. You can upload your data as a CSV file with no leading/trailing rows or columns and Redbird will run future data collections using the configuration that you set up in previous steps.

8. Click Done

Running a Collection

1. Click on the node.
2. In the right-side panel click Run
3. If date selection is set to manual, then the workflow will be stopped for you to input dates. Click Review on the node.
4. Select the Start date and End date of the period you would like to cover.
5. Click Back to Workflow
6. Click Continue on the node.