Release Notes
April 2024
We have added new Quickstart packages for the following connectors:
* dbt Core is a trademark of dbt Labs, Inc. All rights therein are reserved to dbt Labs, Inc. Fivetran Transformations is not a product or service of or endorsed by dbt Labs, Inc.
June 2023
We have added the following new tables:
ACCOUNT_METROS_REPORT
CAMPAIGN_METROS_REPORT
FUNDING_INSTRUMENT_METROS_REPORT
LINE_ITEM_METROS_REPORT
PROMOTED_TWEET_METROS_REPORT
PROMOTED_ACCOUNT_METROS_REPORT
We have updated the following tables:
TABLE | REMOVED COLUMN(S) | REMOVED PRIMARY KEY | NEW COLUMN(S) |
---|---|---|---|
ACCOUNT_CITIES_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
ACCOUNT_LOCATIONS_REPORT | segment | segment_name , segment_value | |
ACCOUNT_POSTAL_CODES_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
ACCOUNT_REGIONS_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
CAMPAIGN_CITIES_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
CAMPAIGN_LOCATIONS_REPORT | segment | segment_name , segment_value | |
CAMPAIGN_POSTAL_CODES_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
CAMPAIGN_REGIONS_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
FUNDING_INSTRUMENT_CITIES_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
FUNDING_INSTRUMENT_LOCATIONS_REPORT | segment | segment_name , segment_value | |
FUNDING_INSTRUMENT_POSTAL_CODES_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
FUNDING_INSTRUMENT_REGIONS_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
LINE_ITEM_CITIES_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
LINE_ITEM_LOCATIONS_REPORT | segment | segment_name , segment_value | |
LINE_ITEM_POSTAL_CODES_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
LINE_ITEM_REGIONS_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
PROMOTED_TWEET_CITIES_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
PROMOTED_TWEET_LOCATIONS_REPORT | segment | segment_name , segment_value | |
PROMOTED_TWEET_POSTAL_CODES_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
PROMOTED_TWEET_REGIONS_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
PROMOTED_ACCOUNT_CITIES_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
PROMOTED_ACCOUNT_LOCATIONS_REPORT | segment | segment_name , segment_value | |
PROMOTED_ACCOUNT_POSTAL_CODES_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
PROMOTED_ACCOUNT_REGIONS_REPORT | segment , location_name , location_type | country_name | segment_name , segment_value |
NOTE: This change is enabled by default for connectors created after June 12, 2023. We are gradually rolling this out to all existing connectors and will notify all users beforehand.
March 2023
You can now select or deselect the following tables to sync from the Schema tab on your connector details page:
CAMPAIGN_HISTORY
CARD_HISTORY
FUNDING_INSTRUMENT_HISTORY
LINE_ITEM_HISTORY
TWEET
August 2022
We have added a new column, budget_optimization
, to the CAMPAIGN_HISTORY
table to support Twitter API version 11.
We have upgraded our Twitter Ads connector from version 10 to version 11 of the Twitter API.
May 2022
We have changed the segmentation of the line_item_cities_report
report.
We have renamed the country_name
column to location_name
.
We have added a new column, location_type
.
December 2021
We have added a new column, duration
, to the MEDIA_LIBRARY
table for storing video length values.
February 2021
We now support syncing data for the media_creative
entity. See our MEDIA CREATIVE table documentation for more information.
November 2020
We now support Twitter Ads API v8.
We have added the following new report tables to support Reach and Average Frequency:
CAMPAIGN_REACH_DAILY_REPORT
CAMPAIGN_REACH_MONTHLY_REPORT
FUNDING_INSTRUMENT_REACH_DAILY_REPORT
FUNDING_INSTRUMENT_REACH_MONTHLY_REPORT
We have added a new table, PREROLL_CALL_TO_ACTIONS_HISTORY
, which stores the preroll call-to-actions for an account. See Twitter's documentation for more information.
We have removed the video_mrc_views
field from the analytics tables. The video_total_views
field stores the same data.
October 2020
We have released pre-built, dbt Core-compatible data models for Twitter Ads. Find the models in Fivetran's dbt hub or data models documentation. Learn more about our dbt Core integration in our Transformations for dbt Core documentation*.
* dbt Core is a trademark of dbt Labs, Inc. All rights therein are reserved to dbt Labs, Inc. Fivetran Transformations is not a product or service of or endorsed by dbt Labs, Inc.
August 2020
We now support syncing data from the reporting tables for the promoted_account
entity. See our PROMOTED ACCOUNT tables for more information.
July 2020
We can now sync the records that you have deleted from the funding_instruments
, campaigns
, line_items
, and promoted_tweets
entities.
April 2020
In the MEDIA_CREATIVE_HISTORY
table, we have deprecated the serving_status
field and replaced it with the entity_status
field to support Twitter API v7. We will continue to support the deprecated field for the next three months, so be sure to make the required schema changes by July 3, 2020.
February 2020
We have made multiple schema changes to support Twitter API v6 changes. You can read detailed API documentation on Twitter's website. We will continue to support all deprecated items for the next three months, so be sure to make the required schema changes by May 25, 2020.
We have renamed the CITIES segment to METROS. However, the CITIES sub-string will be present in all analytics tables.
We have added the following fields to the tables below:
media_key
to theCARD_HISTORY
tableposter_media_key
andposter_media_url
to theMEDIA_LIBRARY
table
We have added four new fields to the
TWEET
table because the Twitter API endpoint has changed fromscoped_timeline
totweets
:tweet_type
(DRAFT, PUBLISHED, SCHEDULED)media_key
card_uri
full_text
We have deprecated and replaced the following fields in the tables below:
text
withfull_text
in theTWEET
tablevideo_poster_url
withposter_media_url
in theCARD_HISTORY
tablemedia_id
andvideo_content_id
withmedia_key
in theACCOUNT_MEDIA_HISTORY
tableimage
,wide_app_image
, andvideo_url
withmedia_url
in theCARD_HISTORY
table
We have deprecated the following fields from the tables below:
media_ids
from theSCHEDULED_TWEETS
tablevideo_hls_url
from theCARD_HISTORY
table
We will stop syncing data from the
VIDEO_APP_DOWNLOAD_CARD
,VIDEO_CONVERSATION_CARD
,VIDEO_DIRECT_MESSAGE_CARD
, andVIDEO_WEBSITE_CARD
tables to theCARD_HISTORY
table. However, we will continue syncing the data from theVIDEO_POLLS
table to theCARD_HISTORY
table.
January 2020
We have deprecated the include_sentiment
field from the LINE_ITEM_HISTORY
table because the Twitter Ads API no longer supports it. To learn more, see Twitter's API documentation.
November 2019
We have improved the sync speed for our Twitter Ads connector.
Previously, we made one API call per entity ID per day of data during syncs. We therefore had to make a large number of API calls when we fetched data for multiple entity IDs and/or for multiple days' worth of data. Making so many API calls slowed down our syncs.
Now Fivetran can fetch multiple days' worth of data for up to 20 entity IDs in a single API call, which makes syncs significantly faster.
August 2019
We released a new version of our Twitter Ads connector, service version 2. You can now select how many months' worth of data you'd like to include in your initial sync. Choose from the following options:
- 3 months
- 6 months
- 12 months
- 24 months
- All time
Twitter Ads connectors running on service version 0 and 1 will sunset on November 21, 2019. If you are using either of these service versions, upgrade to the newest version by creating a new Twitter Ads connector and syncing into a new schema.
July 2019
You can now configure your Twitter Ads connector through the Fivetran REST API. This feature is in BETA and available only for Standard and Enterprise accounts.
If we encounter insufficient permissions when we try to sync endpoints for a specific account, then we skip that endpoint for that account and give a warning in the dashboard. The warning includes endpoints with their respective accounts as follows.
Account ID | Skipped Endpoints |
---|---|
account_1 | endpoint_1 |
endpoint_2 | |
account_2 | endpoint_1 |
If you receive this warning, give Account Administrator permissions for that account to the user which you used to create your Twitter Ads App.
February 2019
We upgraded the connector to Twitter Ads API version v4. Read more about their new version on Twitter's documentation. As part of the upgrade, we have made the following schema changes:
- Removed the
VIDEO_HISTORY
andVIDEO_REASON_HISTORY
tables as Twitter deprecated thevideos
endpoint. - Removed the
preview_url
column from theCARD_HISTORY
table. - Renamed the
app_country_code
column of theCARD_HISTORY
table tocountry_code
.
July 2018
Twitter Ads provides a history of the settings and detailed reports of your Twitter Ad Accounts, Campaigns, Line Items, Tweets, and Media Creatives.