X Ads (Twitter) Updates

Updates on the X Ads (Twitter) data source, including new metrics, dimensions, and other features.

September 2023

2023-09-27

New dimensions added:

• Ad name
• Tweet name

2023-09-12

New dimensions added:

• Source (utm)
• Medium (utm)
• Campaign (utm)
• Content (utm)
• Term (utm)

November 2022

2022-11-30

Fields deprecated:

• Ad group paused

• Campaign paused

Fields added as replacement:

• Ad group status

• Campaign status

March 2022

2022-02-10

New dimension added:

• Insertion order header ID

February 2022

2022-02-15

Twitter Ads data source has been updated to API version 10.

As part of this update, the "Tweet card type" dimension will now show more specific values for the card type.

The following fields have been deprecated as the new API version no longer supports them:

• Automatically select bid
• Tracking tags

January 2022

2022-01-18

Support added for ALL ACCOUNTS account selection option.

New metric added:

• Media Engagements

August 2021

2021-08-05

New dimension added:

• Tweet ad ID

2021-08-24 -

Twitter Ads data source has been updated to API version 9.

Added fields:

• Goal
• Tweet card URI

Deprecated fields:

• Optimization (use Goal instead)
• Bid unit (use Goal instead)
• Tweet card ID (use Tweet card URI instead)
• Tweet card display URL

May 2021

2021-05-04 -

Added new dimensions to support media creatives:

• Media creative ID
• Media creative creation date
• Media creative type
• Media URL
• Media name

March 2021

2021-03-17 -

New field added:

• Tweet card image

Feb. 2021

2021-02-02 -

New metrics added:

• Total audience reach
• Average frequency

Note that these require the ad account to have the reach and frequency feature enabled by Twitter. Accounts without this enabled cannot use these fields.

2021-02-04:

New setting added for "Include deleted campaigns and ad groups". By default, these are not included. Enabling the setting will allow deleted objects to be seen in the data set.

2021-02-25:

Upgraded data source to use Twitter Ads API v8.

Jan. 2021

2021-01-12 -

New metric added:

• 6s video views

Oct. 2020

2020-10-08:

The following fields have been renamed to more closely align with the reporting UI naming scheme:

Current Display Name	New Display Name
Line item	Ad group
Line item ID	Ad group ID
Line item total budget	Ad group total budget
Line item creation date	Ad group creation date
Line item paused	Ad group paused
Line item deleted	Ad group deleted

Sept. 2020

2020-09-08:

Updated authentication to use v2 API.

May 2020

2020-05-14:

Connector was updated to v7 of the Twitter API.

March 2020

2020-03-03 -

The following dimensions have been added:

• Tweet card name
• Tweet card ID
• Tweet card type

2020-03-10 -

New metric added:

• 3s/100% video views

2020-03-17 -

New dimension was added:

• Tweet media type

Feb. 2020

2020-02-04:

Connectors have been updated to use API version 6.

2020-02-11:

The following fields have be deprecated as the Twitter API no longer supports them. Please remove the fields from your reporting as they will now return "null":

• Audience type
• Interaction type
• Audience name
• Source of audience data
• Audience category
• Percentage
• Match rate

The following fields have been renamed:

• Week (Mon-Sun)              => Week (Sun-Sat)
• Day of week                      => Day of week (Sun-Sat)
• Year & week (Mon-Sun) => Year & week (Sun-Sat)

The following fields have been added:

• Week (Mon-Sun)
• Year of week (Sun-Sat)
• Year of week (Mon-Sun)
• Year & week (Mon-Sun)
• Day of week (Mon-Sun)
• Quarter
• Tweet source
• Tweet scheduled status
• Tweet scheduled at
• Tweet language
• Tweet hashtags
• Tweet symbols
• Tweet user mentions

Jan. 2020

2020-01-30 - new currency conversion metrics added:

• Cost (EUR)
• Cost (USD)
• Cost (GBP)

July 2019

2019-07-10 - New dimensions added:

• City
• Region

June 2019

2019-06-06 - New dimensions added to support Funding Instrument data:

• Funding instrument ID
• Funding instrument description
• Funding instrument type
• Funding instrument status
• Funding instrument currency
• Funding instrument start date
• Funding instrument end date
• Funding instrument credit limit
• Funding instrument funded amount
• Funding instrument credit remaining
• Reasons funding instrument was not able to fund

2019-06-26:

The Audience report type now supported. These fields are now available to use to gather audience information:

• Audience type
• Interaction type
• Audience name
• Source of audience data
• Audience category
• Percentage
• Match rate

May 2019

2019-05-07:

We previously only supported "Website cards" for Twitter promoted tweets but now we can support all card types, including:

• Image App Download Cards
• Image Conversation Cards
• Video App Download Cards
• Video Conversation Cards
• Video Website Cards
• Image Direct Message Cards
• Video Direct Message Cards
• Poll Cards
• Cards that have been added via a POST request to Twitter API (Wordpress plugins, etc., do this)

Jan. 2019

2019-01-10:

Added explicit timezone settings to fix issues and errors caused by timezones.

2019-01-30:

Supermetrics connectors for Twitter Ads have been updated to use API v4.

Nov. 2018

2018-11-15:

The following metrics have been deprecated as they are either no longer available in the API or were mis-labeled:

• Impressions (profile) (deprecated)
• Qualified impressions (profile) (deprecated)
• Clicks (profile) (deprecated)
• Engagements (profile) (deprecated)
• Favorites (profile) (deprecated)
• Follows (profile) (deprecated)
• Replies (profile) (deprecated)
• Retweets (profile) (deprecated)
• URL clicks (profile) (deprecated)
• Card engagements (profile) (deprecated)
• Media views (profile) (deprecated)
• Impressions (timeline) (deprecated)
• Qualified impressions (timeline) (deprecated)
• Clicks (timeline) (deprecated)
• Engagements (timeline) (deprecated)
• Favorites (timeline) (deprecated)
• Follows (timeline) (deprecated)
• Replies (timeline) (deprecated)
• Retweets (timeline) (deprecated)
• URL clicks (timeline) (deprecated)
• Card engagements (timeline) (deprecated)
• Media views (timeline) (deprecated)
• Impressions (search) (deprecated)
• Qualified impressions (search) (deprecated)
• Clicks (search) (deprecated)
• Engagements (search) (deprecated)
• Favorites (search) (deprecated)
• Follows (search) (deprecated)
• Replies (search) (deprecated)
• Retweets (search) (deprecated)
• URL clicks (search) (deprecated)
• Card engagements (search) (deprecated)
• Media views (search) (deprecated)
• Impressions (TPN) (deprecated)
• Qualified impressions (TPN) (deprecated)
• Clicks (TPN) (deprecated)
• Engagements (TPN) (deprecated)
• Favorites (TPN) (deprecated)
• Follows (TPN) (deprecated)
• Replies (TPN) (deprecated)
• Retweets (TPN) (deprecated)
• URL clicks (TPN) (deprecated)
• Card engagements (TPN) (deprecated)
• Media views (TPN) (deprecated)

The following metrics were added to replace the mis-labeled versions:

• Likes
• Retweets
• Replies
• Follows
• Card engagements
• Qualified impressions
• URL Clicks
• Engagements rate (%)

Aggregation was fixed on "Tweet likes" and "Tweet retweet" metrics for Promoted tweets.

June 2018

2018-06-13:

Supermetrics connectors for Twitter Ads have been updated to use API v3.