How to speak on the page
Choices:- Our one-line card (default). The dark card in the bottom corner. See What shoppers see.
- Your popup tool. The app tells a popup tool you already run to show a campaign you designed, at the moment the shopper is stuck. This choice appears only after the app has seen the tool on your storefront (it looks once a day), so you are never offered a tool you do not have. Supported: Klaviyo forms, Privy, OptiMonk, Justuno, Wisepops.
- A browser event, for your developer. The page fires a
nextintent:momentevent with the sentence, the link label and the link path. Nothing is drawn. Your developer decides what to do with it. See The card and the event in the developer docs. - Nothing on the page. The sentence is composed and recorded but not delivered. Useful for a store that wants the moments record without any delivery at all, which is the same as watch mode except the left-alone comparison still runs.
Setting up your popup tool
When you pick Your popup tool, three fields appear:- Which tool. Only the tools seen on your storefront are listed.
- Campaign id. The campaign in that tool that should show. Build it there first, in your own style, and set its trigger to “custom event” or “show only when triggered” so it waits for us. Under the field is a one-line note on where that tool keeps the id.
- Campaign id for a declined code (optional). A second campaign used only when the sentence is about a discount code that did not take. Leave it empty to use the first for everything.
How “helped” is confirmed with each choice
The app counts a shopper as helped, and bills the order, only when it knows the shopper saw something.- Our card: the card was drawn. The app drew it, so it knows.
- Your popup tool: the tool confirms it displayed the campaign. Klaviyo and Wisepops report this themselves; for the others the app watches the page for the popup to appear. If nothing is confirmed within 8 seconds, the moment is recorded as “handed to your popup tool, it did not show” and is never counted or billed. The app does not show its own card in that case; you chose your tool, and two popups would be worse than none. If the tool is simply missing from a page, our card steps in for that shopper and counts as usual.
- The browser event: your developer’s code calls
NextIntent.shown(id)after it renders. Until it does, nothing is counted or billed; after 8 seconds the moment is recorded as “not confirmed”. - Nothing on the page: no shopper is ever helped and nothing is billed.
If your tool stops confirming
A store could let the sentence show and never confirm it, and would then never be billed. The app watches for that: ten or more hand-offs with fewer than half confirmed, ten or more of our cards with fewer than half reported shown, or the browser event with no confirmation at all. When that happens, a note appears under this choice, on Home and on Money: “Your popup tool is not confirming what it shows. Since [date], we count the moments we hand to it as helped, and bill on that.” For the rest of the month, hand-offs count. Fix the campaign id, make sure the campaign is live and waits for our trigger, or switch to our card; from the next month, confirmation counts again. The full rule is in What “helped” means.May a card mention an offer?
Choices: No. Facts only. (default) or Yes, from my active discount codes. No: no sentence contains a discount, code or percentage, ever. A shopper whose code was declined is told the code is not valid here, then a fact: the free shipping line, or nothing more. Yes: a shopper whose own code was declined can be told a real code from your Discounts: “That code isn’t valid here. WELCOME10 takes 10% off a first order.” Only in that situation. A shopper who did not try a code is never offered one. See Discount codes for how codes are chosen and why offers are off by default.Delivery promise
A short line, for example: “Ships in 1 to 2 business days.” Used for: a shopper who stalls on a shipping or delivery question can be told when their order ships. The app cannot read this from Shopify, because Shopify has no single field for it, so you state it here. Leave it empty and no sentence mentions delivery time.Size guide path
A path on your store, for example:/pages/size-guide.
Used for: the link under a size sentence. A shopper flipping between sizes on a hoodie page sees the product’s note with “Size guide →” beneath it, pointing here.
Rules: it must be a path on your own store, starting with /. Full URLs to other sites are not accepted, because a card never links off your store.
Leave it empty and size sentences have no link.
