Postscript
An introduction to the Postscript Destination
Overview
Connection Type:
Installation Instructions
1. Create a Postscript API key
- In your Postscript dashboard, select your Shop Name and navigate to API.
- Click on Create Security Key Pair and confirm by selecting Yes.
- Click in Add a label and use a label that helps you identify the API key (e.g.
Converge). - Under Private Key, click on Show and to copy the Private Key.
2. Create the Converge Connection
- Create and copy a Postscript API key from the Postscript dashboard.
- In Converge, click Create a new connection under the Connections tab. Select the Postscript app and paste the private Postscript API key.
- Give your connection a name and click on Create Connection.
Converge functionality
This integration supports the following Converge connection functionality.
| Converge Feature | Supported |
|---|---|
| Custom Events | |
| Filters | |
| Server-side Conversions |
Adding product URL and image URL to Converge events to power Postscript flows
A common use case of the Postscript Destination is to build Postscript SMS Flows based on Converge Events. As such, you might want to include a Product URL or Product Image URL in the Converge Event so you can leverage these in your flows.
To that end, you will want to extend the Converge Event Spec for the following events. Once you add the custom properties to your events, Converge will automatically forward these to the Postscript Destination.
Find code examples below that illustrate where you should add the Product URL and Product Image URL custom event properties.
Event Mapping
Converge automatically maps the following events from the Converge Event Spec to the Postscript spec.
| Converge Event Name | Postscript Event Name |
|---|---|
| $page_load | Converge - page_view |
| Viewed Product | Converge - viewed_product |
| Added To Cart | Converge - add_to_cart |
| Started Checkout | Converge - initiate_checkout |
| Viewed Collection | Converge - viewed_collection |
| Placed Order | Converge - purchase |
You can find the property mapping for each event below: