Ads and Commerce
Ads and Commerce
Resources
Insights
Updated: May 8, 2024
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_assetdescription_assetimage_assettitle_assetcall_to_action_assetlink_url_assetvideo_assetad_format_asset
You can combine these in your results with these breakdowns:
agegenderage,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"
}
Did you find this page helpful?
