Messaging: Surveys site app migration

[joethreepwood]

Messaging

Context

Surveys users are moving off of the site app, on to the JS SDK for launch. No action required, but it's nice to be given a heads-up!

Goal

No goal we can track here.

Format

1x email

Audience / Targeting

@neilkakkar will share (over Slack) a list of emails we need to hit with this message.

Resources, timeline, responsibilities

We'll send this week, ASAP.

Requested input

Feedback on (incoming) copy.

[joethreepwood]

@neilkakkar Curious if best to target by Org, or individual user here?

If Org, I need Org_Ids. If individual, I need specific emails.

[neilkakkar]

oh, I didn't know you can easily target by org_ids - orgs would indeed be better, will send those instead!

[joethreepwood]

For your approval @neilkakkar @annikaschmid

[joethreepwood]

oh, I didn't know you can easily target by org_ids - orgs would indeed be better, will send those instead!

Yep, though I try to avoid it for very long lists due to this bug.

Org IDs mean I have to create a cohort first. Emails I can just import into Customer.io. As long as it's less than 200 teams, Org_ID is fine.

[neilkakkar]

I have good news, the bug is no more 😋

[neilkakkar]

Ah, just realised I missed something important: people not using the snippet can be on an old version of posthog-js where this doesn't work, so the upgrade path needs to be more manual for them - otherwise we'll break surveys - I shouldn't disable the site app for them 😬.

Hmm, now wondering if the automation is more trouble than it's worth here. (cc: @liyiy ). I think I'll add a banner in app to tell them the upgrade path as well, but should mention it in the email too:

So, new doc (sorry @joethreepwood ):

Surveys require posthog-js version 1.81.1 to work.

1a. If you're using the snippet, you can just toggle on surveys on the surveys page and everything will work fine. 1b. If you're using a package manager, you should update posthog-js to 1.81.1 and then enable surveys in app.

2. You can then disable the "surveys app" app which will shortly be deprecated.

[liyiy]

I think as long as we are consistent everywhere and clear with saying "Surveys is being deprecated off of the site app. If you're using posthog-js through package manager, upgrade to version 1.81+ instead"

Since users already have to edit their posthog init with opt_in_site_apps in the original experience, it should be fine having them update. Definitely more annoying than an automatic transition but better to do it now than later when there's even more users!

[joethreepwood]

Better?

[joethreepwood]

I chose the Oct 9th deadline to coincide with other surveys announcements. Important to give a deadline here, I feel.

[neilkakkar]

Does re-enable surveys link to app.posthog.com/surveys ? And Oct 9 is good - good call to be explicit with dates here 👍 .

One edit: Update posthog-js to at least version 1.81.1 & then re-enable surveys.

---

And yes, much better, thank you!

[joethreepwood]

Does re-enable surveys link to app.posthog.com/surveys ?

It does

[joethreepwood]

Amended

[joethreepwood]