soundlink 2.7.0 → 2.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # soundlink
2
2
 
3
+ ## 2.8.0
4
+
5
+ ### Minor Changes
6
+
7
+ - [#37](https://github.com/Fan-ID/typescript-sdk/pull/37) [`4e84808`](https://github.com/Fan-ID/typescript-sdk/commit/4e8480800556c4275ec647cf7059e6a94994cde3) Thanks [@jotanarciso](https://github.com/jotanarciso)! - Add per-DSP CTA fields on soundlink breakdown rows: `spotify_link_clicks`, `apple_music_link_clicks`, and `youtube_music_link_clicks` (SOU-7424).
8
+
3
9
  ## 2.7.0
4
10
 
5
11
  ### Minor Changes
@@ -660,6 +660,9 @@ interface SoundlinkBreakdownRow {
660
660
  country_code: string;
661
661
  views: number;
662
662
  link_clicks: number | null;
663
+ spotify_link_clicks: number;
664
+ apple_music_link_clicks: number;
665
+ youtube_music_link_clicks: number;
663
666
  streams: number;
664
667
  listeners: number;
665
668
  new_listeners: number | null;
@@ -2099,6 +2099,9 @@ paths:
2099
2099
  country_code: US
2100
2100
  views: 4821
2101
2101
  link_clicks: 890
2102
+ spotify_link_clicks: 820
2103
+ apple_music_link_clicks: 50
2104
+ youtube_music_link_clicks: 10
2102
2105
  streams: 203
2103
2106
  listeners: 145
2104
2107
  new_listeners: 120
@@ -2183,8 +2186,8 @@ paths:
2183
2186
  schema:
2184
2187
  $ref: '#/components/schemas/SoundlinkCountryDailyRow'
2185
2188
  example: |
2186
- {"provider":"soundlink","account_id":"a7ac3173-2f71-4e79-921f-d15d7112dd11","schema_version":"1.0","report_date":"2026-08-01","report_date_timezone":"UTC","exported_at":"2026-08-28T03:00:00Z","soundlink_id":"V1StGXR8_Z5jdHi6B-myT","soundlink_name":"Midnight Drive","soundlink_target_type":"track","soundlink_target_isrc":"DEXW62500259","soundlink_target_spotify_track_id":"11dFghVXANMlKmJXsNCbNl","soundlink_target_playlist_id":null,"country_code":"US","views":4821,"link_clicks":890,"streams":203,"listeners":145,"new_listeners":120,"returning_listeners":25,"new_listener_streams":160,"returning_listener_streams":43,"followers":12,"streams_per_listener":1.4,"ctr_lp":0.185}
2187
- {"provider":"soundlink","account_id":"a7ac3173-2f71-4e79-921f-d15d7112dd11","schema_version":"1.0","report_date":"2026-08-01","report_date_timezone":"UTC","exported_at":"2026-08-28T03:00:00Z","soundlink_id":"V1StGXR8_Z5jdHi6B-myT","soundlink_name":"Midnight Drive","soundlink_target_type":"track","soundlink_target_isrc":"DEXW62500259","soundlink_target_spotify_track_id":"11dFghVXANMlKmJXsNCbNl","soundlink_target_playlist_id":null,"country_code":"DE","views":2103,"link_clicks":31,"streams":87,"listeners":61,"new_listeners":48,"returning_listeners":13,"new_listener_streams":64,"returning_listener_streams":23,"followers":4,"streams_per_listener":1.43,"ctr_lp":0.0147}
2189
+ {"provider":"soundlink","account_id":"a7ac3173-2f71-4e79-921f-d15d7112dd11","schema_version":"1.0","report_date":"2026-08-01","report_date_timezone":"UTC","exported_at":"2026-08-28T03:00:00Z","soundlink_id":"V1StGXR8_Z5jdHi6B-myT","soundlink_name":"Midnight Drive","soundlink_target_type":"track","soundlink_target_isrc":"DEXW62500259","soundlink_target_spotify_track_id":"11dFghVXANMlKmJXsNCbNl","soundlink_target_playlist_id":null,"country_code":"US","views":4821,"link_clicks":890,"spotify_link_clicks":820,"apple_music_link_clicks":50,"youtube_music_link_clicks":10,"streams":203,"listeners":145,"new_listeners":120,"returning_listeners":25,"new_listener_streams":160,"returning_listener_streams":43,"followers":12,"streams_per_listener":1.4,"ctr_lp":0.185}
2190
+ {"provider":"soundlink","account_id":"a7ac3173-2f71-4e79-921f-d15d7112dd11","schema_version":"1.0","report_date":"2026-08-01","report_date_timezone":"UTC","exported_at":"2026-08-28T03:00:00Z","soundlink_id":"V1StGXR8_Z5jdHi6B-myT","soundlink_name":"Midnight Drive","soundlink_target_type":"track","soundlink_target_isrc":"DEXW62500259","soundlink_target_spotify_track_id":"11dFghVXANMlKmJXsNCbNl","soundlink_target_playlist_id":null,"country_code":"DE","views":2103,"link_clicks":31,"spotify_link_clicks":28,"apple_music_link_clicks":2,"youtube_music_link_clicks":0,"streams":87,"listeners":61,"new_listeners":48,"returning_listeners":13,"new_listener_streams":64,"returning_listener_streams":23,"followers":4,"streams_per_listener":1.43,"ctr_lp":0.0147}
2188
2191
  '400': { $ref: '#/components/responses/BadRequest' }
2189
2192
  '401': { $ref: '#/components/responses/Unauthorized' }
2190
2193
  '403': { $ref: '#/components/responses/Forbidden' }
@@ -4666,6 +4669,9 @@ components:
4666
4669
  - soundlink_target_type
4667
4670
  - country_code
4668
4671
  - views
4672
+ - spotify_link_clicks
4673
+ - apple_music_link_clicks
4674
+ - youtube_music_link_clicks
4669
4675
  - streams
4670
4676
  - listeners
4671
4677
  - followers
@@ -4728,8 +4734,28 @@ components:
4728
4734
  type: integer
4729
4735
  nullable: true
4730
4736
  description: |
4731
- CTA clicks across all DSPs on the landing page. Null if not tracked
4732
- for this soundlink type.
4737
+ CTA clicks across all DSPs on the landing page (including DSPs
4738
+ without a dedicated column). Always >= the sum of
4739
+ `spotify_link_clicks` + `apple_music_link_clicks` +
4740
+ `youtube_music_link_clicks` — do not derive a per-DSP count by
4741
+ subtraction. Null if not tracked for this soundlink type.
4742
+ spotify_link_clicks:
4743
+ type: integer
4744
+ description: |
4745
+ Continue sessions to Spotify from the landing page. Safe to sum
4746
+ across countries and days.
4747
+ apple_music_link_clicks:
4748
+ type: integer
4749
+ description: |
4750
+ Continue sessions to Apple Music from the landing page (outbound
4751
+ click only; no Apple Music playback attribution). Safe to sum
4752
+ across countries and days.
4753
+ youtube_music_link_clicks:
4754
+ type: integer
4755
+ description: |
4756
+ Continue sessions to YouTube Music from the landing page (outbound
4757
+ click only; no YouTube Music playback attribution). Often `0` on
4758
+ standalone soundlink marts. Safe to sum across countries and days.
4733
4759
  streams:
4734
4760
  type: integer
4735
4761
  description: |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "soundlink",
3
- "version": "2.7.0",
3
+ "version": "2.8.0",
4
4
  "description": "Official TypeScript SDK for the Soundlink Public API",
5
5
  "license": "MIT",
6
6
  "type": "module",