@cowprotocol/cow-sdk 7.1.5 → 7.2.0

package/README.md

@@ -236,6 +236,46 @@ This example demonstrates the simplest way to trade on CoW Protocol.
 For more advanced use cases, you can use additional parameters such as `receiver`, `partiallyFillable`, `validTo`, and others.
 Refer to the [Trading SDK documentation](https://github.com/cowprotocol/cow-sdk/tree/main/packages/trading/README.md) for comprehensive details.
 
+## Developer Attribution (UTM Tracking)
+
+The SDK automatically includes UTM tracking in all orders to attribute trading volume to developers. Default parameters:
+
+```typescript
+{
+  utmSource: 'cowmunity',
+  utmMedium: 'cow-sdk@7.1.6',  // SDK version
+  utmCampaign: 'developer-cohort',
+  utmContent: '',
+  utmTerm: 'js'
+}
+```
+
+**Customize or disable** via `advancedSettings.appData.metadata.utm`:
+
+```typescript
+// Custom UTM
+await sdk.getQuote(parameters, {
+  appData: {
+    metadata: {
+      utm: { utmContent: 'my-integration-v2' }
+    }
+  }
+})
+
+// Disable UTM
+await sdk.getQuote(parameters, {
+  appData: {
+    metadata: {
+      utm: {}
+    }
+  }
+})
+```
+
+> **Note:** Providing any `utm` field gives you full control - the SDK will not add defaults.
+
+> **Tip:** Use `utmContent` for graffiti without affecting your `appCode`. The `appCode` parameter tracks your integration on [CoW Protocol's Dune dashboards](https://dune.com/cowprotocol/cowswap), while `utmContent` is available for custom identifiers or experimentation - all while attributing your volume to SDK integrators' collective impact.
+
 
 ## Adapters
 

package/dist/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [7.2.0](https://github.com/cowprotocol/cow-sdk/compare/cow-sdk-v7.1.6...cow-sdk-v7.2.0) (2025-12-03)
+
+
+### ✨ Features
+
+* **app-data:** add UTM Tracking for Developer Attribution ([#722](https://github.com/cowprotocol/cow-sdk/issues/722)) ([0cd79d1](https://github.com/cowprotocol/cow-sdk/commit/0cd79d185630cc44b111979e873e30c760904976))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @cowprotocol/sdk-app-data bumped to 4.3.2
+    * @cowprotocol/sdk-trading bumped to 0.6.0
+
+## [7.1.6](https://github.com/cowprotocol/cow-sdk/compare/cow-sdk-v7.1.5...cow-sdk-v7.1.6) (2025-12-01)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @cowprotocol/sdk-order-book bumped to 0.4.0
+    * @cowprotocol/sdk-order-signing bumped to 0.1.16
+    * @cowprotocol/sdk-trading bumped to 0.5.4
+
 ## [7.1.5](https://github.com/cowprotocol/cow-sdk/compare/cow-sdk-v7.1.4...cow-sdk-v7.1.5) (2025-11-27)
 
 

package/dist/README.md

@@ -236,6 +236,46 @@ This example demonstrates the simplest way to trade on CoW Protocol.
 For more advanced use cases, you can use additional parameters such as `receiver`, `partiallyFillable`, `validTo`, and others.
 Refer to the [Trading SDK documentation](https://github.com/cowprotocol/cow-sdk/tree/main/packages/trading/README.md) for comprehensive details.
 
+## Developer Attribution (UTM Tracking)
+
+The SDK automatically includes UTM tracking in all orders to attribute trading volume to developers. Default parameters:
+
+```typescript
+{
+  utmSource: 'cowmunity',
+  utmMedium: 'cow-sdk@7.1.6',  // SDK version
+  utmCampaign: 'developer-cohort',
+  utmContent: '',
+  utmTerm: 'js'
+}
+```
+
+**Customize or disable** via `advancedSettings.appData.metadata.utm`:
+
+```typescript
+// Custom UTM
+await sdk.getQuote(parameters, {
+  appData: {
+    metadata: {
+      utm: { utmContent: 'my-integration-v2' }
+    }
+  }
+})
+
+// Disable UTM
+await sdk.getQuote(parameters, {
+  appData: {
+    metadata: {
+      utm: {}
+    }
+  }
+})
+```
+
+> **Note:** Providing any `utm` field gives you full control - the SDK will not add defaults.
+
+> **Tip:** Use `utmContent` for graffiti without affecting your `appCode`. The `appCode` parameter tracks your integration on [CoW Protocol's Dune dashboards](https://dune.com/cowprotocol/cowswap), while `utmContent` is available for custom identifiers or experimentation - all while attributing your volume to SDK integrators' collective impact.
+
 
 ## Adapters
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cowprotocol/cow-sdk",
-  "version": "7.1.5",
+  "version": "7.2.0",
   "license": "(MIT OR Apache-2.0)",
   "description": "CoW Protocol SDK - get quote, configure your order, and trade",
   "main": "./dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cowprotocol/cow-sdk",
-  "version": "7.1.5",
+  "version": "7.2.0",
   "license": "(MIT OR Apache-2.0)",
   "description": "CoW Protocol SDK - get quote, configure your order, and trade",
   "main": "./dist/index.js",
@@ -30,13 +30,13 @@
     "@cow-sdk/typescript-config": "0.0.0-beta.0"
   },
   "dependencies": {
-    "@cowprotocol/sdk-app-data": "4.3.1",
+    "@cowprotocol/sdk-common": "0.4.0",
     "@cowprotocol/sdk-config": "0.4.1",
     "@cowprotocol/sdk-contracts-ts": "0.7.1",
-    "@cowprotocol/sdk-order-book": "0.3.2",
-    "@cowprotocol/sdk-trading": "0.5.3",
-    "@cowprotocol/sdk-order-signing": "0.1.15",
-    "@cowprotocol/sdk-common": "0.4.0"
+    "@cowprotocol/sdk-order-signing": "0.1.16",
+    "@cowprotocol/sdk-order-book": "0.4.0",
+    "@cowprotocol/sdk-trading": "0.6.0",
+    "@cowprotocol/sdk-app-data": "4.3.2"
   },
   "peerDependencies": {
     "@openzeppelin/merkle-tree": "^1.x",