Solitics integration

Enhance user engagement and conversion rates with Solitics + Pushwoosh Integration

Solitics is an advanced data management and real-time marketing automation platform that empowers B2C brands to deliver highly personalized experiences to their customers. By leveraging customers’ data, businesses can increase revenue through improved conversion and retention rates, all while significantly reducing development and IT expenses.

When combined with Pushwoosh, Solitics' data management capabilities enable brands to deliver highly targeted and relevant messages to their users. This ensures that users receive content and offers that are tailored specifically to their interests and needs, thus enhancing their overall experience.

Brands can also use Solitics to analyze user data and identify areas for improvement in the user journey. By integrating this data with Pushwoosh, brands can send push notifications to re-engage users who may have abandoned their journey, directing them back to the app or website and ultimately improving conversion rates.

Use cases

Below are some practical use cases that demonstrate how the integration of Solitics and Pushwoosh can be used to improve customer experience and drive business outcomes:

Personalized promotions and offers

Businesses can use Solitics' data to analyze customer preferences and behaviors. Then, they can send customized push notifications through Pushwoosh with tailored promotions and offers based on the individual’s interests.

Boosting engagement

Gaming businesses can configure Solitics to monitor player actions and achievements, then utilize Pushwoosh to promptly deliver push notifications for milestones and special events to players, encouraging active engagement and participation in specific in-game activities.

Security alerts

Banking apps can keep their clients confident in their data security thanks to the Solitics + Pushwoosh integration. They can configure Solitics to monitor account activity and trigger alerts for unusual behavior. Then, they can use Pushwoosh to deliver real-time push notifications to notify affected customers, encouraging swift action to protect their accounts and prevent potential issues.

Setting up the integration

The integration process involves two primary steps:

1. Incorporate the Pushwoosh SDK into your website or mobile app.

2. Establish a user ID that serves as a unique identifier for both Solitics and Pushwoosh.

Prerequisites

1. Pushwoosh account

2. Pushwoosh API Access token: To enable data transmission to Pushwoosh, you need to generate a Pushwoosh API Access token. To get it, go to Settings > API Access and copy it there.

3. Pushwoosh App Code: Similarly, you'll need to locate your Pushwoosh App Code to facilitate data transfer to Pushwoosh. To do so, find the project name in the top left corner and copy the code displayed below it.

4. Solitics Account

To enable the integration, register each user in both Solitics and Pushwoosh using the same member ID. This is the primary requirement for the integration to function effectively.

Configuring Pushwoosh for integration

1. Set up a Pushwoosh account if you don’t have one.

2. Configure your projects. Learn more about how to do it.

3. Next, create an application within Pushwoosh and select the preferred communication channels. You can opt to use an existing application if you already have one.

Configuring Solitics for integration

1. Contact Solitics ([e-mail]) and ask to integrate your brand with Pushwoosh.

Specify the following details:

• Pushwoosh API Key

• Pushwoosh Application Code

2. The Solitics team will provide you with an access token for future interactions with Solitics' API.

User registration

As emphasized previously, it is important to register users with identical user IDs in both Solitics and Pushwoosh.

Use the same unique member ID that your brand uses for member integration when registering for push notifications. This consistency will not only ensure that your member ID is unique but will also streamline tracking and facilitate debugging in case of any issues.

Registration with Pushwoosh

Pushwoosh offers two methods for associating a user ID with a specific device. If you do not use these methods, Pushwoosh will automatically employ the device hardware ID as the user's identifier.

To link a user ID to a device in Pushwoosh, you can choose one of the following methods:

setUserId

This is an SDK function that enables you to set a string value as a Pushwoosh ID, which will be automatically matched with a Hardware ID (HWID) used by Pushwoosh to identify devices.

Android

https://rawgit.com/Pushwoosh/pushwoosh-androidsdk/master/Documentation/com/pushwoosh/inapp/PushwooshInApp.html#setUserIdjava.lang.Stringrawgit.com

iOS

https://github.com/Pushwoosh/pushwoosh-iossdk/blob/master/Documentation/PushNotificationsManager.md#setuseridgithub.com

/registerUser API Method

This method allows you to remotely assign a User ID to a specific HWID from your backend.

Detailed information on using this API call can be found here.

Register with Solitics

When a user is registered for push messages, Solitics also needs to be informed. For this, make the following HTTP request:

HTTP method: POST

Endpoint: https://api.solitics.com/rest/subscribers/register/app

Request body

{
 "memberId": "1234567",
 "email": "[e-mail]",
 "token": "GH2TKoXXXXXXXEj1111",
 "key": "1234567”
}

Body parameters

Parameter	Description
memberID	This represents the unique identifier of the user in Solitics (such as the CRM ID)
email	The member's email that is used for two-factor authentication
token	The token provided by Solitics to get access to the push API.
key	The member's push registration key should match the user ID used for registration with Pushwoosh.

While Solitics recommends using the member ID as the key, exceptions may apply. For instance, if multiple applications are used in Pushwoosh, a different key should be assigned to the user for each application.

Integration testing

Once you have completed the setup process, it's crucial to conduct a test to ensure that the integration functions as expected. Follow these steps for testing:

1. Create a Push Promotion in Solitics and Save.

2. Log in to your app or site. Access the app or website where you anticipate the push message to appear. Ensure that you log into the user account that has been previously registered for push notifications within both Solitics and Pushwoosh.

If you are uncertain about the registration status, feel free to contact Solitics at [e-mail] for confirmation, including details about the user's registration status and associated user ID.

3. Initiate the test. In the Solitics promotion, click the Test button. Enter the email, phone number, or member ID of the subscriber (the intended recipient of the push message). Click Send.

If all configurations are correct, the push message should appear.