As of December 14, we have released the ability to assign names to Tweets via a new name field on the Tweets endpoint. We believe that being able to assign names to Tweets will help streamline processes, making it easier for advertisers to manage creatives and campaigns.
If you offer services relevant to this new feature, we recommend that you:
- Build a search feature within your user interfaces to be able to return Tweets by
name
- Display this new field where relevant in your user interfaces
- Begin to set this field
More details:
- The character limit for Tweet names is 80 characters (the same as the current limit for card names).
- Developers can provide search functionality that allows advertisers to search for a specific Tweet, Scheduled Tweet, or Draft Tweet
Keep in mind: The Tweet name will not be visible to people viewing the Tweet and exist only as a way to better identify and more easily manage ads on Twitter.
Card name vs. Tweet name
With this release, there are two creative name fields available with the Ads API - one available on the Cards endpoint and, with this new release, on the Tweet endpoints.
- Card endpoint
name - This field is required when creating a new Card. Any value within this field would not appear in ads.twitter.com
- Tweet endpoint
name - new as of this release. This field is optional. If this field has a value, it will appear in ads.twitter.com
- Note: if a Tweet is created on ads.twitter.com, that value will appear for both the Tweet
name AND Card name fields.
Documentation:
This new field is available now on the Ads API for Tweet endpoints, globally.
The following endpoints now accept a name parameter that will return all Tweets that match the input string.
The following endpoints can be used to set or update the name for a Tweet, Scheduled Tweet, or Draft Tweet.
More information on this feature can be found here. As always, please let us know if you have any questions or feedback.
Twitter Ads API team
