Install the demo travel website
You'll now install and run the example travel website that you'll use to test Snowplow Signals personalization. This website represents a typical e-commerce travel platform where users browse destinations, read content, and interact with various features.
The demo website is part of the Snowplow Local repository. It's a React application.
Clone Snowplow Local#
Clone the Snowplow Local repository to your machine:
git clone git@github.com:snowplow-incubator/snowplow-local.git
Change directory into the snowplow-local folder:
cd snowplow-local
Configure environment variables#
Create an .env file based on the example file:
cp .env.example .env
Edit the .env file with your Signals connection credentials:
- CDI
- Sandbox
NEXT_PUBLIC_SNOWPLOW_SIGNALS_API_URL=signals.snowplow.com
SNOWPLOW_SIGNALS_API_KEY=
SNOWPLOW_SIGNALS_API_KEY_ID=
SNOWPLOW_SIGNALS_ORGANIZATION_ID=
NEXT_PUBLIC_SNOWPLOW_COLLECTOR_URL=
If you plan to use the AI agent add an OpenAI API key (OPENAI_API_KEY) to your .env file.
Run the travel website#
Run the following Docker command:
- CDI
- Sandbox
docker compose --profile travel-site up
Test the website#
Open the travel website in your browser at http://localhost:8086. You should see the homepage of the travel site.
Open your browser's developer console (Ctrl+Shift+I or equivalent) and go to the Snowplow Inspector tab. Generate some events by clicking on filters on the destinations page. You should see self-describing events firing into your Snowplow pipeline.
Explore the site to get familiar with its features before you define the attributes in the next step.