2024-01 Instagram Social Upgrade to Graph API v18
  • 1 Minute to read
  • Dark
    Light
  • PDF

2024-01 Instagram Social Upgrade to Graph API v18

  • Dark
    Light
  • PDF

Article Summary

Introduction

This document details the technical modifications implemented in the upgrade to Graph API Version 18 for Rivery's 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

  • total_interactions_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

  • total_interactions_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

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 Custom Report

Deprecated Metrics

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

Insights Media Custom Report

Deprecated Metrics

Metrics:

  • audience_gender_age
  • audience_locale
  • audience_country
  • audience_city

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.


Was this article helpful?