Alia integrates directly with Postscript to ensure your SMS marketing lists are updated in real-time. When a user interacts with an Alia popup on your Shopify storefront, we pass contact information, custom properties, and behavioral events to Postscript using their v2 API.
Creating and Updating Subscribers
When a new user signs up through an Alia popup, we trigger a POST /subscribers request. If the subscriber already exists, we use PATCH /subscribers/:id to update their profile with the latest data collected during their session.
The following core fields are synchronized:
phone_number: The primary identifier for Postscript SMS marketing.
email: Synced alongside the phone number when collected.
keyword_id: Pulled from your Alia configuration or overrides to ensure users are added to the correct Postscript list.
shopify_customer_id: Passed optionally to link the subscriber to their Shopify profile.
tags: Every subscriber created via this integration is automatically tagged with ["Alia"] for easy segmentation.
Subscriber Attributes & Custom Properties
Alia tracks a dynamic map of properties that accumulate over a user's session. These are sent as subscriber attributes, allowing you to personalize your SMS flows based on specific user interactions.
Form & Poll Data
Any data collected from a popup form (such as poll answers) is passed as a key/value pair. For example, if you ask a question about product preference, the question text becomes the attribute key and the user's choice becomes the value.
Metadata & Rewards
We also pass specific metadata related to the Alia experience:
alia_opt_in_popup_name: The title of the popup the user engaged with.
alia_opt_in_popup_id: The unique ID of the popup.
alia_ooi: Set to "true" if the user completed an "Onsite-Opt-In" (OOI) flow.
aliaoffer: The Shopify discount code generated for the user.
aliaoffertext: The description of the reward (e.g., "15% Off").
aliaofferexpiration: The expiration date of the reward in ISO format.
Note: These properties are cumulative. As a user answers more questions or interacts with different popups, Alia updates the subscriber profile in Postscript to reflect the most current data.
Event Tracking
In addition to updating subscriber profiles, Alia sends real-time events to POST /events. These can be used to trigger specific automation flows within Postscript.
reward_claimed: Sent when a user successfully receives a discount code. Properties include the text, shopify_code, and expires_at timestamp.
poll_answered: Sent every time a user interacts with a poll element. Properties include the specific question and the answer provided.
Client-Side Integration (SDK)
To ensure a seamless user experience on your storefront, Alia utilizes the Postscript SDK. This handles identity management and compliance requirements for SMS opt-ins.
postscript.identify({ phone }): Called immediately upon signup to associate the browser session with the phone number.
postscript.acquisition.optIn(phoneNumber, { welcomeMessage }): Used specifically for OOI flows to initiate the subscription process.
postscript.acquisition.verify({ code, phoneNumber }): Handles One-Time Password (OTP) verification for secure signups.