SiriusXM Quick Start Guide

This is a guide to help you get started on sending your conversion events to SiriusXM via Freshpaint.

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

Destination Info

• Supports Track calls

• Supports HIPAA mode

• Supports forwarding from the Google Tag Manager Integration

• Supports Freshpaint Impression Pixel

• Refer to this destination as SiriusXM in the Integrations object

  • If you've configured multiple App Names, you can choose a specific one by suffixing the App Name, such as: SiriusXM::my_app_name. You can retrieve this value from the SiriusXM configuration page.

When no suffix is specified, all configured App Names are selected for inclusion / exclusion.

• Connection Modes:

	Client-side	Server-side
Web
Mobile
Server

Getting Started

What You'll Need

1. Your SiriusXM App Name

2. App Name configured in Freshpaint

3. [If in HIPAA mode] Allowlist set up to allow Freshpaint to forward properties to SiriusXM for attribution

4. Impression pixel enabled to allow Freshpaint to do view through conversion attribution

To set up SiriusXM with Freshpaint, follow these steps:

1. Make sure you have the appropriate access in both Freshpaint and SiriusXM:

   1. Contact your Freshpaint Account Manager to request access to this destination. Once you have that, we will help you step by step through the configuration process.

   2. Create your conversion funnel, and create events in Freshpaint to track your conversions.

2. Find your App Name in your SiriusXM account.

3. Set the App Name in Freshpaint.

Setting app name in Freshpaint

1. [If in HIPAA mode] Set the Freshpaint allowlist for SiriusXM to allow Freshpaint to forward siriusxm_aid to SiriusXM. This is a required property for the destination to be able to forward conversion events to SiriusXM.

Required allowlist settings while in HIPAA mode

1. Enable the impression pixel for SiriusXM. This enables Freshpaint to do view through attribution within Freshpaint and report the conversion event to SiriusXM. We recommend enabling IP matching and setting the Conversion Window to at least 30 days for the best results.

Impression pixel setup for SiriusXM

Configuring the impression pixel does not require sharing an IP address with SiriusXM. Freshpaint will do attribution by matching the IP address to an impression that is seen by the Freshpaint Impression Pixel, and if a match is found, it will send the ad id to SiriusXM.

1. Configure your media with SiriusXM. This will allow Freshpaint to capture impression IDs to be able to send SiriusXM attributable conversion events. The parameters added here are also the ones that are required or recommended to be allowlisted.

   1. For impression tracking: Please contact your SiriusXM representative via email for Freshpaint impression pixel support. The URL format that you send can be copied from the Pixel Configuration URL for step 5 and should look like https://freshpaint-impression.com/pixel.png?env_id=<your-env-id>&dest_id=<your-dest-id>&cke=1&$siriusxm_aid=[aid]&$siriusxm_oid=[oid]&$siriusxm_cid=[cid]. You will also need to send the pixel url's corresponding App Name (see step 3) . Current SiriusXM partner email addresses are [email protected] and [email protected].

Set up Test Campaign in SiriusXM

1. Set up a test campaign that targets a small audience

2. Attach a creative that has the Freshpaint Impression Pixel

3. Verify impressions and clicks are flowing into Freshpaint correctly by working with your Customer Success Engineer

4. Verify in Freshpaint that the events are triggering and flowing through to successfully to SiriusXM by using Freshpaint's Liveview and Event Verification tools

Confirm events are triggering and sending to SiriusXM successfully

Further reading

Looking for more information? See SiriusXM Reference.