v11.0.0

Details for the v11 release can be found here

Changes Included:

• Bump version to 11
• Added support for PUT cards/unified cards; updated example; added tests
• Added new budget_optimization param to the campaigns module
• Added new standard_delivery param to the line items module
• Updated examples

Support for Ruby 3.0

What's Changed

• Add effective_status to campaigns by @tushdante in #257
• Ruby 3.0.0 Compatibility by @osowskit in #259
• Bump version to publish new release by @osowskit in #260

Full Changelog: v10.0.0...v10.1.0

v10.0.0

Details for the v10 release can be found here

Changes included:

• Renamed Audience Summary to Audience Estimate
• Deprecated ipad_app_id and renamed to ios_app_store_identifier
• Deprecated automatically_select_bid
• Deprecated tracking_tags and added new tracking tags endpoint
• Deprecated select targeting_criteria fields

v9.0.0

Details for the v9 release can be found here

Changes included:

• Added support for new Cards endpoint
• Renamed "Tailored Audiences" to "Custom Audiences"
• Line Item parameter updates:
  • Removed optimization and bid_unit
  • Added goal
  • Renamed bid_type to bid_strategy
  • Renamed charge_by to pay_by
• Updated enums

v8.0.0

Details for v8 release can be found here

Changes included:

• Renamed objective enums
• Added targeted audiences support + tests
• Updated examples
• owner_account_id for Tailored Audiences

v7.0.1

Add android_app_store_identifier and ios_app_store_identifier per this deprecation notice

v7.0.0

Added

• Audience summary endpoint
• Granular TAP placements
• Advertiser Business Categories

Removed

• Reach estimate endpoint

Changed

• serving_status to entity_status for media creatives

v6.0.1

Bug fix

• Fix MediaLibrary class #211
  • Duplicated save method and introduced add (POST) and update (PUT) methods
• Require TwitterAds::Conversation in twitter-ads #213 by @jamesy829

v6.0.0

This release is mainly focused on following the recent Ads API version 6 release.
Several important changes are made in version 6 so please see the full details as to what's changed: https://twittercommunity.com/t/ads-api-version-6/129060

You can check all the SDK changes we made in this new release from this PR: #210
We also updated the handy Postman collection (v6 support) to make your testing and development workflow even easier.

New

Number of processing jobs

https://twittercommunity.com/t/ads-api-version-6/129060/1#heading--number-of-processing-jobs
In order to make it easier to manage asynchronous analytics workflows, the Ads API now returns two new response headers:

• X-Concurrent-Job-Limit: The maximum number of jobs that may be in a processing state at any given time
• X-Concurrent-Job-Limit-Remaining: The number of jobs that can be created given the number currently being processed

These values are returned when asynchronous analytics jobs are created using the POST stats/jobs/accounts/:account_id endpoint, and SDK users can access these headers through instance variables:

stats = TwitterAds::LineItem.create_async_job(account, ids, metric_groups)

puts stats.concurrent_job_limit
puts stats.concurrent_job_limit_remaining

Changed

Analytics.create_async_job()

• Analytics.create_async_job() can now be called directly (with specifying entity parameter)
• Analytics.create_async_job() now returns instance rather than hash

- job_id = TwitterAds::LineItem.create_async_job(account, ids, metric_groups)[id]
+ job_id = TwitterAds::LineItem.create_async_job(account, ids, metric_groups).id

as_user_id now required 61bfa97

https://twittercommunity.com/t/ads-api-version-6/129060/1#heading--as-user-id-now-required
Given the impact of this change, SDK now provides a new class method UserIdLookup.load() that can be used to lookup an user_id by a given Twitter screen name.

user_id = TwitterRestApi::UserIdLookup.load(account, screen_name: 'your_twitter_handle_name').id

Deprecated

Scoped Timeline

The GET accounts/:account_id/scoped_timeline endpoint is no longer available in v6. 9683ca8
https://twittercommunity.com/t/ads-api-version-6/129060/1#heading--scoped-timeline
* SDK will continue to support this endpoint until the v5 became sunset.

Removed

Audience Intelligence

https://twittercommunity.com/t/announcement-audience-intelligence-deprecation/127907

Old Tweet preview endpoints

Below endpoints are removed in this release:

• GET accounts/:account_id/tweet/preview
• GET accounts/:account_id/tweet/preview/:tweet_id
• GET accounts/:account_id/draft_tweets/preview/:draft_tweet_id
• GET accounts/:account_id/scheduled_tweets/preview/:scheduled_tweet_id

v5.2.0

• Added:

  • Added support for Tailored Audience Permissions #202

• Bug fixes:

  • Fix string concatenation #201
  • Rename user_ids to user_id in Account#timeline #176 (Thanks to @esakai)