airbyte-source-shopify 2.5.15__py3-none-any.whl → 2.5.17__py3-none-any.whl

{airbyte_source_shopify-2.5.15.dist-info → airbyte_source_shopify-2.5.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: airbyte-source-shopify
-Version: 2.5.15
+Version: 2.5.17
 Summary: Source CDK implementation for Shopify.
 Home-page: https://airbyte.com
 License: ELv2

{airbyte_source_shopify-2.5.15.dist-info → airbyte_source_shopify-2.5.17.dist-info}/RECORD

@@ -12,7 +12,7 @@ source_shopify/schemas/collects.json,sha256=dOX0_O7meWELWHYQG_MWqGkWLelAoiIlPtDX
 source_shopify/schemas/countries.json,sha256=HrDHbtuc1WHyAzKVMqllTzcYdDmPQ2kwnEwY3MjTgyg,2161
 source_shopify/schemas/custom_collections.json,sha256=ElDY1y_G_VFPOGr9ipU022AZDWKB2LC8n8Cb6FGF8UM,3100
 source_shopify/schemas/customer_address.json,sha256=kLKylul_xK7eO_aduvDddj078k8aQLM4JtUEpa5Tp_8,2628
-source_shopify/schemas/customer_journey_summary.json,sha256=uU7rgCy1zM7cb46HzerqVSn99Y-aiKZWyGxRBFnkBhU,9113
+source_shopify/schemas/customer_journey_summary.json,sha256=GlZmIqFeR1x84DwgwMo28HQ8QseImkhvYxLSNRkUmwg,12733
 source_shopify/schemas/customer_saved_search.json,sha256=VKk7gFVdempXguprL3n5krTIpleMEPzarY7U7qfiGvw,986
 source_shopify/schemas/customers.json,sha256=pywejBEtvMnRHvvnJQhfA8NlCBjELv7XuMlKdpS4cZI,10233
 source_shopify/schemas/discount_codes.json,sha256=YxGptdpjXwM46fmzs5zoi3m96xAWKXrfllC_oIZW0vo,3730
@@ -54,7 +54,7 @@ source_shopify/scopes.py,sha256=PfqovbAvu_HZPim2kWQQUe-2rZ80Aq5yHPfNbHP87gA,6534
 source_shopify/shopify_graphql/bulk/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 source_shopify/shopify_graphql/bulk/exceptions.py,sha256=4dj7Za4xIfwL-zf8joT9svF_RSoGlE3GviMiIl1e1rs,2532
 source_shopify/shopify_graphql/bulk/job.py,sha256=_GL2WXK23yJjYcnOzuiBgpBxvng3RF_ezPhl265puz4,27635
-source_shopify/shopify_graphql/bulk/query.py,sha256=a2gkdP7ElP1eedGvXN2_OxjuX3fT5kB_4ZyA4lO9S5Q,121668
+source_shopify/shopify_graphql/bulk/query.py,sha256=jWALChkDaQ1upglE-qwv-gBCGXKjWK8vWup-o61DlB4,123798
 source_shopify/shopify_graphql/bulk/record.py,sha256=X6VGngugv7a_S8UEeDo121BkdCVLj5nWlHK76A21kyo,16898
 source_shopify/shopify_graphql/bulk/retry.py,sha256=R5rSJJE8D5zcj6mN-OmmNO2aFZEIdjAlWclDDVW5KPI,2626
 source_shopify/shopify_graphql/bulk/status.py,sha256=RmuQ2XsYL3iRCpVGxea9F1wXGmbwasDCSXjaTyL4LMA,328
@@ -67,7 +67,7 @@ source_shopify/streams/base_streams.py,sha256=-Yww6tSot5xG4MSwSK2JWHjR3DDFYM9q5L
 source_shopify/streams/streams.py,sha256=AhB73104HJNLWDTSgLdCJWcEoqsO3KxnBccOzeGNUmI,12056
 source_shopify/transform.py,sha256=mn0htL812_90zc_YszGQa0hHcIZQpYYdmk8IqpZm5TI,4685
 source_shopify/utils.py,sha256=GOIIL_UVHfgkrfI5CbDkSQi92qdgcbcGEFyZQ_A78KE,14463
-airbyte_source_shopify-2.5.15.dist-info/METADATA,sha256=4bf5Kh2K06j6x_IxPEW71DeLg8sfEkxvTmsk1LSMksI,5257
-airbyte_source_shopify-2.5.15.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-airbyte_source_shopify-2.5.15.dist-info/entry_points.txt,sha256=SyTwKSsPk9MCdPf01saWpnp8hcmZOgBssVcSIvMbBeQ,57
-airbyte_source_shopify-2.5.15.dist-info/RECORD,,
+airbyte_source_shopify-2.5.17.dist-info/METADATA,sha256=a9FmFKQqlPMaeAy2ZLfnhA5C9oh2fJP892RPGgOtr38,5257
+airbyte_source_shopify-2.5.17.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+airbyte_source_shopify-2.5.17.dist-info/entry_points.txt,sha256=SyTwKSsPk9MCdPf01saWpnp8hcmZOgBssVcSIvMbBeQ,57
+airbyte_source_shopify-2.5.17.dist-info/RECORD,,

source_shopify/schemas/customer_journey_summary.json

@@ -191,6 +191,82 @@
               "type": ["null", "string"]
             }
           }
+        },
+        "moments": {
+          "description": "The events preceding a customer's order, such as shop sessions.",
+          "type": ["null", "array"],
+          "items": {
+            "type": ["null", "object"],
+            "properties": {
+              "id": {
+                "description": "A globally-unique ID.",
+                "type": ["null", "integer"]
+              },
+              "landing_page": {
+                "description": "URL of the first page the customer landed on for the session.",
+                "type": ["null", "string"]
+              },
+              "landing_page_html": {
+                "description": "Landing page information with URL linked in HTML. For example, the first page the customer visited was",
+                "type": ["null", "string"]
+              },
+              "occurred_at": {
+                "description": "The date and time when the customer's session occurred.",
+                "type": ["null", "string"],
+                "format": "date-time"
+              },
+              "referral_code": {
+                "description": "Marketing referral code from the link that the customer clicked to visit the store.",
+                "type": ["null", "string"]
+              },
+              "referrer_url": {
+                "description": "Webpage where the customer clicked a link that sent them to the online store.",
+                "type": ["null", "string"]
+              },
+              "source": {
+                "description": "Source from which the customer visited the store, such as a platform (Facebook, Google), email, direct, a website domain, QR code, or unknown.",
+                "type": ["null", "string"]
+              },
+              "source_type": {
+                "description": "Type of marketing tactic.",
+                "type": ["null", "string"]
+              },
+              "source_description": {
+                "description": "Describes the source explicitly for first or last session.",
+                "type": ["null", "string"]
+              },
+              "utm_parameters": {
+                "description": "A set of UTM parameters gathered from the URL parameters of the referrer.",
+                "type": ["null", "object"],
+                "properties": {
+                  "campaign": {
+                    "description": "The name of a marketing campaign.",
+                    "type": ["null", "string"]
+                  },
+                  "content": {
+                    "description": "Identifies specific content in a marketing campaign. Used to differentiate between similar content or links in a marketing campaign to determine which is the most effective.",
+                    "type": ["null", "string"]
+                  },
+                  "medium": {
+                    "description": "The medium of a marketing campaign, such as a banner or email newsletter.",
+                    "type": ["null", "string"]
+                  },
+                  "source": {
+                    "description": "The source of traffic to the merchant's store, such as Google or an email newsletter.",
+                    "type": ["null", "string"]
+                  },
+                  "term": {
+                    "description": "Paid search terms used by a marketing campaign.",
+                    "type": ["null", "string"]
+                  }
+                }
+              },
+              "admin_graphql_api_id": {
+                "description": "Unique identifier for the customer in the Admin GraphQL API.",
+                "type": ["null", "string"]
+              }
+            }
+          }
         }
       }
     },

source_shopify/shopify_graphql/bulk/query.py

@@ -1105,6 +1105,29 @@ class CustomerJourney(ShopifyBulkQuery):
                                     term
                                 }
                             }
+                            customerJourney {
+                                moments {
+                                    ... on CustomerVisit {
+                                        id
+                                        landingPage
+                                        landingPageHtml
+                                        occurredAt
+                                        referralCode
+                                        referralInfoHtml
+                                        referrerUrl
+                                        source
+                                        sourceDescription
+                                        sourceType
+                                        utmParameters {
+                                            campaign
+                                            content
+                                            medium
+                                            source
+                                            term
+                                        }
+                                    }
+                                }
+                            }
                         }
                     }
                 }
@@ -1127,6 +1150,16 @@ class CustomerJourney(ShopifyBulkQuery):
         "sourceDescription",
         Field(name="utmParameters", fields=["campaign", "content", "medium", "source", "term"]),
     ]
+
+    customer_visit_fragment: List[InlineFragment] = [
+        InlineFragment(type="CustomerVisit", fields=visit_fields),
+    ]
+
+    # # use this in the next version
+    # moments_fields: List[Field] = [
+    #     Field(name="edges", fields=[Field(name="node", fields=customer_visit_fragment)]),
+    # ]
+
     customer_journey_summary_fields: List[Field] = [
         "ready",
         Field(name="momentsCount", fields=["count", "precision"]),
@@ -1134,6 +1167,8 @@ class CustomerJourney(ShopifyBulkQuery):
         "daysToConversion",
         Field(name="firstVisit", fields=visit_fields),
         Field(name="lastVisit", fields=visit_fields),
+        # # use this in the next version
+        # Field(name="moments", fields=moments_fields),
     ]
 
     query_nodes: List[Field] = [
@@ -1142,6 +1177,12 @@ class CustomerJourney(ShopifyBulkQuery):
         "createdAt",
         "updatedAt",
         Field(name="customerJourneySummary", fields=customer_journey_summary_fields),
+        Field(
+            name="customerJourney",
+            fields=[
+                Field(name="moments", fields=customer_visit_fragment),
+            ],
+        ),
     ]
 
     record_composition = {
@@ -1152,6 +1193,9 @@ class CustomerJourney(ShopifyBulkQuery):
         self,
         visit_data: Mapping[str, Any],
     ) -> MutableMapping[str, Any]:
+        if not visit_data:
+            return {}
+
         # save the id before it's resolved
         visit_data["admin_graphql_api_id"] = visit_data.get("id")
         # resolve the order_id to str
@@ -1162,14 +1206,24 @@ class CustomerJourney(ShopifyBulkQuery):
         visit_data = self.tools.fields_names_to_snake_case(visit_data)
         return visit_data
 
+    def process_moments(self, entity: List[Mapping[str, Any]]) -> List[MutableMapping[str, Any]]:
+        moments = []
+        for item in entity:
+            moments.append(self.process_visit(item))
+        return moments
+
     def process_customer_journey(self, record: MutableMapping[str, Any]) -> MutableMapping[str, Any]:
         customer_journey_summary = record.get("customerJourneySummary", {})
         if customer_journey_summary:
             # process first, last visit data
-            first_visit = customer_journey_summary.get("firstVisit", {})
-            last_visit = customer_journey_summary.get("lastVisit", {})
-            customer_journey_summary["firstVisit"] = self.process_visit(first_visit) if first_visit else {}
-            customer_journey_summary["lastVisit"] = self.process_visit(last_visit) if last_visit else {}
+            customer_journey_summary["firstVisit"] = self.process_visit(customer_journey_summary.get("firstVisit"))
+            customer_journey_summary["lastVisit"] = self.process_visit(customer_journey_summary.get("lastVisit"))
+
+            # # this will be a part of summary in the next api version
+            if customer_journey := record.get("customerJourney", {}):
+                moments = customer_journey.get("moments", [])
+                customer_journey_summary["moments"] = self.process_moments(moments)
+
         # cast field names to snake_case
         customer_journey_summary = self.tools.fields_names_to_snake_case(customer_journey_summary)
         return customer_journey_summary