Roomvo

Send visualiser engagement and conversion events to Roomvo for AR/VR product visualisation attribution and retailer analytics.

⚠️

This integration is currently in beta. Configuration and behaviour may change.

Prerequisites

Complete these steps before configuring Signal. Roomvo is a B2B platform that requires onboarding through their sales team.

Contact Roomvo

Reach out to Roomvo at roomvo.com to set up a retailer account. Roomvo specialises in AR/VR product visualisation for flooring, tile, countertop, and home improvement retailers.

Complete retailer onboarding

Work with the Roomvo team to configure your product visualiser and set up your retailer profile. During onboarding, you will receive your integration credentials.

Receive your Retailer ID

Your Roomvo account manager will assign a Retailer ID that identifies your organisation within the Roomvo platform. This is provided during onboarding.

Obtain your API key

Your Roomvo account manager will provide an API Key for authenticating server-to-server event delivery. Keep this credential secure.

Define tracking events

Work with Roomvo to determine which visualiser and conversion events to track. Common events include visualiser opens, product try-ons, and purchase conversions linked to visualiser engagement.

Configuration

Field	Type	Required	Description
`retailer_id`	string	Yes	Your Roomvo retailer ID, provided during onboarding.
`api_key`	secret	Yes	Your Roomvo API key for authenticating server-to-server event delivery.

Signal Setup

Quick Setup

Navigate to Integrations in the sidebar.
Open the Integration Library tab.
Find Roomvo or filter by Attribution.
Click Install, select a variant if available, and fill in the required fields.
Click Install Integration to create the integration with a ready-to-use default blueprint.

API Setup

curl -X POST http://localhost:8084/v1/admin/integration-catalog/roomvo/install \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Roomvo",
    "variant": "default",
    "config": {
      "retailer_id": "retailer-abc-123",
      "api_key": "your_api_key"
    },
    "delivery_mode": "server_side"
  }'

Event Mapping

Signal events are mapped to Roomvo events via your blueprint. Common mappings include:

Signal Event	Roomvo Mapping	Notes
`visualiser_open`	Visualiser session start	Tracks when a user opens the AR/VR product visualiser
`product_view`	Product try-on	Map product SKU and category for visualisation tracking
`purchase`	Conversion event	Links purchases to prior visualiser engagement
`add_to_cart`	Cart event	Tracks add-to-cart actions following visualiser interaction

Roomvo attribution works by linking purchase conversions back to visualiser engagement. Include the Roomvo session ID or visualiser interaction reference in your events for accurate attribution.

Testing

Open the Roomvo visualiser on your site and interact with a product to generate engagement events.
Send a test event through Signal using the Test Event button on the integration detail page.
Contact your Roomvo account manager to confirm the event was received.
Check Live Logs in Signal to confirm delivery returned 200 OK.
Review attribution reports in the Roomvo dashboard once test events are confirmed.

Troubleshooting

Symptom	Cause	Resolution
`401 Unauthorized`	Invalid API key	Contact your Roomvo account manager to verify or regenerate the API key.
`400 Bad Request`	Missing required fields	Verify the event payload includes the required fields agreed with Roomvo.
Events not appearing	Wrong retailer ID	Confirm `retailer_id` with your Roomvo account manager.
Attribution not linking	Missing visualiser session reference	Include the Roomvo session or interaction ID in conversion events.

Visit Roomvo or contact your account manager for full API documentation and support.

Ringier Axel Springer Poland ActionIQ