Campaign Management
Objective-based campaigns
Objective-based campaigns and pricing allow advertisers to pay for the actions that are aligned with their marketing objectives. To support these, set the appropriate objective
on line items.
The parameter used on the line item write endpoints and returned on the read endpoints, is objective
. This field has the following possible values as of today:
APP_ENGAGEMENTS
APP_INSTALLS
AWARENESS
FOLLOWERS
LEAD_GENERATION
(deprecated)QUALIFIED_IMPRESSIONS
(deprecated)TWEET_ENGAGEMENTS
VIDEO_VIEWS
VIDEO_VIEWS_PREROLL
VIDEO_VIEWS_MIDROLL
(not yet supported)WEBSITE_CLICKS
WEBSITE_CONVERSIONS
(deprecated)
Objectives impact how we optimize campaigns in our auctions and how we bill on those campaigns. We enable pricing based on objective, such as CPAC for APP_ENGAGEMENTS
, CPAC or CPI for APP_INSTALLS
, CPLC for WEBSITE_CLICKS
, CPF for FOLLOWERS
, CPE for TWEET_ENGAGEMENTS
, and CPM for AWARENESS
.
Mobile app promotion campaigns are required to contain either the APP_ENGAGEMENTS
or APP_INSTALLS
objective.
To determine what tweets are promotable, use the scoped_timeline endpoint with objective. Please see GET accounts/:account_id/scoped_timeline for more information.
Note: Line items with different objectives are not allowed under the same campaign.
Campaign objective |
API objective |
Media in Tweets |
Pricing model |
App engagements |
APP_ENGAGEMENTS |
Image or video app download card required. |
CPAC |
App installs |
APP_INSTALLS |
Image or video app download card required. |
CPAC or CPI (set using charge_by) |
Awareness |
AWARENESS | No restrictions. |
CPM |
Followers | FOLLOWERS | Tweet not required, but recommended. There are no media restrictions on Tweets for Followers campaigns. | CPF |
Tweet Engagements | TWEET_ENGAGEMENTS | No restrictions | CPE |
Video Views | VIDEO_VIEWS | Video conversation card, video, or GIF required. |
CPV or cost per 3s/100% view |
Video views pre-roll |
VIDEO_VIEWS_PREROLL |
Video required. |
CPV or cost per 3s/100% view |
Video views mid-roll |
VIDEO_VIEWS_MIDROLL |
Video required. |
CPV |
Website clicks/visits |
WEBSITE_CLICKS |
Website card recommended, but not required. Tweet must have either a website card or a website link (not both). |
CPLC |