Product Tours

Hints

Feedback

Life Ring Button

Announcements

Live debugging

Test in Chrome without installation

Dynamic URLs

Segmentation and custom data

Installation overview

Overview

User data, security & GDPR

Selecting and targeting elements

Analytics platforms integrations

Typeform integration

ZenDesk

Freshdesk

Share product tours by link

Product Fruits is not loading

Recordings and screenshots restrictions

API Overview

Crisp

Multi-tenant applications

How to embed checklists to custom elements

API-driven checklist items

Checklists

How to design tours for mobile web

Intercom

ActiveCampaign integration

Identifying users

Installation to Angular

Installation to other web platforms

RTL/LTR languages customizations

HubSpot Chat

HubSpot integration

Popular CSS snippets examples

Easy to adjust CSS variables

Customize Life Ring Button

Adjust styles for different devices

Installation to React or NextJS applications

Web applications (legacy script)

A/B testing via Google Optimize

Product Fruits branding

Custom JavaScript triggers

How to get adoption feedback from users

Content Security Policy

Product Fruits shows only blank cards

Waiting for the target element

URLs don't match

Segmentation doesn't match

Users tracking modes

Segmentation

Installation to VueJS

Custom Chat Widget

Restarting the content for users

Content personalization

Advanced diagnosing

Dynamic CSS classes or attributes

Sites without authentication

US location installation instructions

Installation via Google Tag Manager

Installation via NPM package

Custom events

Custom buttons and JavaScript actions

How to localize your content

Employees training

Embedding knowledge base

Segment.io integration

Moving layout for banners

Handling different environments - staging vs production

Analytics

Tours/hints editor is not loading

Segmentation rules import

Tracked Users batch update

Feedback webhooks

React component 2.0 - beta

Getting Started

Tours & Hints

Tours

Tutorials

Useful CSS snippets

Something is not working? Find the help here.

Troubleshooting

Debugging

External Integrations

Chat Providers

Developers

Installation

JavaScript API

Server-side API

Experimental features

<p>If you want to try Product Fruits and you don't have time for inserting our JavaScript code snippet into your application, you can install our Product Fruits extension and try it directly in your browser. The extension features are limited (e.g. you can't use segmentation), but it is a great way to start with Product Fruits.</p><p><strong>If you are creating a new workspace</strong>, you can choose the Chrome Extension path in the wizard and it will guide you through all steps.</p><p><strong>If you joined an existing workspace</strong>, follow this:</p><ol><li>Install our <a href="https://chrome.google.com/webstore/detail/product-fruits-presenter/gfalakmkgcpgdbhkidmehfgcokbilime">Chrome extension</a></li><li>Log in to Product Fruits and after the login, click on the extension icon in the Chrome toolbar (it maybe folded under the puzzle icon).</li><li>The extension panel should load and you should see the workspace listed in it</li><li>Now, you can use the editor and see the Product Fruits content live</li></ol><h3>Potential issues</h3><p>The Chrome extension serves as the first step for testing Product Fruits. However, some features can be limited because proper JavaScript integration is needed. For example:</p><ul><li>Segmentation won't work as the extension won't get your application data</li><li>URL filtering is limited</li><li>If your application uses particular front-end frameworks, tour triggers might be limited</li></ul><p>&nbsp;</p>

<p>Tours and Hints tools are bound to URLs in your application. This is important because it allows us to show the right content in the right place. If we didn't take URL addresses into consideration, tour cards or hints could display randomly in different places. Usually, this isn't something you want. You don't have to fill them out, URLs are bound automatically while you create cards in our editor.</p><figure class="image"><img src="https://res.cloudinary.com/product-fruits/image/upload/v1615310647/Docs/url1_p7f6uf.png" alt=""></figure><p>However, there are cases you need to check.</p><p>Applications may use dynamic URLs. It is very common in web applications to have different URLs for different users, projects, or any other entities. As an example, we can consider a project management application with a tasks feature. When you browse tasks, you may get URL like this:</p><p><code>https://example.com/projects/123/tasks</code></p><p>This URL is a typical example of a dynamic address. Notice <code>123</code> in it. As a user selects a different project, it changes. If you kept this URL assigned to a card, it would mean it would show just for this particular project.</p><p>To solve this, dynamic parameters can be replaced by special placeholders. These placeholders will tell Product Fruits, that these parts of the URL address can change.</p><h2>Dynamic placeholder</h2><p><strong>The first possible placeholder</strong> is <code>[dynamic]</code>. This is the most common placeholder. Most of the time, you don't have to take care of replacing it manually, because we try to detect dynamic parameters (we replace all numeric values and/or some special cases automatically). However, it's good to check the final URL template. It should look like this:</p><p>&nbsp;</p><figure class="image"><img src="https://res.cloudinary.com/product-fruits/image/upload/v1615310892/Docs/url_dynamic_m4prod.png" alt=""></figure><p>&nbsp;</p><h2>Specific placeholder</h2><p><strong>The second possible placeholder</strong> should be used in specific use-cases. Let's say you'd like to launch a tour from our Life Ring Button from any page in your application. When users click on the tour launcher, Product Fruits should redirect to the page where the first card starts.</p><p>To do that, Product Fruits have to know how to construct the URL to redirect to. This is not possible with the&nbsp;<code>[dynamic]</code> placeholder, because we don't know what value should we use for the&nbsp;<code>[dynamic]</code> part.</p><p>To solve this problem, you have to provide custom context attributes to Product Fruits. <a href="https://help.productfruits.com/en/article/segmentation-and-custom-data">Read more on it here</a>.</p><p>After these attributes are available, you can use them as placeholders. For instance, you provided the <code>projectId</code> custom attribute. You can refer to this property as&nbsp;<code>[d.props.projectId]</code>. It should look like this:</p><figure class="image"><img src="https://res.cloudinary.com/product-fruits/image/upload/v1615310893/Docs/url_d_props_eqz7zs.png" alt=""></figure>

<p>Product Fruits installation is easy, but there are things you need to do to implement it properly. Let's take a deeper look at the basic principles of Product Fruits.</p><h2>General information</h2><h3>Identifying users</h3><p>You must identify the current user - the user who is currently logged in to your application. You can also pass more additional properties that can be used for better segmentation.</p><p><a href="https://help.productfruits.com/en/article/identifying-users">Read more here</a>.</p><h3>Content Security Policies</h3><p>If your application enforces Content Security Policies (CSP), <a href="https://help.productfruits.com/en/article/content-security-policy">enable our domains</a>.</p><h2>Installation instructions</h2><h3>React and NextJS applications</h3><p>Product Fruits can be integrated with React and NextJS applications. We provide our NPM component that is easy to use. It handles all common use cases.</p><p><a href="/en/article/developers-integration-react-nextjs">See our guide for React and NextJS applications.</a></p><h3>NPM package</h3><p>You can use our NPM package, <a href="https://help.productfruits.com/en/article/installation-via-npm-package">see this article</a>.</p><h3>VueJS applications</h3><p>If you use VueJS, <a href="https://help.productfruits.com/en/article/developers-installation-to-vuejs">check out this</a>.</p><h3>Angular applications</h3><p>If you use Angular, <a href="https://help.productfruits.com/en/article/developers-installation-to-angular">follow this</a>.</p><h3>Other web platforms - JavaScript snippet</h3><p>If you use any other frontend framework, you can follow this guide. You'll have to insert a short JavaScript code snippet and that's it.</p><p><a href="https://help.productfruits.com/en/article/developers-installation-to-other-web-environments">See our guide for web applications.</a></p><h3>Google Tag manager</h3><p>If you use Google Tag Manager (GTM), you can also install Product Fruits.</p><p><a href="https://help.productfruits.com/en/article/google-tag-manager-installation">See our guide for Google Tag Manager</a></p>

Go back to application