Announcement: Additional stats metrics

announcements
analytics

#1

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"
      ]
    }
  }
}

Purchase - sale amount through API
Media engagement metric question
#2

#3