The Survicate - OneSignal integration allows you to:
Identify survey respondents using data from OneSignal
Send survey responses to OneSignal as subscriber attributes
Save question answers as events in OneSignal
and much more!
This article will teach you how to connect the OneSignal integration step-by-step on a survey level to update contact properties with survey responses and see Survicate events in OneSignal.
🚀 Keep on reading to learn more!
Create your survey
Click on + Create new survey, select any creation method (a template, using AI survey creation, or adding your own questions), and survey type:
In the Configure tab of the survey, select OneSignal as the tool to identify respondents with:
For more in-depth instructions, check out our article.
Enable the integration
To enable the OneSignal integration, go to the Integrations tab, find, and pick OneSignal from the list of integrations:
Click the Connect button to set up the authorization:
Insert your OneSignal account App ID and API Secret and click Connect:
💡 Please note that it's only possible to integrate one Survicate workspace with one OneSignal workspace. If you'd like to sync survey data to multiple OneSignal instances, contact sales@survicate.com, or start a chat with us to purchase another Survicate workspace.
High five! The integration is ready to use 🚀
Connect your survey to OneSignal
Now that the OneSignal integration is connected, you can set up individual settings for each survey. Go to your survey, select the Connect tab, and choose OneSignal from the list of available integrations:
Here, we'll look closer at all the possible options and features that you can set up for each survey:
Update fields
Update fields
Set up survey responses to flow into OneSignal as custom user tags. By doing so, you'll enrich your OneSignal user profiles with collected data.
1. In the Settings tab of OneSignal integration you'll see the Update fields section.
Select the question you wish to update the fields from. To avoid flooding your OneSignal user profiles with data, we enable you to only send responses to chosen questions:
2. Add the name of the custom attribute you'd like to update under the Tag name:
By default, Survicate sends the content of a survey response as an attribute value, but you can change the label to make it shorter or to fit your data structure - click edit mapping to modify these values:
3. You can connect more questions to your integration by clicking ➕Add new and applying the same steps.
Send responses as custom events
Send responses as custom events
Apart from the above settings, each time a respondent answers a survey question, Survicate can send custom events to OneSignal:
By default, the event is named survicate-question-answered, but for each of your surveys connected to OneSignal, you can enter a custom event name (it needs to be between 3 and 255 characters long, contain only letters, numbers, dashes, or underscores).
This feature gives you more flexibility when organizing and tracking survey response events in OneSignal.
Then, choose if you want to send the event for all questions, or just the questions chosen in the Update fields tab:
If you choose to send the events, you'll be able to see custom events in the Event Activity in OneSignal:
The event contains event properties with the answer to the question and the information about the survey, question, and respondent.
💡You can use the event's data to target a campaign in OneSignal, build journeys, or create Segments.
Share your survey
The OneSignal integration will work as long as respondents are identified!
We map responses to the specific user based on their external_id, so the external_id attribute should be collected for the integration to work.
In this paragraph, we'll explain how to pass respondent traits to Survicate for all survey types.
Email or Shareable link survey
After everything is set up in your survey, go to the Share tab and decide how to send your email survey.
There are two options - you can send your survey as a link or embed the first question in the email so that respondents start answering the survey right from the email.
Survey Link
Survey Link
Grab a link to your survey from the Copy Link button, and hide it behind a CTA button or hyperlink in OneSignal email:
💡The survey URL can also be sent via SMS, and respondents will be identified if you manually modify the survey URL before it's sent to already include the respondent's phone number.You can manually add
&phone={{subscription.phone_number}}merge tag to the survey URL to capture the phone number of the respondent.
Email Embed
Email Embed
Display the first question directly in the email's body and start the survey directly from the email. The respondent will then be redirected to a landing page to complete the rest of the survey.
1. Click Get your code, then copy the HTML code:
2. Create an email in OneSignal, and paste the HTML code into the email.
Once your email is ready, we recommend sending the survey to yourself or your colleagues to see what the survey experience will be like for your respondents and to see if all responses are captured as expected, along with user data.
Other survey types
If you created a Website or in-product survey, learn how to identify respondents by passing their email with JavaScript SDK. Then, launch the survey.
If you created a Mobile app survey, check here how to identify respondents by passing their email attribute to Survicate with the Mobile SDK. Then, launch the survey.
If you created an Braze in-app survey, share it via the dedicated tool - Braze.
💡 Alternatively, in any survey type, use a Contact form question to ask respondents for their email address (and, optionally, other details). Make sure to place the Contact form before the questions mapped to OneSignal fields.
🚀 Once you've got everything ready, set your message live, and get ready to dive into your insights.
Analyze your survey results
After collecting responses through your OneSignal survey, it's time to look into the feedback and insights your respondents have shared. Survicate allows you to easily review results, statistics, and trends to take further action.
Keep on reading to see how feedback can be analyzed in Survicate and in OneSignal!
Feedback in Survicate
After your survey starts collecting responses, you will see them immediately in the Analyze tab of the survey.
The Analyze tab shows you Overall results with statistics and over-time data, as well as Individual responses to look into each survey submission in detail.
You can check out our guide for an in-depth description of all the possibilities of the Analyze tab.
Feedback in the Insights Hub
💡 To obtain even more comprehensive feedback, we recommend syncing survey responses to the Insights Hub, where they will be automatically analyzed and categorized into Topics along with feedback from your other sources, such as:
insights from support chats,
online reviews,
call transcripts.
After you connect sources to the Hub, feedback will appear there in real-time and it will be automatically segmented into Insights, and categorized into Topics:
The Hub will categorize and analyze feedback from surveys and other sources, to:
automatically detect customer sentiment;
identify technical issues and bugs reported by users and segment them into Topics and actionable Insights;
understand your customers' needs and wants better.
You can also ask the Research Assistant to quickly and effectively find answers to all your questions. The responses are generated based on the feedback you integrated into the Insights Hub and the answers collected with surveys in your workspace.
📞 If you have any questions or need further assistance, feel free to contact our team via chat or email at support@survicate.com.