HTTP Requests

Get settingsFile

https://dev.visualwebsiteoptimizer.com/server-side/settings

accountId
sdkKey

This is required for fetching the settingsFile required for instantiating the VWO SDK.

Status Code: 200
Response: JSON - settingsFile

If sdkKey is not valid, then

Status Code: 400
Response: JSON - {"message":"Invalid api key"}

Track visitor

https://dev.visualwebsiteoptimizer.com/server-side/track-user

VWO sends the essential params like accountId, campaignId, variation assigned, current time, user ID, UUID of user, along with meta information like sdk-name, sdk-version, etc.

To send an event to VWO server to track a visitor.

Status Code: 200
Empty response

Track Conversion

https://dev.visualwebsiteoptimizer.com/server-side/track-goal

VWO sends the essential params like accountId, campaignId, variation assigned, current time, user ID, UUID of user, goalId and revenue(if revenue goal), along with meta information like sdk-name, sdk-version, etc.

To send an event to VWO server to track a conversion. Various metrics are calculated and shown in campaign reports based on count of visitors and conversions.

Status Code: 200
Empty response

Custom Dimension

https://dev.visualwebsiteoptimizer.com/server-side/push

VWO sends the essential params like accountId, current time, user ID, UUID of user, custom-dimension-key, custom-dimension-value, along with meta information like sdk-name, sdk-version, etc.

To categorize and differentiate user. Post-segmentation can be applied on this cutom-dimension to view segmented report data.

Batch Events

https://dev.visualwebsiteoptimizer.com/server-side/batch-events

VWO SDK batches different events like track-user, track-goal, and push and sends to VWO.

VWO SDK batches different events and sends them in a single POST call.

a (Required)

VWO Account ID

Number

12345

i
(Required)

SDK Key

Alphanumeric

aa87170ad94079aa190bc7c9b85d26zz

account_id (Required)

VWO Account ID

Number

12345

sId
(Required)

Session ID / Current UTC Timestamp

Number

1641218854

u
(Required)

32 characters long UUID

Alphanumeric

O33C4BA1CB0C53CDB32B51AF403B344P

experiment_id
(Required)

VWO Experiment ID

Number

10

combination
(Required)

Variation ID in which User got bucketed

Number

2

env
(Required)

SDK/environment Key
This is for viewing reports based on the project's environment

Alphanumeric

aa87170ad94079aa190bc7c9b85d26zz

ap
(Required)

Platform

String

server

random
(Required)

For cache busting

Float

0.6375406415765388

sdk
(Optional)

Name of SDK used

String

• vwo-node-sdk_ or
• vwo-java-sdk_ and so on

sdk-v
(Optional)

The version of SDK used

Semver

1.30.0

account_id (Required)

VWO Account ID

Number

12345

sId
(Required)

Session ID / Current UTC Timestamp

Number

1641218854

u
(Required)

32 characters long UUID

Alphanumeric

O33C4BA1CB0C53CDB32B51AF403B344P

experiment_id
(Required)

VWO Experiment ID

Number

10

combination
(Required)

Variation ID in which User got bucketed

Number

2

goal_id
(Required)

Goal ID of a campaign

Number

1

env
(Required)

SDK/environment Key
This is for viewing reports based on the project's environment

Alphanumeric

aa87170ad94079aa190bc7c9b85d26zz

ap
(Required)

Platform

String

server

random
(Required)

For cache busting

Float

0.6375406415765388

sdk
(Optional)

Name of SDK used

String

• vwo-node-sdk_ or
• vwo-java-sdk_ and so on

sdk-v
(Optional)

The version of SDK used

Semver

1.31.0

account_id (Required)

VWO Account ID

Number

12345

sId
(Required)

Session ID / Current UtC Timestamp

Number

1641218854

u
(Required)

32 characters long UUID

Alphanumeric

O33C4BA1CB0C53CDB32B51AF403B344P

env
(Required)

SDK/environment Key
This is for viewing reports based on the project's environment

Alphanumeric

aa87170ad94079aa190bc7c9b85d26zz

tags

Custom Dimension Data

JSON

{"u":{"key":"value"}}

random
(Required)

For cache busting

Float

0.6375406415765388

ap

Platform

String

server

sdk
(Optional)

Name of SDK used

String

• vwo-node-sdk_ or
• vwo-java-sdk_ and so on

sdk-v
(Optional)

The version of SDK used

Semver

1.30.0