2024-01 Instagram Social upgrade to Graph API v18
This document details the technical modifications implemented in the upgrade to Graph API Version 18 for Data Integration Instagram Social connector. The changes primarily impact the Reports section, involving the deprecation of certain metrics and introducing new ones.
Effective Date: Tuesday, January 9th, 2024.
Changes in Graph API version 18
Insights media all medias predefined report
Deprecated metrics
Story metrics:
- taps_forward
- taps_back
- exits
Carousel album metrics:
- carousel_album_impression
- carousel_album_reach
- carousel_album_engagement
- carousel_album_saved
- carousel_album_video_views
New metrics
Album metrics:
- total_interactions
- impressions
- reach
- saved
- video_views
Deprecated fields
- taps_forward_lifetime
- taps_back_lifetime
- exits_lifetime
- carousel_album_impressions_lifetime
- carousel_album_reach_lifetime
- carousel_album_engagement_lifetime
- engagement_lifetime
New fields
- comments_lifetime
- date
- end_time
- permalink
- username
- ig_id
- media_type
- comments_count
- owner
- timestamp
- caption
- like_count
- acc_id
- media_id
- likes_lifetime
- shares_lifetime
- total_interactions_lifetime
- navigation_lifetime
- is_story
- profile_visits_lifetime
Insights account lifetime predefined report
Deprecated metrics
Metrics (Account):
- audience_gender_age
- audience_locale
- audience_country
- audience_city
Deprecated fields
- audience_gender_age_lifetime
- audience_locale_lifetime
- audience_country_lifetime
- audience_city_lifetime
Insights media image predefined report
Deprecated metrics
Video and image metrics:
- engagement
New metrics
- total_interactions
Deprecated fields
- engagement_lifetime
New fields
- comments_lifetime
- date
- end_time
- timestamp
- permalink
- username
- comments_count
- caption
- media_type
- owner
- like_count
- acc_id
- media_id
- likes_lifetime
- shares_lifetime
- total_interactions_lifetime
- follows_lifetime
- profile_activity_lifetime
- profile_visits_lifetime
Insights media story predefined report
Deprecated metrics
Story metrics:
- taps_forward
- taps_back
- exits
Deprecated fields
- taps_forward_lifetime
- taps_back_lifetime
- exits_lifetime
New fields
- navigation_lifetime
- end_time
- date
- permalink
- timestamp
- media_type
- ig_id
- owner
- acc_id
- media_id
- profile_visits_lifetime
- is_story
- username
- caption
- shares_lifetime
- total_interactions_lifetime
- follows_lifetime
- profile_activity_lifetime
Insights media carousel predefined report
Deprecated metrics
Carousel album metrics:
- carousel_album_impressions
- carousel_album_reach
- carousel_album_engagement
- carousel_album_saved
- carousel_album_video_views
New metrics
Album metrics:
- total_interactions
- impressions
- reach
- saved
- video_views
Deprecated fields
- carousel_album_impressions_lifetime
- carousel_album_reach_lifetime
- carousel_album_engagement_lifetime
New fields
- total_interactions_lifetime
Insights media video predefined report
New fields
- comments_lifetime
- date
- end_time
- timestamp
- permalink
- username
- comments_count
- caption
- media_type
- owner
- like_count
- ig_id
- acc_id
- media_id
- likes_lifetime
- shares_lifetime
- total_interactions_lifetime
Insights media custom report
Deprecated metrics
Metrics:
- audience_gender_age
- audience_locale
- audience_country
- audience_city
Video and image metrics:
- engagement
Album metrics:
- carousel_album_impressions
- carousel_album_reach
- carousel_album_engagement
- carousel_album_saved
- carousel_album_video_views
Story metrics:
- taps_forward
- taps_back
- exits
Deprecated fields
Media Fields:
- video_title
Instagram categorized the Metrics into two groups: Legacy, which comprises the older ones, and New Metrics. To facilitate the use of both, we have implemented the Metrics Type radio button.
Insights account custom report
Legacy metrics:
- Account Metrics
New metrics:
-
Interactions:
- impressions
- reach
- total_interactions
- accounts_engaged
- likes
- comments
- saved
- shares
- replies
- follows_and_unfollows
- profile_links_taps
- website_clicks
- profile_views
-
Demographics:
- engaged_audience_demographics
- reached_audience_demographics
- follower_demographics
-
Breakdown:
- contact_button_type
- follow_type
- media_product_type
- age
- city
- country
- gender
-
Timeframe
-
Results metric type
Insights media custom report
Legacy metrics:
-
Photo and video metrics
-
Reels metrics:
- clips_replays_count
- comments
- ig_reels_aggregated_all_plays_count
- ig_reels_avg_watch_time
- ig_reels_video_view_total_time
- likes
- plays
- reach
- saved
- shares total_interactions
-
Story metrics
-
Album metrics
New metrics:
-
Post metrics:
- comments
- follows
- likes
- profile_activity
- profile_visits
- shares
- total_interactions
-
Story metrics (Not the same as our current "Story Metrics" in Legacy Metrics Type):
- follows
- navigation
- profile_activity
- profile_visits
- shares
- total_interactions
-
Breakdown
What actions should you take?
If no action is taken, deprecated columns will be retrieved with null values.
To maintain the Target table without these deprecated columns, please remove them from the schema mapping under the Schema tab of your Rivers. Ensure that your configurations are updated accordingly to accommodate the changes introduced by the latest API version.
