排序
大多数广告 API 集合端点(返回对象列表)可以进行排序。你可找到各种可用于排序的参数,具体视不同端点而定。这些参数返回的大多数字段(ID 和 ENUM 除外)都是可排序的。
API 集合 | 可排序参数 |
---|---|
账号 | created_at 、updated_at 、deleted 、name |
支付手段 | created_at 、updated_at 、deleted 、funded_amount_local_micro 、start_time , end_time |
广告活动 | created_at 、updated_at 、deleted 、name 、start_time 、end_time 、daily_budget_amount_local_micro 、total_budget_amount_local_micro 、standard_delivery |
行项目 | created_at 、updated_at 、deleted 、bid_amount_local_micro |
卡片 | created_at 、updated_at 、deleted 、name |
推广账号 | created_at 、updated_at 、deleted 、paused |
推广推文 | created_at 、updated_at 、deleted 、paused |
应用事件标签 | created_at 、updated_at 、deleted 、post_view_attribution_window 、post_engagement_attribution_window 、assisted_conversion 、provider_app_event_name |
入门指南
只需在 API 请求中追加 sort_by=[attribute name]-[asc/desc]
;其中,属性为 GET 请求的 JSON 中返回的有效属性。
例如,可以使用 ?name-asc
按名称的字母顺序排序,或使用 ?name-desc
进行反向排序。
深入了解
以下所示为按 bid_amount_local_micro 以降序顺序返回所有行项目的示例 API 请求。
$ twurl -H ads-api.twitter.com"/5/accounts/k9w0oe/line_items?sort_by=bid_amount_local_micro-desc"
{ "request": { "params": { "sort_by": [ "bid_amount_local_micro-desc" ], "account_id": "k9w0oe" } }, "data": [ { "bid_type": "MAX", "name": "Untitled", "placements": [ "ALL_ON_TWITTER" ], "bid_amount_local_micro": 3000000, "automatically_select_bid": false, "advertiser_domain": null, "primary_web_event_tag": null, "charge_by": "ENGAGEMENT", "product_type": "PROMOTED_TWEETS", "bid_unit": "ENGAGEMENT", "total_budget_amount_local_micro": null, "objective": "ENGAGEMENTS", "id": "1iw6k", "paused": true, "optimization": "DEFAULT", "categories": [ ], "currency": "USD", "created_at": "2014-09-09T02:11:32Z", "updated_at": "2015-05-27T23:01:45Z", "include_sentiment": "POSITIVE_ONLY", "campaign_id": "1kv71", "creative_source": "MANUAL", "deleted": false }, { "bid_type": "MAX", "name": "Untitled", "placements": [ "ALL_ON_TWITTER" ], "bid_amount_local_micro": 3000000, "automatically_select_bid": false, "advertiser_domain": null, "primary_web_event_tag": null, "charge_by": "FOLLOW", "product_type": "PROMOTED_ACCOUNT", "bid_unit": "FOLLOW", "total_budget_amount_local_micro": null, "objective": "FOLLOWERS", "id": "1nlqp", "paused": false, "optimization": "DEFAULT", "categories": [ ], "currency": "USD", "created_at": "2014-10-20T18:57:18Z", "updated_at": "2014-10-20T18:57:18Z", "include_sentiment": null, "campaign_id": "1pjkp", "creative_source": "MANUAL", "deleted": false }, { "bid_type": "MAX", "name": "Untitled", "placements": [ "ALL_ON_TWITTER" ], "bid_amount_local_micro": 2500000, "automatically_select_bid": false, "advertiser_domain": null, "primary_web_event_tag": null, "charge_by": "ENGAGEMENT", "product_type": "PROMOTED_TWEETS", "bid_unit": "ENGAGEMENT", "total_budget_amount_local_micro": null, "objective": "ENGAGEMENTS", "id": "1iw6l", "paused": true, "optimization": "DEFAULT", "categories": [ ], "currency": "USD", "created_at": "2014-09-09T02:11:54Z", "updated_at": "2014-09-17T06:23:23Z", "include_sentiment": "POSITIVE_ONLY", "campaign_id": "1kv71", "creative_source": "MANUAL", "deleted": false }, { "bid_type": "MAX", "name": "Untitled", "placements": [ "ALL_ON_TWITTER" ], "bid_amount_local_micro": 2500000, "automatically_select_bid": false, "advertiser_domain": null, "primary_web_event_tag": null, "charge_by": "ENGAGEMENT", "product_type": "PROMOTED_TWEETS", "bid_unit": "ENGAGEMENT", "total_budget_amount_local_micro": null, "objective": "ENGAGEMENTS", "id": "1iw9q", "paused": false, "optimization": "DEFAULT", "categories": [ ], "currency": "USD", "created_at": "2014-09-09T03:11:46Z", "updated_at": "2014-09-09T03:26:17Z", "include_sentiment": "POSITIVE_ONLY", "campaign_id": "1kv71", "creative_source": "MANUAL", "deleted": false }, { "bid_type": "MAX", "name": "Untitled", "placements": [ "ALL_ON_TWITTER" ], "bid_amount_local_micro": 2500000, "automatically_select_bid": false, "advertiser_domain": null, "primary_web_event_tag": null, "charge_by": "ENGAGEMENT", "product_type": "PROMOTED_TWEETS", "bid_unit": "ENGAGEMENT", "total_budget_amount_local_micro": null, "objective": "ENGAGEMENTS", "id": "1iw9r", "paused": false, "optimization": "DEFAULT", "categories": [ ], "currency": "USD", "created_at": "2014-09-09T03:12:02Z", "updated_at": "2014-09-09T03:30:44Z", "include_sentiment": "POSITIVE_ONLY", "campaign_id": "1kv71", "creative_source": "MANUAL", "deleted": false }, { "bid_type": "MAX", "name": "Untitled", "placements": [ "TWITTER_TIMELINE", "TWITTER_PROFILE" ], "bid_amount_local_micro": 2000000, "automatically_select_bid": false, "advertiser_domain": null, "primary_web_event_tag": null, "charge_by": "ENGAGEMENT", "product_type": "PROMOTED_TWEETS", "bid_unit": "ENGAGEMENT", "total_budget_amount_local_micro": null, "objective": "ENGAGEMENTS", "id": "1kkze", "paused": false, "optimization": "DEFAULT", "categories": [ ], "currency": "USD", "created_at": "2014-09-24T01:18:20Z", "updated_at": "2015-08-30T04:41:34Z", "include_sentiment": null, "campaign_id": "1mj4h", "creative_source": "MANUAL", "deleted": false }, { "bid_type": "MAX", "name": "Untitled", "placements": [ "TWITTER_TIMELINE", "TWITTER_PROFILE" ], "bid_amount_local_micro": 2000000, "automatically_select_bid": false, "advertiser_domain": null, "primary_web_event_tag": null, "charge_by": "ENGAGEMENT", "product_type": "PROMOTED_TWEETS", "bid_unit": "ENGAGEMENT", "total_budget_amount_local_micro": null, "objective": "ENGAGEMENTS", "id": "1kkzk", "paused": false, "optimization": "DEFAULT", "categories": [ ], "currency": "USD", "created_at": "2014-09-24T01:23:06Z", "updated_at": "2015-08-30T04:41:34Z", "include_sentiment": null, "campaign_id": "1mj4n", "creative_source": "MANUAL", "deleted": false }, { "bid_type": "MAX", "name": "Untitled", "placements": [ "ALL_ON_TWITTER" ], "bid_amount_local_micro": 2000000, "automatically_select_bid": false, "advertiser_domain": null, "primary_web_event_tag": null, "charge_by": "ENGAGEMENT", "product_type": "PROMOTED_TWEETS", "bid_unit": "ENGAGEMENT", "total_budget_amount_local_micro": null, "objective": "ENGAGEMENTS", "id": "1kkzq", "paused": false, "optimization": "DEFAULT", "categories": [ ], "currency": "USD", "created_at": "2014-09-24T01:25:06Z", "updated_at": "2014-09-24T01:34:20Z", "include_sentiment": "POSITIVE_ONLY", "campaign_id": "1mj48", "creative_source": "MANUAL", "deleted": false }, { "bid_type": "MAX", "name": "Untitled", "placements": [ "ALL_ON_TWITTER" ], "bid_amount_local_micro": 2000000, "automatically_select_bid": false, "advertiser_domain": null, "primary_web_event_tag": null, "charge_by": "ENGAGEMENT", "product_type": "PROMOTED_TWEETS", "bid_unit": "ENGAGEMENT", "total_budget_amount_local_micro": null, "objective": "ENGAGEMENTS", "id": "1kkzr", "paused": false, "optimization": "DEFAULT", "categories": [ ], "currency": "USD", "created_at": "2014-09-24T01:25:09Z", "updated_at": "2014-09-24T01:34:41Z", "include_sentiment": "POSITIVE_ONLY", "campaign_id": "1mj48", "creative_source": "MANUAL", "deleted": false }, { "bid_type": "MAX", "name": "Untitled", "placements": [ "ALL_ON_TWITTER" ], "bid_amount_local_micro": 2000000, "automatically_select_bid": false, "advertiser_domain": null, "primary_web_event_tag": null, "charge_by": "ENGAGEMENT", "product_type": "PROMOTED_TWEETS", "bid_unit": "ENGAGEMENT", "total_budget_amount_local_micro": 6000000, "objective": "ENGAGEMENTS", "id": "1kl0e", "paused": false, "optimization": "DEFAULT", "categories": [ ], "currency": "USD", "created_at": "2014-09-24T01:42:49Z", "updated_at": "2014-09-24T01:51:25Z", "include_sentiment": "POSITIVE_ONLY", "campaign_id": "1mj57", "creative_source": "MANUAL", "deleted": false }, { "bid_type": "MAX", "name": "Untitled", "placements": [ "ALL_ON_TWITTER" ], "bid_amount_local_micro": 2000000, "automatically_select_bid": false, "advertiser_domain": null, "primary_web_event_tag": null, "charge_by": "ENGAGEMENT", "product_type": "PROMOTED_TWEETS", "bid_unit": "ENGAGEMENT", "total_budget_amount_local_micro": 12000000, "objective": "ENGAGEMENTS", "id": "1kl0g", "paused": false, "optimization": "DEFAULT", "categories": [ ], "currency": "USD", "created_at": "2014-09-24T01:43:19Z", "updated_at": "2014-09-24T01:51:40Z", "include_sentiment": "POSITIVE_ONLY", "campaign_id": "1mj57", "creative_source": "MANUAL", "deleted": false }, { "bid_type": "MAX", "name": "Untitled", "placements": [ "ALL_ON_TWITTER" ], "bid_amount_local_micro": 2000000, "automatically_select_bid": false, "advertiser_domain": null, "primary_web_event_tag": null, "charge_by": "ENGAGEMENT", "product_type": "PROMOTED_TWEETS", "bid_unit": "ENGAGEMENT", "total_budget_amount_local_micro": 6000000, "objective": "ENGAGEMENTS", "id": "1kl0l", "paused": false, "optimization": "DEFAULT", "categories": [ ], "currency": "USD", "created_at": "2014-09-24T01:45:09Z", "updated_at": "2014-09-24T01:51:54Z", "include_sentiment": "POSITIVE_ONLY", "campaign_id": "1mj5d", "creative_source": "MANUAL", "deleted": false } ], "next_cursor": null }