Today we are announcing the availability of additional analytics metrics for the MEDIA and WEB_CONVERSION metric groups. Please note that these changes are additive—all previous metrics are still available.
MEDIA
We have added the media_engagements metric, which corresponds to the total number of clicks of media across Videos, Vines, GIFs, and Images.
WEB_CONVERSION
We now include a breakdown of each conversion metric by both view and engagement. For example, conversion_purchases now includes sale_amount_view as well as sale_amount_engagement.
Twitter Ads API Team
Example requests and responses:
MEDIA
$ twurl -H ads-api.twitter.com "/1/stats/accounts/18ce54d4x5t?entity=LINE_ITEM&entity_ids=6vn5g&start_time=2016-11-24&end_time=2016-11-26&granularity=DAY&placement=ALL_ON_TWITTER&metric_groups=MEDIA" | jq
{
"data_type": "stats",
"time_series_length": 2,
"data": [
{
"id": "6vn5g",
"id_data": [
{
"segment": null,
"metrics": {
"media_views": [
0,
45
],
"media_engagements": [
0,
10
]
}
}
]
}
],
"request": {
"params": {
"start_time": "2016-11-24T08:00:00Z",
"segmentation_type": null,
"entity_ids": [
"6vn5g"
],
"end_time": "2016-11-26T08:00:00Z",
"country": null,
"placement": "ALL_ON_TWITTER",
"granularity": "DAY",
"entity": "LINE_ITEM",
"platform": null,
"metric_groups": [
"MEDIA"
]
}
}
}
WEB_CONVERSION
$ twurl -H ads-api.twitter.com "/1/stats/accounts/18ce54d4x5t?entity=CAMPAIGN&entity_ids=6i0y1&start_time=2016-11-24&end_time=2016-11-26&granularity=TOTAL&placement=ALL_ON_TWITTER&metric_groups=WEB_CONVERSION" | jq
{
"data_type": "stats",
"time_series_length": 1,
"data": [
{
"id": "6i0y1",
"id_data": [
{
"segment": null,
"metrics": {
"conversion_purchases": {
"order_quantity_engagement": [
5000000
],
"sale_amount_engagement": [
100000000
],
"sale_amount_view": [
177990000
],
"post_view": [
2
],
"order_quantity": [
15000000
],
"assisted": null,
"post_engagement": [
1
],
"sale_amount": [
277990000
],
"metric": [
3
],
"order_quantity_view": [
10000000
]
},
"conversion_sign_ups": {
"order_quantity_engagement": null,
"sale_amount_engagement": null,
"sale_amount_view": null,
"post_view": null,
"order_quantity": null,
"assisted": null,
"post_engagement": null,
"sale_amount": null,
"metric": null,
"order_quantity_view": null
},
"conversion_site_visits": {
"order_quantity_engagement": null,
"sale_amount_engagement": null,
"sale_amount_view": null,
"post_view": [
28
],
"order_quantity": null,
"post_engagement": [
28
],
"sale_amount": null,
"metric": [
56
],
"order_quantity_view": null
},
"conversion_custom": {
"order_quantity_engagement": null,
"sale_amount_engagement": null,
"sale_amount_view": null,
"post_view": null,
"order_quantity": null,
"post_engagement": null,
"sale_amount": null,
"metric": null,
"order_quantity_view": null
},
"conversion_downloads": {
"order_quantity_engagement": null,
"sale_amount_engagement": null,
"sale_amount_view": null,
"post_view": null,
"order_quantity": null,
"post_engagement": null,
"sale_amount": null,
"metric": null,
"order_quantity_view": null
}
}
}
]
}
],
"request": {
"params": {
"start_time": "2016-11-24T08:00:00Z",
"segmentation_type": null,
"entity_ids": [
"6i0y1"
],
"end_time": "2016-11-26T08:00:00Z",
"country": null,
"placement": "ALL_ON_TWITTER",
"granularity": "TOTAL",
"entity": "CAMPAIGN",
"platform": null,
"metric_groups": [
"WEB_CONVERSION"
]
}
}
}
