Topsort Cloud Mode Integration

Send events to Topsort using RudderStack cloud mode.

After you have successfully instrumented Topsort as a destination in RudderStack, follow this guide to correctly send your events to Topsort in cloud mode.

Find the open source transformer code for this destination in the GitHub repository.

Track

You can use the track call to capture user events along with the associated properties and send them to Topsort.

A sample track call is shown:

rudderanalytics.track("Product Added", {
  product_id: "9578257311",
  sku: "8472-998-0112",
  name: "Sample Product"
})

Default event mappings

By default, RudderStack maps the following ecommerce events to the corresponding Topsort events:

RudderStack eventTopsort event
Order Completedpurchases
Product Clicked
Product Added
clicks
Product Viewed
Product List Viewed
impressions

Note that you can change these mappings in the RudderStack dashboard using the Event mapping settings.

Purchases event mappings

RudderStack maps the following track event properties to the corresponding Topsort purchases event properties:

RudderStack propertyData typeTopsort property
messageId
Required
Automatically added by RudderStack in the final event payload.
Stringid
timestamp
originalTimestamp
Required
Automatically added by RudderStack in the final event payload.
DatetimeoccuredAt
anonymousId
Required
StringopaqueUserId
products
Required
ObjectItems

Items object mappings

RudderStack propertyData typeTopsort property
products.$.product_id
Required
StringproductId
products.$.price
Required
NumberunitPrice
products.$.quantityIntegerquantity
products.$.vendorIdStringvendorId

Impressions event mappings

RudderStack maps the following track event properties to the corresponding Topsort impressions event properties:

RudderStack propertyData typeTopsort property
messageId
Required
Automatically added by RudderStack in the final event payload.
Stringid
timestamp
originalTimestamp
Required
Automatically added by RudderStack in the final event payload.
DatetimeoccuredAt
anonymousId
Required
StringopaqueUserId
properties.resolvedBidIdStringresolvedBidId
properties.entityObjectentity
properties.additionalAttributionObjectadditionalAttribution
properties.placementObjectplacement

placement object mappings

RudderStack propertyData typeTopsort property
context.page.path
Required
Stringpath
properties.positionIntegerposition
properties.product_idStringproductId
properties.queryStringsearchQuery
properties.pageNumberIntegerpage
properties.pageSizeIntegerpageSize
[properties.category_id]ArraycategoryIds

Clicks event mappings

RudderStack maps the following track event properties to the corresponding Topsort clicks event properties:

RudderStack propertyData typeTopsort property
messageId
Required
Automatically added by RudderStack in the final event payload.
Stringid
timestamp
originalTimestamp
Required
Automatically added by RudderStack in the final event payload.
DatetimeoccuredAt
anonymousId
Required
StringopaqueUserId
properties.resolvedBidIdStringresolvedBidId
properties.entityObjectentity
properties.additionalAttributionObjectadditionalAttribution
properties.placementObjectplacement

placement object mappings

RudderStack propertyData typeTopsort property
context.page.path
Required
Stringpath
properties.positionIntegerposition
properties.product_idStringproductId
properties.queryStringsearchQuery
properties.pageNumberIntegerpage
properties.pageSizeIntegerpageSize
[properties.category_id]ArraycategoryIds

Questions? Contact us by email or on Slack