Insights

You can read insights for ad set and ad objects using Dynamic Creative, Placement Asset Customization and Segment Asset Customization.

In Ads Manager, you can view your asset level breakdowns. Using the API, you can get the following breakdowns:

  • body_asset
  • description_asset
  • image_asset
  • title_asset
  • call_to_action_asset
  • link_url_asset
  • video_asset
  • ad_format_asset

You can combine these in your results with these breakdowns:

  • age
  • gender
  • age, gender

For Dynamic Creative, we currently show only creative-asset level breakdowns such as metrics by image, title, body, video. Insights on full delivered ads are found in Ads Manager under By Dynamic Creative Asset.

Build Your Query

Get the following fields in your query:

Field Description

actions

Number of actions taken on your ad, grouped by action type.

clicks

Total number of clicks on your ad.

impressions

Number of times your ad was served.

Facebook supports different values derived from the fields above. For example you can also retrieve ctr and actions_per_impressions.

Examples

To retrieve insights for an ad with the body_asset breakdown:

curl -G 
-d "breakdowns=body_asset" 
-d "fields=impressions" 
-d "access_token=<ACCESS_TOKEN>" 
https://graph.facebook.com/<API_VERSION>/<AD_ID>/insights

A sample response looks like this:

{
  "data": [
    {
      "impressions": "8801",
      "date_start": "2016-04-29",
      "date_stop": "2016-05-13",
      "body_asset": {
        "text": "Test text",
        "id": "6051732675652"
      }
    },
    {
      "impressions": "7558",
      "date_start": "2016-04-29",
      "date_stop": "2016-05-13",
      "body_asset": {
        "text": "Test ext new",
        "id": "6051732676452"
      }
    },
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MgZDZD"
    }
  }}

To retrieve insights for an ad set broken down by image_asset and age:

curl -G 
-d "breakdowns=image_asset,age" 
-d "fields=impressions" 
-d "access_token=<ACCESS_TOKEN>" 
https://graph.facebook.com/<API_VERSION>/<ADSET_ID>/insights

A sample response looks like this:

{
  "data": [
    {
      "impressions": "5497",
      "date_start": "2016-04-29",
      "date_stop": "2016-05-13",
      "image_asset": {
        "hash": "<REDACTED>",
        "url": "<REDACTED>",
        "id": "6051732672052"
      }
    },
    {
      "impressions": "5962",
      "date_start": "2016-04-29",
      "date_stop": "2016-05-13",
      "image_asset": {
        "hash": "<REDACTED>",
        "url": "<REDACTED>",
        "id": "6051732672652"
      }
    },
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MwZDZD"
    }