Introduction
Welcome to the ViaAds API documentation.
This page provides all the information you need to successfully integrate your webshop with ViaAds.
Here you will find the specific endpoints, with the properties required for ViaAds to perform Successful marketing for your webshop.
Furthermore the Schemas is also listed on this page, with a short description of every property, along with any relations there might be between them.
Authentication
To authenticate your requests to the ViaAds API, you will need to include your API key in the header of each request.
ApiKey: key123
Custom
Event [OPTIONAL]
curl -X 'POST' \
'https://integration.viaads.dk/event' \
-H 'accept: */*' \
-H 'ApiKey: test' \
-H 'Content-Type: application/json' \
-d '{
"eventDate": "2023-06-14T08:38:56.936Z",
"eventType": "string",
"productSku": "string",
"price": 0,
"email": "string",
"cookie": "string",
"clientIpAddress": "string",
"userAgent": "string"
}'
JSON response example:
{
"status": 200,
"message": "Success"
}
This endpoint is used to receive customer events e.g. Viewed Product, Added Product To Cart or Removed Product From Cart.
EventTypes:
[ProductLook, AddCart, RemoveCart, AddWishList, RemoveWishList]
HTTP Request
POST https://integration.viaads.dk/event
Order [OPTIONAL]
curl -X 'POST' \
'https://integration.viaads.dk/order' \
-H 'accept: */*' \
-H 'ApiKey: 123' \
-H 'Content-Type: application/json' \
-d '{
"createdGmt": "2023-06-16T07:48:54.804Z",
"lastModifiedGmt": "2023-06-16T07:48:54.804Z",
"orderNumber": "string",
"currencyIsoCode": "string",
"email": "string",
"status": "string",
"isCanceled": true,
"totalShippingPrice": 0,
"totalPriceWithOutTax": 2147483647,
"totalPriceWithTax": 2147483647,
"items": [
{
"name": "string",
"sku": "string",
"unitPrice": 0,
"quantity": 0,
"totalPriceWithTax": 0,
"totalPriceWithOutTax": 0
}
],
"billing": {
"billingFirstName": "string",
"billingLastName": "string",
"billingAddress": "string",
"billingCity": "string",
"billingState": "string",
"billingZipCode": "string",
"billingCountry": "string",
"billingPhoneNumber": "string",
"billingEmail": "string"
},
"shipping": {
"shippingFirstName": "string",
"shippingLastName": "string",
"shippingPhoneNumber": "string",
"shippingEmail": "string"
}
}'
JSON response example:
{
"status": 200,
"message": "Success"
}
This endpoint is used to receive a single customer order. This enables more efficient retargeting if an order is sent directly after its created This endpoint is not included as an 'Event' and is therefore not restricted by the Marketing Cookie Acceptance
HTTP Request
POST https://integration.viaads.dk/order
Orders [REQUIRED]
curl -X 'POST' \
'https://integration.viaads.dk/orders' \
-H 'accept: */*' \
-H 'ApiKey: 123' \
-H 'Content-Type: application/json' \
-d '[
{
"createdGmt": "2023-06-16T07:48:21.176Z",
"lastModifiedGmt": "2023-06-16T07:48:21.176Z",
"orderNumber": "string",
"currencyIsoCode": "string",
"email": "string",
"status": "string",
"isCanceled": true,
"totalShippingPrice": 0,
"totalPriceWithOutTax": 2147483647,
"totalPriceWithTax": 2147483647,
"items": [
{
"name": "string",
"sku": "string",
"unitPrice": 0,
"quantity": 0,
"totalPriceWithTax": 0,
"totalPriceWithOutTax": 0
}
],
"billing": {
"billingFirstName": "string",
"billingLastName": "string",
"billingAddress": "string",
"billingCity": "string",
"billingState": "string",
"billingZipCode": "string",
"billingCountry": "string",
"billingPhoneNumber": "string",
"billingEmail": "string"
},
"shipping": {
"shippingFirstName": "string",
"shippingLastName": "string",
"shippingPhoneNumber": "string",
"shippingEmail": "string"
}
}
]'
JSON response example:
{
"status": 200,
"message": "Success"
}
This endpoint is used to receive a daily list of customer orders
HTTP Request
POST https://integration.viaads.dk/orders