Twitter Connector

Intro

The Domo Twitter Connector integrates Domo with Twitter to extract data from the Twitter API. The Domo Twitter Connector provides access to Twitter data including followers, timelines, retweets and many other Twitter entities. To learn more about the Twitter API, visit their site (https://dev.twitter.com/rest/public).

The Twitter connector is a "Cloud App" connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking Cloud App in the toolbar at the top of the window.

You connect to your Twitter account in the Data Center. This topic discusses the fields and menus that are specific to the Twitter connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.

Primary Use Cases	Social media followers on platform Response to specific tweets Retweets (engagement) Follower demographics Replies to followers
Primary Metrics	Follower count Retweet count Followers of followers and friends of followers (influence)
Primary Company Roles	Social media manager CMO
Average Implementation Time	10 minutes
Ease of Use (on a 1-to-10 scale with 1 being easiest)	2

Video - Connecting to Twitter

Best Practices

Some Twitter reports provide a snapshot in time, so these reports should be set up in "Append" mode to show trends. These reports include:

Followers
Favorites
Friends

Prerequisites

To connect to your Twitter account and create a DataSet, you must have the following:

Your Twitter username or your email address
Your password

Connecting to Your Twitter Account

This section enumerates the options in the Credentials and Details panes in the Twitter Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.

Credentials Pane

The Domo Twitter connector uses OAuth to connect, so there is no need to enter credentials within Domo. Click Connect (or select Add Account if you have existing Twitter accounts in Domo) to open the Twitter OAuth screen where you can enter your Twitter username and password. Once you have entered valid Twitter credentials, you can use the same account any time you go to create a new Twitter DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.

Note: If you are already logged into Twitter when you connect in Domo, you are authenticated automatically and taken to the "Authorize Domo, Inc. to use your account?" screen when you click Add account . If you want to connect to an account that is different from the one you are logged into, you must first log out of Twitter.

Details Pane

This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select.

Menu

Description

Report

Select the Twitter report you want to run. The following reports are available:

Account	Returns information about the authenticated user, such as time zone, screen name, language, etc.
Favorites	Returns the 20 most recent Tweets marked as Favorites by the authenticated user.
Followers	Returns a list of users that are following the authenticated user.
Friends	Returns a list of users the authenticated user is following.
Home Timeline	Returns the list of Tweets from the authenticated user’s main timeline screen at twitter.com.
Mentions Timeline	Returns a list of Tweets in which the authenticated user is mentioned (referred to by “@username”).
Retweeters	Returns a list of users who have retweeted posts from the authenticated user.
Retweets	Returns a list of the 100 most recent retweets of the tweet specified in the Tweet ID field.
Retweets of Me	Returns a list of the most recent tweets authored by the authenticated user that have been retweeted by others.
User Info	Returns basic information about the authenticated user.
User Timeline	Returns a collection of the most recent Tweets posted by the users indicated in the Screen Name field.

Screen Name

Enter a comma-separated list of names for the report. Names must be capitalized correctly. If no names are entered, the authenticated user's screen name is used for the report.

Tweet ID

Enter the ID for the tweet you want to retrieve information for.

Note: You can find the ID for a tweet in Twitter by doing the following:

Click the Tweets link under your username.
Locate the tweet you want to find the ID for.
Click the tweet's timestamp.

A page opens for this tweet. The tweet ID is the long number at the end of the URL.

Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.

Intro﻿