The following document describes how to set up a campaign for Spotify. Kochava enhances your install and event data with the Spotify ad impression or click metadata directly from Spotify to allow for extremely accurate and complete data.
Data Needed Before Beginning Process:
- Spotify App ID
- Partner App ID
- Spotify Event Name
Create a Link for a Spotify Install Campaign
- Log in to Kochava.
- Select the desired Account and App.
- Select Engagement > Campaign Manager.
- Click + Add (Tracker) or Select Segment Tools (⋮) > Add Tracker.
- Enter the Tracker Name.
- Select Tracker Type > Acquisition. (default setting)
- Select Media Partner > Spotify.
- Select Agency Partner. (optional)
- Enter the Destination URL.
- Enter a Deep Link. (optional)
- Enter any Custom Parameter(s). (optional)
- Click Save. (If no further trackers need to be created)
- Click Save & Add Another Tracker. (If additional trackers need to be created)
- Click Save & Create Postback (to navigate directly to the Partner Configuration page).
Install Postback Configuration
- Select Apps & Assets > Partner Configuration.
- Click + Add a Configuration.
- Select Media Partner > Spotify.
- Click Save.
- Select Install > 🖉 (Edit).
- Enter the Spotify App ID.
- Enter the Partner App ID.
- Select the Spotify Event Name > install.
- Click Save.
Reengagement Configuration
The information within this section provides the steps necessary to establish a reengagment campaign. If a reengagment campaign does not need to be created, the information in this section may be disregarded.
Create a Reengagement Segment:
- Locate the desired Campaign.
- Select Campaign Tools (⋮) > Add a Segment.
- Enter a Segment Name.
- Enter a Segment Description. (optional)
- Click Submit.
Create a Reengagement Tracker:
- Click + Add (Tracker) or Select Segment Tools (⋮) > Add Tracker.
- Enter a Tracker Name.
- Select Tracker Type > Reengagement.
- Select Media Partner > Spotify.
- Select an Agency Partner. (optional)
- Select the Spotify Event that will map to the selected Kochava event.
- Add Reengagement Event.
- Click Save (If no further trackers need to be created).
- Click Save & Add Another Tracker (If additional events need to be created).
- Click Save & Create Postback (to navigate directly to the Partner Configuration page).
Post-Install Event Postback Configuration:
- Select Apps & Assets > Partner Configuration.
- Expand Spotify Postbacks.
- Locate the desired event and Click + (Create) for a new configuration or 🖉 (Edit) for an existing configuration.
- Enter the Spotify App ID.
- Enter the Partner App ID.
- Select the Spotify Event Name.
- Select the Delivery Method.
- Click Save.
Standard Post-Install Event List:
Key | Description |
---|---|
session_start | When a user successfully launches an instant of the app. |
page_view | The user has viewed the page content. |
start_trial | When a user successfully signs up for a given trial product. |
subscribe | When a user pays for a subscription within a 24-hour lookback of exposure (impression or click) to a media campaign. |
registration_complete | When a user completes a user registration. |
sign_up | When a user completes an app sign up. |
sign_in | When a user completes an app sign in. |
search | When a user completes a search. |
share_with_friend | Link shared with contact. |
content_view | The user has viewed the ad content. |
first_video_view | When the user makes the initial video view. |
video_stream | Video complete. |
add_to_cart | Item has been added to cart. |
checkout_start | Checkout process has been started. |
purchase | Item has been purchased. |
ad_view | The user has viewed the ad content. |
ad_click | The user has clicked the ad content. |
Click and Impression Attribution Macros:
Click-through attribution, also known as click tracking, is the term used when a click leads to a user action within a certain attribution window. View-through attribution, also known as impression tracking, is the term used when an impression leads to a user action within a certain attribution window. The attribution window is supported for 7 day click lookback and 7 day impression lookback to meet your business needs.
URL Parameters | Description | Type |
---|---|---|
campaign_group | Group of the campaign | string |
campaign_name | Name of the campaign. | string |
campaign_id | ID of the campaign. | string |
creative_name | Name of the creative | string |
creative_id | ID of the creative. | string |
site_id | ID of the site that served the ad. | string |
line_item_id | The LineItemId of the creative displayed | string |
country | 2 Digit country code where ad was served. | string |
timestamp | Unix timestamp in seconds. | integer |
platform | Platform of the device. | string |
Example Attribution Response
Match:
{
"success": true,
“attributionMode”: “BMA”,
"type": "impression",
"metadata": {
"creative_id": "Sample Creative",
"site_id": "e734bc1af39681954243918812cb7009",
"unix_date": "1476137388"
},
"match": {
"idfa": "EA7583CD-A667-48BC-B806-42ECB2B48606"
}
}
No Match:
{
"success": false,
"attribution_mode": "BMA",
"type": null,
"matched_by": null,
"matched_by_keys": null,
"metadata": null,
"match": null
}