Twitter timeline section type - details

This section type displays a Twitter timeline in a section of your report.

For an introduction, see Twitter configuration tab and Choosing a report section type.

Walkthrough

The easiest way to see how you can use a Twitter timeline is to walk through an example.

  1. On the NAM Server, select NAM Server ► Tools ► DMI ► New report to open DMI to an empty section.
  2. Set Section type to Twitter timeline.
    A Twitter configuration tab is displayed and all other section tabs are hidden.
    The Twitter configuration tab has two views:
    • Twitter
    • Design
  3. In the Twitter view, set the Timeline type to User, and set User name to Dynatrace.
  4. Click Display report to see it in action. It should look something like this, though of course there will be more recent tweets since this screen was captured.
    The section contents are a live Twitter feed: The Twitter header is Tweets by ‎@Dynatrace, where @Dynatrace is an active link to the Dynatrace twitter account. The content that follows the Twitter header is a succession of tweets made by that Twitter account.

General configuration procedure

  1. Set Section type to Twitter timeline.
    The Twitter configuration tab is displayed with two views:
    • Twitter
    • Design
  2. In the Twitter view, set the Timeline type to the tweet type
    This determines the rest of requirements.
  3. Set the parameters for the selected Timeline type.
    • User requires a Twitter User name and whether to show replies.
    • Hashtag requires a Hashtag and a Widget ID.
      Generate a new widget ID number for the string you want to use as the hashtag.
    • List requires a User name and List name.
    • Search requires a Search query string and a Widget ID.
      Generate a new widget ID number for the string you want to use as the search query.
    • Replies requires a Twitter User name and a Widget ID.
      Generate a new widget ID number for the string you want to use as the user.
    • Mentions requires a User name and Widget ID.
      Generate a new widget ID number for the string you want to use as the user.
  4. In the Design view, make settings that determine the section's appearance.
    • Section width determines how many pixels wide this section will be.
    • Section height determines how many pixels high this section will be.
    • Render section as dark sets this section for light, dark, or automatically determined based on circumstances. If you set fullscreen to dark mode, the Twitter plugin automatically renders in dark mode.
    • Customization options such as "noscrollbar" are possible here.

Generating a widget ID

Some Twitter timeline types require that you provide a Widget ID. This is easy to obtain, but you have to know how to get it.

Note: This procedure was correct at the time of writing, but it refers to a third-party website (twitter.com) whose content is not under our control.

  1. Go to  https://twitter.com/settings/widgets/new
    This opens the Create a search widget page on the Twitter site.
    If you are not logged in to Twitter, you need to log in now.
  2. Set Search Query to the search item you need.
    • Dynatrace looks for the simple string.
    • #Dynatrace looks for the hashtag.
  3. Examine the contents of the Preview box to make sure it returns the results you want.
  4. Click Create widget.
  5. Click Save changes.
  6. Where it says "Copy and paste the code into the HTML of your site" copy the contents the HTML and paste it into a text editor.
  7. Find the part that looks something like "data-widget-id="842355303886774272".
  8. The number (yours will be different) is the Widget ID you will need to paste into NAM when configuring a Twitter timeline section on a report.

Examples

User

For this example, we made a Twitter section with the following settings:

Timeline type = User

User name = Dynatrace

(In practice, you might use your own company's Twitter account.)

The section contents are a live Twitter feed:

  • The Twitter header is Tweets by ‎@Dynatrace, where @Dynatrace is an active link to the Dynatrace twitter account.
  • The content that follows the header is a succession of relevant tweets.

List

As the Twitter help says, "A list is a curated group of Twitter accounts. You can create your own lists or subscribe to lists created by others. Viewing a list timeline will show you a stream of Tweets from only the accounts on that list."

For this example, we made a Twitter section with the following settings:

Timeline type = List

User name = Dynatrace

List name = dynatrace-rockstars

In practice, you would probably use your own company's Twitter account and list name, or perhaps some third-party industry-standard list.

It generated the following output (at the time of screen capture):

You could easily switch it to a dark background.

In which case, you would get the same content but formatted for night reading:

Hashtag

As the Twitter help says, "A hashtag—written with a # symbol—is used to index keywords or topics on Twitter. This function was created on Twitter, and allows people to easily follow topics they are interested in."

A Twitter hashtag is not account-specific. If you add a Twitter hashtag section to your report, it will show tweets from anyone using the hashtag you configure for your report section.

For this example, we made a Twitter section with the following settings:

Timeline type = Hashtag

Hashtag = APM