Announcement: Granular TAP placements now available

announcements

#1

The Ads API now exposes the following granular Twitter Audience Platform (TAP) placement values:

  • TAP_FULL
  • TAP_FULL_LANDSCAPE
  • TAP_BANNER
  • TAP_NATIVE

Note that these placements cannot be set via the API. They can only be added via the Twitter Ads UI, as shown below.

If set, these will appear in the placements array when making requests to the GET accounts/:account_id/line_items and GET accounts/:account_id/line_items/:line_item_id endpoints. However, if all four placements are added, placements will show PUBLISHER_NETWORK and not the individual TAP placements.

With this change, it will be clear whether stats requests should be made for placement=PUBLISHER_NETWORK.

Twitter Ads API Team


Example request and response:

$ twurl -H ads-api.twitter.com "/1/accounts/18ce54d4x5t/line_items/6t1om" | jq
{
  "request": {
    "params": {
      "line_item_id": "6t1om",
      "account_id": "18ce54d4x5t"
    }
  },
  "data_type": "line_item",
  "data": {
    "bid_type": "TARGET",
    "advertiser_user_id": 756201191646691300,
    "name": "Untitled",
    "placements": [
      "TWITTER_TIMELINE",
      "TWITTER_PROFILE",
      "TAP_FULL",
      "TAP_NATIVE",
      "TAP_FULL_LANDSCAPE"
    ],
    "start_time": null,
    "bid_amount_local_micro": 2600000,
    "automatically_select_bid": false,
    "advertiser_domain": "twitter.com",
    "target_cpa_local_micro": null,
    "primary_web_event_tag": null,
    "charge_by": "APP_CLICK",
    "product_type": "PROMOTED_TWEETS",
    "end_time": null,
    "bid_unit": "APP_CLICK",
    "total_budget_amount_local_micro": null,
    "objective": "APP_INSTALLS",
    "id": "6t1om",
    "entity_status": "DRAFT",
    "paused": false,
    "account_id": "18ce54d4x5t",
    "optimization": "DEFAULT",
    "categories": [
      "IAB1"
    ],
    "currency": "USD",
    "created_at": "2016-11-19T00:20:00Z",
    "tracking_tags": [],
    "updated_at": "2016-11-19T00:20:00Z",
    "include_sentiment": "POSITIVE_ONLY",
    "campaign_id": "6ik4q",
    "creative_source": "MANUAL",
    "deleted": false
  }
}

How can I find TAP Line Items/Campaigns
Discrepance Between Ad Manager and Twitter Ads API
#2

#3