Get started with engage

To get the most out of engage, you need to provide data such as your product catalog and orders, along with event data such as when a user completes an order. Events are simple to implement using our event tracker described further down on this page. But let's start with the order and product data required.
Are you using Shopify, Prestashop or Woocommerce? Then you can use our ready-made extensions to get started in minutes. No need to do any of the setup described below.
E-commerce data
You may provide this data using our API, plugins or by uploading the data in csv files. If you decide to use the API it is recommended to send both historical order data and new orders as they come in. If you instead opt to use the file upload you may start with the historical order data and then incrementally add new data once a week or so. Recommended frequency of new data is every 3rd day, but once a week works well too.
You may use file upload and / or the API as you see fit. You can for example send historical data using file upload and provide new orders using the API.
Plugin
Custom API
File upload
The following plugins take care of the entire setup for you. Simply install and connect your store.
1.​engage for Shopify​
2.​engage for Prestashop​
3.​engage for Woocommerce​
engage currently only requires two data objects in addition to the data captured from the events. 
Broken link
/orders
Example of an API call to add an order.
1
curl --location --request POST 'https://api-dot-solutionsone-211314.ew.r.appspot.com/v1/orders' 
2
--header 'Authorization: Bearer [ADD YOUR USER TOKEN HERE]' \
3
--header 'Content-Type: application/json' 
4
--data-raw '{ 
5
    "city": "New York", 
6
    "country": "USA", 
7
    "currency": "USD", 
8
    "date_created_gmt": "2020-01-01 20:20:01+01:00", 
9
    "email": "[email protected]", 
10
    "order_id": 20200101, 
11
    "status": "completed", 
12
    "order_value": 40.00, 
13
    "line_items":[
14
        { 
15
            "line_item_product_id": 1002, 
16
            "line_item_price": 17.49, 
17
            "line_item_quantity": 1, 
18
            "line_item_name": "Any name", 
19
            "line_item_sku": "sku 123", 
20
            "line_item_variation_id": 1234, 
21
            "line_item_subtotal": 17.49, 
22
            "line_item_total": 17.49, 
23
            "line_item_tax_class": "Class A", 
24
            "line_item_subtotal_tax": 0, 
25
            "line_item_total_tax": 0 
26
        }
27
    ]
28
}'
Copied!
/catalog/products
Example of an API call to add a product
1
curl --location --request POST 'https://api-dot-solutionsone-211314.ew.r.appspot.com/v1/products/catalog'  
2
--header 'Authorization: Bearer [ADD YOUR USER TOKEN HERE]' \
3
--header 'Content-Type: application/json'  
4
--data-raw '{ 
5
    "currency": "USD", 
6
    "image": "https://some-image-url.com", 
7
    "link": "https://a-link-to-the-product.com", 
8
    "product_id": 20200101, 
9
    "name": "My new product", 
10
    "price": 29.99, 
11
}'
Copied!
Read the API documentation  and get more examples here:
Broken link
engage currently only requires two data files in addition to the data captured from the events. 
orders.csv
products.csv
Read all about uploading the data files here:
Broken link
Events data
Follow the Get Started With Events guide to setup event tracking.
Event tracking
​

Documentation

Next - Integrations

Destinations

Last modified 1yr ago

Export as PDF

Copy link

Contents

E-commerce data

Events data