Source Instagram: Remove Deprecated Metrics (#55860)

Co-authored-by: Octavia Squidington III <[email protected]>
Co-authored-by: daniel.i.jablonski <[email protected]>
Co-authored-by: Danylo Jablonski <[email protected]>

Author: 3 people

airbyte-integrations/connectors/source-instagram/erd/discovered_catalog.json

@@ -175,10 +175,6 @@
             "description": "The total watch time of Instagram Reels videos in seconds.",
             "type": ["null", "number"]
           },
-          "impressions": {
-            "description": "The number of times the media has been displayed to users.",
-            "type": ["null", "integer"]
-          },
           "reach": {
             "description": "The number of unique users who have seen the media.",
             "type": ["null", "integer"]
@@ -207,18 +203,6 @@
             "description": "The total number of interactions (likes, comments, shares) on the media.",
             "type": ["null", "integer"]
           },
-          "plays": {
-            "description": "The number of times the media has been played.",
-            "type": ["null", "integer"]
-          },
-          "ig_reels_aggregated_all_plays_count": {
-            "description": "The number of times of Instagram Reels gets reproduced after an impression is counted.",
-            "type": ["null", "integer"]
-          },
-          "clips_replays_count": {
-            "description": "The number of times the reel gets reproduced after the first one.",
-            "type": ["null", "integer"]
-          },
           "follows": {
             "description": "The number of accounts that started to follow the profile.",
             "type": ["null", "integer"]
@@ -427,10 +411,6 @@
             "description": "The unique identifier of the story insights record.",
             "type": ["null", "string"]
           },
-          "impressions": {
-            "description": "The number of times the story was viewed.",
-            "type": ["null", "integer"]
-          },
           "reach": {
             "description": "The number of unique accounts that viewed the story.",
             "type": ["null", "integer"]
@@ -509,10 +489,6 @@
             "description": "The number of clicks to get directions to the user's business location.",
             "type": ["null", "integer"]
           },
-          "impressions": {
-            "description": "The total number of times the user's content has been displayed.",
-            "type": ["null", "integer"]
-          },
           "phone_call_clicks": {
             "description": "The number of clicks to call the user's business phone number.",
             "type": ["null", "integer"]
@@ -533,18 +509,10 @@
             "description": "The number of clicks on the website link in the user's profile.",
             "type": ["null", "integer"]
           },
-          "impressions_week": {
-            "description": "The total number of impressions in the last week.",
-            "type": ["null", "integer"]
-          },
           "reach_week": {
             "description": "The total reach in the last week.",
             "type": ["null", "integer"]
           },
-          "impressions_days_28": {
-            "description": "The total number of impressions in the last 28 days.",
-            "type": ["null", "integer"]
-          },
           "reach_days_28": {
             "description": "The total reach in the last 28 days.",
             "type": ["null", "integer"]

airbyte-integrations/connectors/source-instagram/erd/source.dbml

@@ -25,17 +25,13 @@ Table "media_insights" {
     "id" string [pk]
     "ig_reels_avg_watch_time" number
     "ig_reels_video_view_total_time" number
-    "impressions" integer
     "reach" integer
     "saved" integer
     "video_views" integer
     "comments" integer
     "likes" integer
     "shares" integer
     "total_interactions" integer
-    "plays" integer
-    "ig_reels_aggregated_all_plays_count" integer
-    "clips_replays_count" integer
     "follows" integer
     "profile_visits" integer
 }
@@ -88,7 +84,6 @@ Table "story_insights" {
     "business_account_id" string
     "page_id" string
     "id" string
-    "impressions" integer
     "reach" integer
     "replies" integer
     "follows" integer
@@ -108,15 +103,12 @@ Table "user_insights" {
     "date" string
     "follower_count" integer
     "get_directions_clicks" integer
-    "impressions" integer
     "phone_call_clicks" integer
     "profile_views" integer
     "reach" integer
     "text_message_clicks" integer
     "website_clicks" integer
-    "impressions_week" integer
     "reach_week" integer
-    "impressions_days_28" integer
     "reach_days_28" integer
     "online_followers" object
     "email_contacts" integer

airbyte-integrations/connectors/source-instagram/metadata.yaml

@@ -7,7 +7,7 @@ data:
   connectorSubtype: api
   connectorType: source
   definitionId: 6acf6b55-4f1e-4fca-944e-1a3caef8aba8
-  dockerImageTag: 3.2.5
+  dockerImageTag: 4.0.0
   dockerRepository: airbyte/source-instagram
   githubIssueLabel: source-instagram
   icon: instagram.svg
@@ -26,6 +26,13 @@ data:
   releaseStage: generally_available
   releases:
     breakingChanges:
+      4.0.0:
+        message: "This release removes deprecated metrics - `clips_replays_count`, `ig_reels_aggregated_all_plays_count`, `impressions`, and `plays` from `media_insights` stream, and `impressions` from `user_insights` and `story_insights` streams. Customers who these streams must take action with their connections. For more details, see our <a href='https://docs.airbyte.com/integrations/sources/instagram-migrations'>migration guide</a>."
+        upgradeDeadline: "2025-04-21"
+        scopedImpact:
+          - scopeType: stream
+            impactedScopes:
+              ["media_insights", "user_insights", "story_insights"]
       3.0.0:
         message: "The existing Instagram API (v11) has been deprecated. Customers who use streams `Media Insights`, `Story Insights` or `User Lifetime Insights` must take action with their connections. Please follow the to update to the latest Instagram API (v18). For more details, see our <a href='https://docs.airbyte.com/integrations/sources/instagram-migrations'>migration guide</a>."
         upgradeDeadline: "2024-01-05"