Hi Everyone!
We announced Cumulative Subscription Tenure at TwitchCon and we’re now ready to provide an update on the changes that are coming with the update. In terms of timeline, we are currently working on our data migration and end to end testing; we are aiming for an end of January launch and will provide a hard launch date on 1/23/2019. I will post in this this thread when we have a date update.
With the Cumulative Subscription Tenure update we’re introducing the idea of total months subscribed in addition to streak. Total Months’ Subscribed will be the default value that’s shared when a user shares their resubscribe message. The user’s streak value will be an optional value shared by the user. The fields related to streak will not be present in resubscribe messages where a user has chosen NOT to share their streak value.
Updates to User Notices:
- New Field -
msg-param-streak-months
- number of streak months- New Field -
msg-param-cumulative-months
- number of cumulative months subscribed- New Field -
msg-param-should-share-streak
- Bool on whether the user has opted to sharestreak-months
- Deprecated Field -
msg-param-months
- former way to track months in the subscription user notice
As explained above, msg-param-cumulative-months
will contain the tenure value for the user for the total months subscribed, this value will be the one utilized for determining the sub badge any user has. msg-param-streak-months
will only be present if msg-param-should-share-streak
= 1
; if msg-param-should-share-streak
= 0
then msg-param-streak-months
will not be present.
Example:
A user with 12 months of Tenure and 3 months of streak who has opted to share their streak value will return the following values:
msg-param-cumulative-months
=12
msg-param-should-share-streak
=1
msg-param-streak-months
=3
@badges=subscriber/12,premium/1;color=;display-name=vtho;emotes=;flags=;id=6d76ab5c-a595-4ccb-97d1-8d488fc6d128;login=vtho;mod=0;msg-id=resub;msg-param-months=0;msg-param-cumulative-months=12;msg-param-streak-months=3;msg-param-should-share-streak=1;msg-param-sub-plan-name=Channel\sSubscription\s(wagamamatv);msg-param-sub-plan=Prime;room-id=24811779;subscriber=1;system-msg=vtho\sSubscribed\sat\sTier\s1.\sThey\ssubscribed\sfor\s10\smonths,\scurrently\son\sa\s3\smonth\sstreak!;tmi-sent-ts=1547589704222;turbo=0;user-id=62295477;user-type= :tmi.twitch.tv USERNOTICE #wagamamatv : you’re the best!
A user with 12 months of Tenure and 3 months of streak who has opted NOT to share their streak value will return the following values:
msg-param-cumulative-months
=12
msg-param-should-share-streak
=0
@badges=subscriber/12,premium/1;color=;display-name=vtho;emotes=;flags=;id=6d76ab5c-a595-4ccb-97d1-8d488fc6d128;login=vtho;mod=0;msg-id=resub;msg-param-months=0;msg-param-cumulative-months=12;msg-param-should-share-streak=0;msg-param-sub-plan-name=Channel\sSubscription\s(wagamamatv);msg-param-sub-plan=Prime;room-id=24811779;subscriber=1;system-msg=vtho\sSubscribed\sat\sTier\s1.\sThey\ssubscribed\sfor\s10\smonths!;tmi-sent-ts=1547589704222;turbo=0;user-id=62295477;user-type= :tmi.twitch.tv USERNOTICE #wagamamatv : you’re the best!
Updates to PubSubs:
- New Field -
cumulative_months
- number of cumulative months subscribed- New Field -
streak_months
- number of streak months- Deprecated Field -
months
- former way to track months in the subscription pubsub
Similar to the usernotice, cumulative_months will contain the tenure value for the user for the total months subscribed, this value will be the one utilized for determining the sub badge any user has. streak_months will only be present if the user has opted to share their streak in the resubscription message. If the user has opted out of sharing their streak then streak_months will not be present.
Example:
A user with 12 months of Tenure and 3 months of streak who has opted to share their streak value will return the following values:
cumulative_months
=12
streak_months
=3
A user with 12 months of Tenure and 3 months of streak who has opted NOT to share their streak value will return the following values:
cumulative_months
=12
These user notice and pub sub changes will go live when Cumulative Subscription Tenure launches. As I’ve noted above, the msg-param-months field in the usernotice and months field in the pub sub will be deprecated at launch. Please make sure that you are listening for the new fields to ensure an uninterrupted experience. You’ll notice in the example usernotices above that msg-param-months=0
still exists. We will continue to pass a field equal to 0 for compatibility with older mobile clients so users who have yet to update will not see incorrect data.
Additionally, at launch, we will provide all users with a cumulative subscription tenure value of 2 or greater with a resubscription message. This means there might be a higher than average value of resubscription messages shared within the first few days of the feature launch.
If you have any questions, comments, or feedback to these updates, please leave comments below on this topic.
Thanks!