Voucherify (Actions) Destination
Voucherify is an API-first Promotion Engine for growth teams. With Voucherify, marketers can run dynamic and personalized promotions and loyalty programs without the involvement of the development team. Run CDP-powered coupons, discounts, referrals, loyalty programs, gift cards, cashback, bundles, and more. The Destination integration provides a continuous flow of customer data from Segment to Voucherify to create custom events, create or update customers, and build audiences.
Voucherify maintains this destination. For any issues with the destination, contact the Voucherify Support team.
The Voucherify (Actions) destination is bidirectional, which means you can configure Voucherify as both the destination and source of your customer data. The Destination Actions framework improves on classic destinations by enabling you to see and control how Segment sends the event data it receives from your sources to actions-based destinations. Each Action in a destination lists the event data it requires and the event data that is optional. You can also choose which event types, event names, or event property values trigger an Action. These Triggers and mappings make it possible to send different versions of the Action, depending on the context from which it is triggered.
- From the Segment web app, click Catalog, then click Destinations.
- Find the Destinations Actions item in the left navigation, and click it.
- Select Voucherify (Actions) and then Configure Voucherify (Actions).
- Select an existing Source to connect to Voucherify (Actions).
- Enter the API Key and API Token into your Segment Settings UI, which you can find from your Voucherify dashboard.
- Enter Custom URL. Check your API region in Voucherify dashboard -> Project settings -> API endpoint. Then use one of API Endpoints and replace the API word with
segmentioFor example, if your default URL is: https://us1.api.voucherify.io, then use: https://us1.segmentio.voucherify.io. It also works for dedicated URLs. - Select Quick Setup to start with pre-populated subscriptions, or Customized Setup to configure each action from scratch.
- Click Configure Actions.
On the Voucherify Dashboard page:
- Open the Project settings from the user context menu on the top right.
- Find the Application Keys section on the project page.
- Use Application ID and Secret Key respectively as the API Key and API Token.
Check your API region in Voucherify dashboard -> Project settings -> API endpoint. For example, if you are using a project with a URL: https://us1.api.voucherify.io, your Custom URL will be: https://us1.segmentio.voucherify.io. It also works for dedicated URLs.
Secret Key can be found in Voucherify dashboard.
Voucherify (Actions) has the following presets
| Preset Name | Trigger | Default Action |
|---|---|---|
| Add Custom Event (Screen Event) | Event type = "screen" | Add custom event |
| Add Custom Event (Page Event) | Event type = "page" | Add custom event |
| Assign Customer To Group | Event type = "group" | Assign customer to group |
| Create Or Update Customer | Event type = "identify" | Upsert Customer |
| Add Custom Event (Track Event) | Event type = "track" | Add custom event |
Build your own Mappings. Combine supported triggers with the following Voucherify-supported actions:
Mapping limits per destination
Send the Track, Page or Screen event that will be saved as a custom event in Voucherify.
Add custom event is a Cloud action. The default Trigger is type = "track" or type = "page" or type = "screen"
Optional
If a conversion event for a referral program is set to a custom event, then you need to send the referral code in the payload to make a record of the conversion event.
Optional
If an earning rule in a loyalty program is based on a custom event. This objects allows you specify the loyalty card to which the custom event should be attributed to.
Optional
The metadata object stores all custom attributes assigned to the custom event. A set of key/value pairs that you can attach to an event object. It can be useful for storing additional information about the event in a structured format. Event metadata schema is defined in the Dashboard > Project Settings > Event Schema > Edit particular event > Metadata property definition.
Type of the event. For example: identify, track, page, screen or group
Assign a specific group and its traits to the customer.
Assign customer to group is a Cloud action. The default Trigger is type = "group"
Type of the event. For example: identify, track, page, screen or group.
Send the identify event to create or update the customer
Upsert Customer is a Cloud action. The default Trigger is type = "identify"
Optional
First name of the customer. It will be merged with last_name to create the name field.
Optional
Last name of the customer. It will be merged with first_name to create the name field.
Optional
Birthdate of the customer. You can pass data here in date or datetime format (ISO 8601).
Optional
A set of custom key/value pairs that you can attach to a customer. The metadata object stores all custom attributes assigned to the customer. It can be useful for storing additional information about the customer in a structured format.
Type of the event. For example: identify, track, page, screen or group
You can send computed traits and audiences generated using Engage to this destination as a user property. To learn more about Engage, schedule a demo.
For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Engage sends an Identify call with the property order_completed_last_30days: true. When the user no longer satisfies this condition (for example, it's been more than 30 days since their last order), Engage sets that value to false.
When you first create an audience, Engage sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.
Real-time to batch destination sync frequency
Real-time audience syncs to Voucherify (Actions) may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.
Segment lets you change these destination settings from the Segment app without having to touch any code.
Check your API region in Voucherify dashboard -> Project settings -> API endpoint. For example, if you are using a project with a URL: https://us1.api.voucherify.io, your Custom URL will be: https://us1.segmentio.voucherify.io. It also works for dedicated URLs.
Secret Key can be found in Voucherify dashboard.