Troubleshooting

The script does not load

Check, in order:

1. curl https://runtime.tryproa.com/v1/s/<siteKey>.js returns JavaScript. A 404 means the site key is wrong or the site was never initialized in the dashboard.
2. The tag is actually in the theme: view the storefront's page source. A green curl with a missing tag looks identical to a correct install from Proa's side.
3. The storefront hostname is in the authorized hosts of the published snapshot. The Runtime refuses to run on unauthorized hostnames, and host changes only apply on publish.

The page flickers

First question: was the tag installed with async? If yes, the flash of original content is the documented tradeoff of that mode, not a bug — see Blocking or async. Switching to blocking is one attribute in the theme.

I see no measurement numbers

Numbers are aggregated periodically, not live. Reading the situation:

| Situation | Reading | | --- | --- | | Installed minutes ago, no numbers | Normal. Wait for the next aggregation. | | Numbers exist but are small | Normal for low traffic. These are aggregates, not a live feed. | | Real traffic, hours passed, still zero | Check: is telemetry enabled and published? Is the hostname authorized in the published snapshot? Does the tag load? | | You are testing through a preview link | Previews never emit events, by design. |

Telemetry works, revenue does not

That is the order connection, not the Runtime. On a store connected through the Proa Shopify app, check in Site settings that the store is still connected and which installation is primary. On the manual path, confirm both attribution settings are present (webhook secret and shop domain), then check the webhook registration in Shopify and its delivery log for the Order payment topic. Either way, place one test order through the store's normal checkout and watch for it.

The funnel has no checkout steps

The steps between cart and orders come from the checkout pixel, which exists only on stores with the Proa Shopify app. If the app is installed, check Site settings for Checkout pixel: Missing and use Provision pixel. If the pixel is in place and the steps still look thin, remember it only counts checkouts the shopper's privacy consent allowed it to see — the coverage among paid orders section on the experiment states exactly how large that gap is.

Two Proa tags on the same page

After installing through the Shopify app, a leftover manual snippet in the theme shows up in Site settings as two tags seen on the same page. Only one copy runs, so nothing double-counts, but remove the manual snippet from the theme and keep the app embed. The card says when the duplicate was last seen, so you know whether removing it worked.

Something else

Use the Support entry in the dashboard sidebar: it arrives with your website context attached, and during the alpha it is answered by the team that builds Proa.