Spotify Conversions API Quick Start Guide

The Spotify Conversions API destination is currently in Early Access. Please contact [email protected] for more information about this integration.

Destination Info

• Supports Track calls

• Supports HIPAA mode

• Refer to this destination as Spotify Conversions API in the Integrations object

• Connection Modes:

	Client-side	Server-side
Web
Mobile
Server

Getting Started

This guide enables you to fully enable the Spotify Conversions API destination for your site. For simplicity the event used for demonstration purposes is the generic Page View event. For more complex events see our additional documentation. Additionally this guide assumes you have the Freshpaint snippet installed on your site, if you do not please follow this guide.

1. Find/create your Spotify Connection ID

2. Find/create your Spotify Access Token

3. Enable the Freshpaint Spotify destination

   • If in HIPAA mode enable the required fields

4. Confirm and validate events

Find your Spotify Connection ID

If you do not have an existing Spotify data source, please refer to the "Create a new Spotify Connection" section instead.

1. Log in to your Spotify Ads Manager.

2. From the top-left menu select Events.

1. Click on the data source you'd like to use (Note: this must be a Conversions API data source as it will not work with a Spotify Pixel data source).

1. From the data source page, click View Instructions.

1. Copy the Connection ID and copy or generate token as needed.

Create a new Spotify Connection

If you already have an existing Spotify data source you'd like to use, please refer to the "Find your Spotify Connection ID" section instead.

1. Log in to your Spotify Ads Manager.

2. From the top-left menu select Events.

1. Click on the Connect Data Source button and choose the Conversions API option

1. Choose a name for the source and optionally choose the ad accounts with access

1. You will next be guided to a page that has your Connection ID. Click the Generate Token button in order to set up the needed authentication.

2. Copy the Connection ID and copy or generate token as needed.

Enable the Freshpaint Spotify Conversions API destination

1. Navigate to the Freshpaint Destinations page.

2. Search for the Spotify Conversions API destination.

3. Select Configure to paste your Connection ID and Access Token from the above steps.

4. Customers that use HIPAA mode should then configure the required, recommended, and recommended view-through properties. You can find all properties that the Freshpaint Spotify integration supports here: Spotify Conversions API Reference.

5. Enable Spotify.

Once you've followed the steps above you can start sending events to Spotify Conversions API.

Confirm and validate events

Confirm and Validate Conversions in Freshpaint

1. Navigate to your site and visit a page that should trigger your event

2. Trigger your event (Our demonstration event is a Sign Up).

3. Navigate to the Event Verification tool.

4. Select Spotify Conversions API and verify your event went through.

   • This can take up to 90 seconds.

5. Verify the event is marked as OK or resolve missing property issues.

Our Spotify event went through smoothly with all required properties in place

Confirm and Validate Conversions in Spotify

To check whether Spotify is receiving events.

1. Log in to your Spotify Ads Manager.

2. From the top-left menu select Events.

3. See that your data source has a status of Receiving. Click to spot check events.

4. You should see events coming through under the large graph under Event Activity on this page.