2024-01 Instagram Social upgrade to Graph API v18

This topic 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 use 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

• Time frame
• 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 you do not take any action, the platform will return null values for deprecated columns.

To maintain the Target table without these deprecated columns, please remove them from the schema mapping under the Schema tab of your Data Flows. Ensure that your configurations are updated accordingly to accommodate the changes introduced by the latest API version.