Placements

There are several places where Twitter ads can be displayed. This is set at the line item using the placements parameter. The possible values are:

  • ALL_ON_TWITTER
  • PUBLISHER_NETWORK
  • TWITTER_PROFILE
  • TWITTER_SEARCH
  • TWITTER_TIMELINE

The enums page has more details.

The line item’s product_type and objective determine which placements are allowed. The GET line_items/placements endpoint can be used to retrieve the valid placement options for each product type.

Additionally, the following table lists the valid placement and objective combinations.

Objective ALL_ON_TWITTER PUBLISHER_NETWORK TWITTER_PROFILE TWITTER_SEARCH TWITTER_TIMELINE
APP_ENGAGEMENTS
APP_INSTALLS
AWARENESS  
FOLLOWERS      
TWEET_ENGAGEMENTS
VIDEO_VIEWS
VIDEO_VIEWS_PREROLL  
WEBSITE_CLICKS
 

Note: It is not possible to specify only TWITTER_PROFILE placement.

Note: TWITTER_SEARCH requires keyword targeting.

Note: The AWARENESS objective must include TWITTER_TIMELINE placement. It can have either ALL_ON_TWITTER, any combination of placements that include TWITTER_TIMELINE, or TWITTER_TIMELINE on its own.