The Sales Data Configuration feature lets you track completed orders (sales) in Doofinder. Once set up, it unlocks features such as:
- Best-seller logic in Recommendations
- Search conversion-rate statistics
- Accurate checkout cart and sales performance insights
By configuring this section, you will enable advanced sales data collection, helping you improve your sales through solid analytics and enhanced product recommendations.
Sales Data Prerequisites
- New Doofinder users: Single Script installed
- Older Doofinder users: Single Script updated
Sales Data tracking only works if the Single Script is correctly installed on your website.
Accessing the Sales Data Panel
To configure Sales Data:
- Go to your Doofinder Admin Panel > Configuration > General Settings.
- Select your Store in the top-bar.
- Open the Sales Data panel.
This section includes three parts:
- Select your sales data source
- Checkout Summary Pages URLs
- Payment Confirmation Page URLs
Managing Sales Data configuration at store level ensures that all Search Engines are configured consistently in one place. If you use checkout and confirmation URLs, make sure to configure all checkout and payment URLs for every Search Engine in this panel.
Select Your Sales Data Source
You can choose between two options:
- Use checkout & confirmation URLs (recommended)
- Receive sales data via API (advanced, for exact precision)
The Checkout & Confirmation URLs option is the easiest and fastest way to send sales data, as it uses the Single Script to automatically gather and display data.
Select the API option only if:
- You have technical knowledge, and
- You do not have the Single Script installed or updated.
If using API, read the Sales Data API Integration section to configure Sales Data.
Even if using the API, you must still configure the Payment Confirmation Page URLs.
How to Configure Checkout Summary and Payment Confirmation URLs
- Checkout Summary Pages: these are the pages where customers review their selected products before payment (usually the cart page).
- Payment Confirmation Page: these are the pages customers reach after completing payment (typically a “Thank you” page).
To configure these:
-
Enter your checkout and confirmation page URLs in the corresponding boxes.
Ensure all URLs belong to the same domain or add URLs for each language version.
-
To add more URLs, click "+ Add URL”.
- To remove a URL, click the trash icon next to it.
- Once finished, click "Save" at the bottom of the panel.
Types of URL Configuration
You can configure both page types using one of four matching methods:
| Type | Use Case | URLs Examples |
| Contains | For partial or simple URL patterns to match all URLs sharing the same structure. | https://learn.doofinder.com/cart matches fr/cart/, checkout/cart/index/
|
| Equals | For exact URL matches. | https://learn.doofinder.com/confirmation-order/ (to only match this URL)
|
| Starts With | When URLs include dynamic parameters after a fixed base path (e.g., per region). | https://learn.doofinder.com/cart, matches /cart/es
|
| Regex | For advanced cases requiring precise pattern control. Use only if simpler options don’t work. | https://learn.doofinder.com/payment-method/*/credit-card(use asterisk to match anything in between)
|
URL Configuration Considerations and Best Practices
After delving into the examples of URLs that can be used to configure sales data, make sure you consider the following aspects:
Ensure Doofinder Script Loading
The Doofinder script must load on all checkout and confirmation pages; otherwise, no sale events will be registered.
Using the Correct Page URL
When adding a URL to each section of the Sales Data Panel, use the correct page URL.
Only enter cart or checkout URLs for Checkout Summary Pages, and order confirmation URLs for Payment Confirmation Pages.
Too Generic URLs
Generic URLs likehttps://support.doofinder.com/ or Regex patterns with only an asterisk (id=*) will not work correctly.
Always include the specific checkout or confirmation page path.
Incorrect or Overly Specific URLs
Incorrect URL settings prevent sales tracking. For instance:
/es/carrito?action=showid234or/confirmation-order?user_id=234will only match a single user or order./pay/?orderId=VQ2G5LL3LRwill only match that specific order.
Sales Data API Integration
Remember, this applies only if you choose “Receive sales data via API (advanced, for exact precision)” instead of the Checkout Summary Pages URLs.
Find full access to the API documentation to integrate cart sales data via API.
API Integration Steps
- In the Doofinder Admin Panel, select Receive sales data via API (advanced, for precise control).
- Implement this API request in your checkout flow
Statistics Currency
In this section, you can set a default currency. This currency will be applied across your store’s home stats, ensuring all sales and performance data are displayed consistently in the same currency.