Data Synchronization
Learn what kind of data you can synchronize with Voucherify and how you can do this
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.
Goals
- Learn why data synchronization is important
- Learn how to synchronize your data through data import and updates
Outcome
Your data is synchronized with Voucherify.
Customer synchronization
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.
Voucherify uses the customer object for validation, redemption, and distribution purposes.
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 id
field.
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
source_id
If your data is to be synchronized based on the
source_id
of the customer, you need to import thesource_id
when the customer is uploaded for the first time. You will not be able to updatesource_id
later on.
Customer synchronization options
Upserting customers
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 updated_at
object.
The following actions upsert customer data:
- Order creation
- Stackable discount redemption
- Stackable discount redemption (client side)
- Track custom event
- Voucher publication
Importing customers
You can import your customer database to Voucherify with a CSV file. If you use a CRM system, use its unique ID as a source_id
field.
Read our customer import guide to learn more.
Creating and updating customers with the API
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.
To update customer data, use the update customer API endpoint. The create customer API endpoint can be also used to update customer data.
Synchronizing with connectors
Customer data can be upserted with integrated platforms that support outbound traffic:
Customer API endpoints
Go to the API reference to see the customer endpoints that can be used to synchronize customer data.
Product synchronization
Products can be stored in Voucherify but it is not required. The product validation takes place during the following actions:
- Qualification
- Validation
- Redemption
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.
Product synchronization options
Importing products
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.
Creating and updating products with the API
You can create and update your products with the following API endpoints:
Overriding product data
In a request payload, you can add an attribute override
with value true
to the product object.
The 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.
Order synchronization
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.
Order synchronization options
Create order
The create order endpoint creates an order object and triggers an order creation event.
The endpoint can be also used to upsert order data if the order id
or source_id
are provided.
Update order
The update order endpoint updates the specified order with the values of the parameters in the payload.
Import orders
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