Beginning June 3, 2024, you can use the boost_ads_list
field as a convenient and efficient way to to trace past boost Instagram ad information related to the ad. See the blog for more information.
For stats on your Instagram ads, use the Insights API from ad account to ads.
use FacebookAds\Object\Campaign;
$campaign = new Campaign(<CAMPAIGN_ID>);
$insights = $campaign->getInsights();
from facebookads.adobjects.campaign import Campaign
campaign = Campaign(<CAMPAIGN_ID>)
insights = campaign.get_insights()
curl -G \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v2.11/<CAMPAIGN_ID>/insights
If you are running a campaign on Instagram and Facebook, add breakdowns=publisher_platform, platform_position
to see the stats of Facebook and Instagram placements separately:
curl -X GET \ -d 'access_token=<ACCESS_TOKEN>' \ -d 'fields=impressions' \ -d 'breakdown=publisher_platform, platform_position' \ "https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>/insights"
The result looks like this:
{ "data": [ { "impressions": "322", "date_start": "2024-03-26", "date_stop": "2024-04-24", "publisher_platform": "instagram", "platform_position": "feed" }, { "impressions": "13", "date_start": "2024-03-26", "date_stop": "2024-04-24", "publisher_platform": "instagram", "platform_position": "instagram_explore" }, { "impressions": "168", "date_start": "2024-03-26", "date_stop": "2024-04-24", "publisher_platform": "instagram", "platform_position": "instagram_reels" }, { "impressions": "617", "date_start": "2024-03-26", "date_stop": "2024-04-24", "publisher_platform": "instagram", "platform_position": "instagram_stories" } ], "paging": { ... } }
When requesting breakdown by publisher_platform, platform_position
for insights on an ad campaign, the four placement locations in the Instagram Platform are: feed
, instagram_explore
, instagram_reels
, and instagram_stories
.
There are other breakdown combinations which include publisher_platform, platform_position
that you can use. To track performance of ads with both Facebook and Instagram placements with external tools, use the url_tags
macro SITE_SOURCE_NAME to distinguish different placements.
View tags are not publicly available. If we permit view tags by an approved vendor on Facebook mobile campaigns, we also allow them for Instagram ads. You can use Ad creative's url_tag
field with Instagram ads.
You can use third-party tracking tags for Instagram ads, however note do not optimize ads delivery for third-party tracking tools. To make sure that the third party tracking tool can track Instagram ads properly, use Ad creative's url_tag
field with utm_source=instagram
.