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 +6 -0
- package/dist/esm/index.d.ts +3 -0
- package/openapi/soundlink-public-api-v1.yaml +30 -4
- package/package.json +1 -1
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
|
package/dist/esm/index.d.ts
CHANGED
|
@@ -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
|
|
4732
|
-
|
|
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: |
|