Sidekick and Flow
Marutto Search's data is available to Sidekick, Shopify's AI assistant, and to Shopify Flow, Shopify's automation.
| What you can do | Plan |
|---|---|
| Ask Sidekick how search is doing | Every plan (what each plan sees is below) |
| Ask Sidekick why a product is missing from search | Every plan |
| Have Sidekick find reviews and draft replies | Basic and up |
| Receive search data in Flow (weekly report, searches with no results, ...) | Pro ("Search sync issue" is on every plan) |
| Change search from Flow (priority, hiding, synonyms, redirects) | Pro |
| Start from a Flow template (six of them) | Pro (the review alert is on Basic and up) |
Sidekick
Ask Sidekick in the Shopify admin, in your own words. It answers whether or not Marutto Search is open.
| Ask something like | It answers from | Plan |
|---|---|---|
| "How did search do last week?" | Searches, the no-results rate, the click rate, the most searched terms | Every plan |
| "How much does search sell?" | Orders and revenue from search, against the period before | Pro |
| "Which searches found nothing?" | Search terms with no results, and how often | Pro |
| "What do people who search for 'gift' buy?" | That term day by day, the products clicked and bought after it | Pro |
| "Which searches find this product?" | The terms that led to clicks and orders of the product | Pro |
| "What should I fix in search?" | The improvement suggestions (synonyms, redirects, product priority, ...) | Pro |
| "Why doesn't this product come up in search?" | The index, its status, excluded tags, rules that hide it, out-of-stock handling | Every plan |
| "Which reviews are waiting?" "What's rated poorly?" | Review counts, the average, low-rated products, what reviews say | Basic and up |
| "Show me my synonyms" | Synonyms, redirects, product priority and keyword display rules | Pro |
- The report period is the admin report's: Free covers the last 7 days, Basic the last 30, and Pro chooses 7, 30 or 90
- Sidekick reads only the search and review data Marutto Search holds. The names of customers who wrote reviews are never passed to it
- The improvement suggestions can take some tens of seconds to work out the first time. If Sidekick says they are being prepared, ask again shortly
Acting from Sidekick
Sidekick does not change Marutto Search's settings on its own. A change is made on the Marutto Search page Sidekick opens, after you check it and save.
- Reply to a review, publish it, or hide it: ask "reply to this review" and the review's page opens with a draft in the reply field. Nothing is shown on your store until you save
- Add a synonym, a redirect or a product priority, or hide a product from search: ask "add 熨斗 as a synonym for のし" and Sidekick checks that it can be added, then gives you a link to the page with the values filled in. Save there. To add to a word that already has synonyms, use Edit beside that word in the list the link opens
The "Ask Sidekick" button
On stores where Sidekick is available, Marutto Search's Search improvements pages (the report, the search terms table, the suggestions) show an Ask Sidekick button. It opens Sidekick with a question about that page.
If Sidekick does not appear
Sidekick is a Shopify feature and is not available on every store. Where it is not, the button is not shown.
Shopify Flow
In Flow, Marutto Search is listed as Maru Search & Filter, its name on the Shopify App Store. Look for that name when filtering templates and when picking a trigger or an action.
Templates
The workflows merchants set up most often are in Flow's template library, ready to install. There is no need to build them step by step.
| Template | Starts | What it does | Plan |
|---|---|---|---|
| Send an internal email when a search term keeps finding no results | The Search with no results trigger: a term found nothing 3 or more times in 7 days (once a week for a term, up to 20 terms a day) | Emails the term and the count | Pro |
| Send an internal email when a search term is trending | The Trending search term trigger: a term was searched 5 or more times in the last 7 days and at least twice as often as in the 7 days before (once a week for a term, up to 10 terms a day) | Emails the term and the searches of both periods | Pro |
| Send an internal email when the weekly search report is ready | The Weekly search report trigger. Every Monday morning (Japan time) | Emails the searches, no-result rate, click rate, orders and revenue from search, and most searched term of the week before (Monday to Sunday) | Pro |
| Prioritize a product in search for 14 days when it is added to the store | Shopify's Product created trigger: a product is added to the store | Prioritizes the product (priority 2) and removes the priority 14 days later | Pro |
| Add an order tag when an order comes from site search | The Order from search trigger: an order that came from search is confirmed | Adds the tag 検索経由 ("from search") to the order, so the order list can be filtered by it | Pro |
| Send an internal email when a low-rated review is submitted | The Review submitted trigger: a review is submitted and waits for approval | For a review of 2 stars or lower, emails the rating and the review ID | Basic and up |
To install one:
- Open Flow in the Shopify admin and click Browse templates
- Filter the templates by app and pick Maru Search & Filter
- Pick a template and click Install. The workflow is added turned off
- For a template that sends an email, open the Send internal email step and enter the recipient (To)
- Click Turn on workflow
- The subject, the message, the days to wait, the tag and the priority can all be changed after installing
- What the search triggers hand to a workflow (the variables an email can use) is listed under Triggers
- Prioritize a product in search for 14 days also removes a priority you set on that product yourself in the meantime. Turning the workflow off leaves the priority on the products still waiting; remove it under Product priority in Marutto Search (Boosts and pins)
- Up to 200 products can be prioritized at once, counting the ones you set yourself. A product added beyond that is not prioritized
Triggers: receiving search data
Pick Marutto Search under Select a trigger in a workflow.
| Trigger | Starts | Plan |
|---|---|---|
| Weekly search report | Once each Monday from 9:00 Japan time, with the week before (Monday to Sunday) | Pro |
| Search with no results | Daily from 9:00, for each term that found nothing 3 or more times in the last 7 days (a term once a week) | Pro |
| Trending search term | Daily from 9:00, for each term searched 5 or more times in the last 7 days and at least twice the 7 before | Pro |
| Order from search | When an order that came from search is confirmed. Once an order | Pro |
| Search sync issue | When syncing the search index fails, or a product-count drift is rebuilt | Every plan |
A day's starts are capped: 20 terms a store for searches with no results and 10 for trending terms, the most searched first.
Weekly search report variables
| Flow variable | Meaning |
|---|---|
periodStart | First day of the period (a Monday, YYYY-MM-DD) |
periodEnd | Last day of the period (a Sunday, YYYY-MM-DD) |
searches | Searches |
zeroResultSearches | Searches with no results |
zeroResultRate | Share of searches with no results, in percent |
clickRate | Share of searches with a click, in percent |
orders | Orders from search |
revenue | Revenue from search |
currency | Currency of the revenue |
topQuery | Most searched term |
topZeroResultQuery | Most searched term with no results (- when none) |
eventId | An ID to dedupe by |
A week with no searches starts nothing.
Search with no results and trending search term variables
| Trigger | Flow variables |
|---|---|
| Search with no results | query (the term), zeroResultSearches (times it found nothing in the last 7 days), searches (searches in the last 7 days), lastSearchedAt (UTC), eventId |
| Trending search term | query, searches (last 7 days), previousSearches (the 7 days before), growthRate (how many times as many; 2 is double), eventId |
To act only on busier terms, compare zeroResultSearches or searches in a Flow condition (for example, notify only at 10 or more).
Order from search variables
| Flow variable | Meaning |
|---|---|
order | The order (a reference) |
query | The search term that led to the order (the larger amount, if several) |
revenue | Amount of the products bought through search |
currency | Currency of the amount |
productCount | Number of products bought through search |
eventId | An ID to dedupe by |
"From search" means a shopper opened a product from the search results and bought it within 24 hours. The trigger starts once the order is confirmed, on stores where purchase measurement is on.
Search sync issue variables
| Flow variable | Meaning |
|---|---|
kind | full_sync_failed (a full sync failed), index_rebuilt (a drift was rebuilt), index_rebuild_failed (the rebuild failed) |
reason | capacity, shopify_api (Shopify's response), count_mismatch (the product counts differed), error (anything else) |
occurredAt | When it happened (UTC) |
eventId | An ID to dedupe by |
A store is told about a failure once a day at most.
Deduping
Flow can deliver a trigger twice for one event. Where a second notification or tag would matter, dedupe by eventId.
Actions: changing search
Pick Marutto Search under Add an action in a workflow. All of them are Pro's.
| Action | Input | What it does |
|---|---|---|
| Add synonym | Word, synonyms (comma-separated, up to 20) | Adds synonyms for the word, or adds to the ones it has |
| Add redirect | Search term, destination | Redirects the term to a page in the store, updating the redirect it already has |
| Prioritize product | Product, priority (0.1 to 10) | Ranks the product higher in search. 1 is neutral; higher ranks higher |
| Remove product priority | Product | Removes the product's priority |
| Hide product from search | Product | Hides it from every search. Its page and status stay as they are |
| Show product in search | Product | Puts a product hidden with Hide product from search back |
- A destination is a path in the store, starting with
/(for example/collections/sale). Add a redirect to an address outside the store in the admin - Hide product from search adds one rule to the admin's keyword display rules: hidden, for every search term. It counts towards their limit of 300
- A product that is pinned, or given a score multiplier, for every search term cannot be hidden by this action: the step fails and the run history says why. An automation does not overwrite a rule you made by hand. Remove that rule in the display rules first
- Synonym, redirect and priority changes appear in the change history under Settings → Search rules as From Shopify Flow
- An action that runs twice leaves what running it once did
Examples
Prioritizing a new product, hearing about a term that finds nothing or is on the rise, and tagging orders from search are all templates. Once installed, a template can be adjusted:
- Hear only about the terms that fail most: in Send an internal email when a search term keeps finding no results, add a condition "
zeroResultSearchesis at least 10" between the trigger and the email - Change how long a product is prioritized: in Prioritize a product in search for 14 days when it is added to the store, change the days in the Wait step
- Change the tag: in Add an order tag when an order comes from site search, change the tag in the Add order tags step
Keeping sold-out products out of search needs no workflow: under Settings → Search, set Out-of-stock products to Hide, on every plan (Out-of-stock handling).