In Voucherify, you can synchronize the following data:
When you have created your Voucherify account, you can import your existing data and then synchronize it for future use in campaigns.
- Learn why data synchronization is important
- Learn how to synchronize your data through data import and updates
Your data is synchronized with Voucherify.
Voucherify can store and act on collected customer data. The most common customer data operation is to create customer segments based on customer attributes. Customer segments can be used to understand customer behavior, build promotion limits, or trigger automatic incentive delivery.
The customer data does not have to be stored in Voucherify before a validation or redemption request is made. Voucherify can use the customer data from the request to create a new customer with a unique
However, the customer data must exist in Voucherify before a distribution is made. Also, distribution can be made on the basis of the customer's attributes and sent out to customers from a given segment. If the customer data is not up to date, the distribution messages sent manually can reach the wrong audience.
Customer data synchronization and
If your data is to be synchronized based on the
source_idof the customer, you need to import the
source_idwhen the customer is uploaded for the first time. You will not be able to update
If the customer does not exist in Voucherify, they are created automatically in a request that includes the customer object. If the customer exists, their data will be upserted. In this case, the response also includes the
The following actions upsert customer data:
- Order creation
- Stackable discount redemption
- Stackable discount redemption (client side)
- Track custom event
- Voucher publication
You can import your customer database to Voucherify with a CSV file. If you use a CRM system, use its unique ID as a
Read our customer import guide to learn more.
If you want to keep your customers database up to date with Voucherify, create a customer in Voucherify every time a new user is added to your database. Use the create customer API endpoint to create customer data.
Customer data can be upserted with integrated platforms that support outbound traffic:
Go to the API reference to see the customer endpoints that can be used to synchronize customer data.
Products can be stored in Voucherify but it is not required. The product validation takes place during the following actions:
The product validation is based on the API payload and the data stored in Voucherify's product inventory.
However, if a product does not exist in Voucherify, the validation will use the product data included in the payload. Even if the product does exist in Voucherify, the payload data is used instead of those stored in the system. This method can be used to avoid frequent API calls to keep the product inventory up to date.
Product data in the request
Unlike customer data, product data provided in the request payload alone do not create a new product in Voucherify. If you want to store products in Voucherify, they need to be created manually in the dashboard or imported with a CSV file.
Also, even though Voucherify uses the payload data instead of the data stored in the system, the product data is not upserted through requests. Products can be updated through product edit function or by importing a CSV file.
To enable product updates through the payload, use the override attribute.
The products in Voucherify can be grouped into static or dynamic collections based on their parameters. Collections can be used in validation rules to model product-specific limits and loyalty-earning rules.
You can import your product database to Voucherify with a CSV file. This method can be also used to update the names of existing products.
You can create and update your products with the following API endpoints:
In a request payload, you can add an attribute
override with value
true to the product object.
override attribute is used to enable storing the product data in Voucherify. If the product does not exist, it will be created with a
source_id. If the product does exist, the provided values for the name, price, and metadata will replace those already stored in Voucherify.
Orders are synchronized with Voucherify automatically during redemption. They can be viewed through the Orders view in the dashboard.
If you want to synchronize the orders that have not been included in any redemption, you need to use the import order method.
The endpoint can be also used to upsert order data if the order
source_id are provided.
The update order endpoint updates the specified order with the values of the parameters in the payload.
The import orders endpoint is used to import only historical orders into Voucherify. For on-going synchronization, the create order and update order endpoints should be used. Importing orders in bulk does not trigger distributions or earning rules.
Updated 6 days ago