Skip to content
Hellostore Theme

Measurement beacon

This section tracks customer events such as page views, product views, cart additions, FAQ openings, chat openings, and return or support form starts. It renders no visible content and does not change product presentation or shopping navigation.

Origin: Hellostore original

Placement

Section titled “Placement”

Choose Measurement beacon from Add section in the theme editor. To use it across the storefront, place one instance in the header group. Avoid placing multiple instances on the same page.

Settings

Section titled “Settings”
  • Measurement mode: The default is Disabled, which sends nothing externally. Test includes preview themes and marks their events as test data. Production excludes preview themes from the experiment.
  • Measurement market: Enter two lowercase letters, such as the default us. This is separate from the storefront language. Invalid formats prevent external delivery.
  • Event endpoint URL: The service that receives measurement events. Use the URL supplied by the person operating that service. An empty value prevents external delivery. In addition to the event endpoint, the receiving service must provide /api/cart-stamp on the same origin. This endpoint associates the cart with the experiment.
  • Experiment ID: The experiment identifier, for example fit-base-01. An empty value disables experiment measurement. Visitors are assigned evenly to two groups; this section presents the same experience to both groups.
  • Assignment version: Defaults to 1. Use a positive integer. Changing it creates a new visitor assignment, so change it when starting a new experiment period.
  • Excluded markets: Comma-separated, two-letter lowercase values, for example ja, fr. These are compared with the configured measurement market.
  • Debug logging: Off by default. Turn it on to log events in the browser console.

External delivery

Section titled “External delivery”

External measurement requires Test or Production mode, an endpoint URL, an experiment ID, a correctly formatted market, and the visitor’s consent to analytics processing. The theme editor’s embedded preview does not send events.

Without consent, the section does not send externally or create an assignment. Excluded visitors receive no assignment, but an exclusion-reason event is sent when consent is present.

Local events can still be recorded in dataLayer and an in-memory browser buffer when external delivery is disabled. Check the receiving service separately to confirm aggregated results.

Section titled “Related information”
  • FAQ — FAQ openings are one of the recorded events