Attachments
ToneDen has two types of incentivized social growth campaigns available: Social Unlocks and Contests. These two campaign types share a single data model: the Attachment. Each Attachment has a type parameter which specifies whether the attachment is a social unlock (type = "unlock") or a contest (type = "contest").
Attachment URLs
Each attachment has an external-facing landing page where fans can enter the contest or perform the unlock action. The URL of the landing page is of the format https://www.toneden.io/<owner username>/post/<attachment.link_path>.
Social Actions
Each attachment has one or more social actions that fans can perform to enter the contest or unlock the reward. The social actions are stored in the platform field for single-action unlocks, and platforms for contests and multi-action unlocks. Below is a table listing each social action.
| Action Name | Additional Fields (* = optional) | Description |
|---|---|---|
| Requires fan to connect their Facebook account with ToneDen, giving the attachment owner access to name, location, age, and email data. | ||
| facebook-messenger | messenger_page_id (ID of Facebook page to subscribe to on Messenger) | Requires fans to opt-in to receive messages from the selected Facebook page. |
| Requires fans to enter their email. | ||
| soundcloud | Requires fans to follow the attachment owner on SoundCloud. | |
| spotify | spotify_playlists* (array of Spotify playlist objects) | Requires fans to follow the attachment owner and selected playlists on Spotify. |
| spotify-pre-save | spotify_pre_save (Spotify pre-save object) | Automatically saves the specified song on the selected date/time. |
| apple-music-playlist | apple_music_playlists (array of Apple Music playlist objects) | Follows the selected Apple Music playlists. |
| apple-music-pre-add | apple_music_pre_add (Apple Music pre-add object) | Automatically adds the specified song to the fan's library on the selected date/time. |
| spotify-save | spotify_saves (array of Spotify save objects) | Saves the specified songs to the fan's Spotify library. |
| twitch | Follows the attachment owner on Twitch. | |
| Follows the attachment owner on Twitter. | ||
| twitter-tweet | Tweets the URL of the attachment from the fan's account. | |
| spotify-stream | spotify_stream (Spotify stream object) | Fans must stream the specified Spotify track for 30 seconds. |
| facebook-share | Fans must share the URL of the attachment from their Facebook account. | |
| custom-url-visit | custom_url_visit (custom URL visit object) | Fans must visit the specified URL. |
Updated over 4 years ago