Only this pageAll pages
Powered by GitBook
Couldn't generate the PDF for 115 pages, generation stopped at 100.
Extend with 50 more pages.
1 of 100

Smaply Helpdesk

Loading...

RELEASE NOTES

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Getting Started

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Journey editor

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Dashboard

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Portfolio

Loading...

Loading...

Loading...

Integrations

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Metrics

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Planning Items

Configuring the Office 365 Excel integration

From the Account settings page, click on the "Integrations" section and then click 'Set up' or 'Edit' on the "Office 365 Excel" integration.

See detailed instructions:

  • Service Account

  • Microsoft Account (OAuth)

Office 365 Excel

Metrics tools

Get started videos

How to create and edit a journey map (< 2mins)

How to use icon cards (< 1min)

Copy/paste lanes across journeys

You can copy entire lanes — including all their content — across different journey maps, even between workspaces or accounts.

How it works

  1. Copy a lane Open the lane menu (the three-dot menu in the lane header) and select Copy lane.

  2. Paste it anywhere Go to any journey map — it can be in the same workspace or another one — and press CMD + V (Mac) or Ctrl + V (Windows).

  3. Choose where to paste A banner will appear at the bottom of your screen. Use the dropdown to select under which lane you’d like to paste your copied lane.

💡 Tip: If you just want to duplicate a lane within the same map, use Duplicate lane below from the lane menu instead.

Filters and views

Tailor your journey map to match your workflow or presentation needs with the filter and view options.

Instead of overwhelming visuals, focus on specific lanes or personas by utilizing the filter function. Filters and saved views can enhance collaboration and presentation.

Saved views are accessible by anyone who has access to the map and can be shared with the team via URL. You can see the name of a saved view right behind the journey title.

Customize your experience with as many different views as your workflow requires.

Saved view
All saved views

Invite users directly to journeys

You can invite people to a journey map, even if they are not part of your workspace or account.

How to invite users:

  1. Click the Share icon in the top menu of the journey editor, or open the three-dot menu in the journey map list and select "Share".

  2. In the "Manage user access" section, enter the email address of the person you want to invite.

  3. Choose their permission level (Admin, Editor or Viewer).

  4. Click Invite.

All journey maps shared with a user appear on their dashboard under the "Shared from outside" section.

WELCOME

Welcome to the Smaply Helpdesk! Here, you'll find everything you need to make the most out of Smaply. From step-by-step guides and feature explanations to troubleshooting tips and best practices, our helpdesk is your go-to resource.

Whether you're just getting started or looking for advanced tips, explore the categories to find answers, tutorials, and insights that help you navigate and excel in journey management with Smaply.

Jump right in

October

🚀 New Features

  • Account Library: manage and reuse key content – journey maps, personas, opportunities, pain points, solutions, and metrics – across all workspaces within your account

  • Smaply Classic Import Tool: Classic users can now automatically migrate their maps into Smaply 3.0.

  • Customizable portfolio items: allowing teams to customize opportunity, pain point, and solution representations to their workflows

  • Copy and paste lanes between journey maps

🔧 Improvements

  • New onboarding assets: Upon creating a new account, users will see demo personas, portfolio items and metrics in their account.

  • PDF export: Portfolio item summaries can be added via journey map export modal.

  • Portfolio:

    • Added an updated date filter and “Last Updated” column to portfolio tables for better tracking of recent changes

Switching between accounts

To switch between your personal and organization account – or if you have multiple shared accounts – use the menu at the bottom of the main sidebar menu. See how:

Share journey maps

Smaply offers two ways to share journey maps:

  1. Invite users directly – Grant access to specific people for editing or viewing a journey map.

  2. Read-only sharing (HTML sharing) – Share a view-only version of a journey map via link, even with people who don’t have a Smaply account.

Table actions

Smaply offers an organized way to manage your journey maps, personas, metrics, and portfolio through intuitive tables. Here’s an overview of what you can do in each section:

  • Search and filter: Quickly locate specific table items by applying filters or using the search bar.

  • Save views: Create and save customized table views with specific filters for yourself or your team.

  • Sort: Arrange table items by name, creation date, or other criteria.

  • Favorite: Mark journey maps, templates and saved views as favorites for quick access from your dashboard.

  • Duplicate journey maps, templates or personas to use them in other workspaces for collaboration or organization.

  • Update multiple items simultaneously to save time and streamline workflows.

July

🚀 New Features

  • Image card shapes: Change the shape and aspect ratio of images

January

🚀 New Features

  • Planning Cards for Asana, Azure DevOps, and Linear: Integrate your planning tools directly by adding from Jira, Trello, Asana, Azure DevOps, and Linear.

Join by invitation

Accept an invitation to a shared account, workspace or journey map

In addition to signing up for an account on the Free plan, you can be invited to a Shared account, e.g. by your company or organization.

In Smaply, you can be invited on three levels:

  1. Account level: Access to the whole account with all its workspaces

  2. Workspace level: Access to certain workspaces within an account

2024

Here, we’ll keep you updated on the latest improvements and new features in Smaply. Check back monthly to see what’s new and how we’re making Smaply even better.

Jump right in

Exporting journey maps

Export your journey maps in Smaply with just a click.

Navigate to the top-right corner of the journey map or editor and hit the download icon. This PDF export includes the journey map info section.

1

Select what you want to export

2

Stay on the page until exporting is complete.

HTML sharing of journey maps

With HTML sharing, you can share a read-only version of your journey map with anyone, even if they don’t have a Smaply account.

How to Share a Journey Map

As an Admin you can generate a public link from:

Journey map

Journey maps are the heart of Smaply. Learn more about the journey editor here.

The journey map

The journey editor comprises flexible lanes, columns, and cards, allowing you to drag and drop your content elements anywhere.

September

🚀 New Features

  • Tags for Journey Maps: Easily organize and filter journey maps with tags, streamlining project management.

Smaply: a visual walkthrough

Here you find some screenshots of what your journey map in Smaply could look like. Use these in your presentations to negotiate budget and buy-in.

November

🚀 New Features

  • Divider-lane: Introduced a divider-lane feature for better content organization within canvases.

May

🚀 New Features

  • Rethought : We've refreshed the look and added new building blocks to make your personas even more flexible

Bulk card actions

Selecting multiple cards

You can select cards in three ways:

  1. Lane selection – Select all cards in one lane.

Portfolio matrix

This article focuses on the Portfolio matrix, how to use it, and what personalization features it offers.

In the matrix, you can see the various pain points, opportunities, and solutions created in the journey maps of your workspace.

Here you see the overview of what the matrix looks like. You can filter, choose a different view, and download as a CSV. There is a legend on the right-hand edge that indicates the colors of the circles.

Axes and circle size

Filtering in dashboard lists

Filtering helps you quickly find relevant items in your Journey Map, Portfolio, Metric and Persona lists. You can filter by multiple criteria, such as creator, tags, or last updated date, to refine your search.

How Filtering Works

  • Different filter criteria (e.g., creator, tags, status) always combine with AND.

Copy assets across workspaces

Copying journey maps

You can copy maps to different workspaces of either the same or other accounts.

If you want to share and use the same journey map, persona, or template in several workspaces of the same account, e.g. a high level map that is relevant in all workspaces, we recommend to work with the instead.

August

🚀 New Features

  • Edit multiple cards at once: Select all cards in a lane, all cards in a column, or hand-pick cards with Shift+click.

Enhanced pasting functionality

Paste tables and text

See the quick video for how to paste items from tools such as Excel, Google drive, Miro or Mural

Paste images

Quickly add image cards from pasted images, or simply paste in a screengrab.

June

🚀 New Features

  • Define portfolio statuses and icons in the account settings – now available for all paid plans.

Personas

Learn about persona creation and how to apply them in your journey maps

There are two ways to create personas: either from the dashboard or from within a journey map.

From the dashboard

-> click on Personas in the navigation and then on + Create persona in the top right.

Here, you can edit persona details such as the name, the layout and add relevant sections from our persona template. Once you click

OAuth Authentication for Google Analytics

Get detailed instructions on how to set up your Google Analytics integration with an OAuth Authentication.

Recommended Approach

For enterprise use cases, we recommend using a instead of OAuth. Service Accounts provide more secure and scalable access to Google Analytics data. However, if you prefer OAuth or have specific requirements, follow the steps below.

Prerequisites

A Google account with access to the desired Google Analytics properties

November

🚀 New Features

  • Portfolio Table Configuration Menu to show/hide portfolio columns for improved data visibility and control.

  • Bulk Actions for Personas: apply bulk changes to a persona.

Templates

Templates provide a pre-prepared outline for similar types of projects. If you need to use the same structure multiple times when you are creating a journey map, it is better to prepare a template beforehand and use that template all the time.

How to create a template?

1

AI on the Free plan: AI journey map creation is now available on the free plan, with 3 uses per user per month.

  • Copy & Paste Grid Lanes: Move entire lanes between maps to speed up reuse and iteration.

  • 🔧 Improvements

    • Performance improvements: Faster loading experience, especially for big journey maps and portfolios.

    🚀 Get started with Smaply

    Create or join an account

    👣 First steps

    Start your first project

    🕵️‍♀️ Explore features

    Check out the editor

    Invite users directly to a map

    HTML sharing of journeys

    Copy to other workspaces:
    Bulk actions:
    OAuth Authentication Process​

    1. Initiate OAuth Flow​

    1. Click the "Connect to Google Analytics" button in Smaply

    2. You will be redirected to Google's OAuth consent screen

    2. Grant Permissions​

    1. Sign in with your Google account (if not already signed in)

    2. Review the permissions requested by Smaply

    3. Click "Allow" to grant access to your Google Analytics data

    3. Verify Account Suitability​

    After granting permissions, Smaply will automatically check:

    • If your account has access to any Google Analytics properties

    • The list of properties you have access to

    • Your permission level for each property (e.g., Read & Analyze, Edit, Manage Users, etc.)

    Note: Ensure you're using a Google account that has the necessary permissions for the Google Analytics properties you want to integrate with Smaply.

    Troubleshooting​

    If you encounter issues during the OAuth process or property verification:

    1. No properties available: Ensure your Google account has access to at least one Google Analytics property

    2. Insufficient permissions: Check your access level in Google Analytics. You need at least "Read & Analyze" permissions for the properties you want to integrate

    3. OAuth errors: Try clearing your browser cache and cookies, then attempt the process again

    Tip: If problems persist, contact your Google Analytics administrator to verify your account permissions, or reach out to Smaply support for assistance.

    Token Expiration: OAuth tokens have an expiration period. Smaply will handle token refresh automatically, but ensure you don't revoke the app's permissions in your Google account to maintain uninterrupted access.

    Service Account
    ​

    Portfolio performance boost

  • PDF downloads for library portfolio items

  • This is a journey map comparing the experience of different personas, and connecting opportunities to the map.
    This is a journey map that shows a number of metrics and KPIs, as well as the linked journeys, drilling down into each step (linked, zoomed-in maps).
    Creating a persona is so easy with a customizable drag-and-drop editor. Empathize with your users.
    A journey map that is similar to a roadmap, and can visualize such.
    The portfolio view, where you see the pain points, opportunities and solutions used in journey maps.

    Note: Changes made during this time might be included in the export. So, if you don't want to change anything, make sure you wait until your journey map is ready to download.

    2025

    Monday.com Planning Integration: Connect your Smaply account with Monday.com for project planning and task management
  • Card color options: Card background styles including white, light, solid, and transparent options for more flexibility

  • 🔧 Improvements

    • Drag card edges to span cards on Journey Maps:

    • New card toolbars: New universal card toolbar with simpler editing for Text, Stage, and Image cards

    • Enhanced invitation handling:

      • Invitation links no longer expire after 30 days, providing unlimited time for team onboarding

      • Smart Invitation Auto-Accept: When you have a pending invitation to an account/workspace/journey map and access it via direct link, the invitation is automatically accepted and you're redirected to the resource

      • Pending invitation banner appears when you have outstanding invitations, with quick access to notifications

      • Combined "Shared with me" and "Membership" pages with redesigned interface for better organization

    Save Filters as a View for Tables: Organize your journey map tables with saved views. Create shared views for collaboration or private views just for yourself.

    • Bulk Edit for Journey Maps and Personas: Manage your data efficiently with bulk editing capabilities:

      • Archive, copy, or tag journey maps.

      • Archive and copy personas.

    • Tag and filter personas, portfolio items and metrics: Not only and filter for tags in journey maps and cards, but every item there is!

    • HTML Sharing of a journey map: Share a read-only version of your journey map with anyone via a public link.

    🔧 Improvements

    • Customizable scale-labels for Emotion chart lane: Customize the labels of your Emotion chart scale to better fit your use case - no longer limited to the default -2 to +2 range!

    • Select Workspaces for Google Analytics: You can now select for which workspaces you want to enable your Google Analytics integration, providing greater control and flexibility.

    • Icon card layout: We improved our icon card layout for lots of text and added a "quotes"-template

    • We are now saving your sort order of the tables in your dashboard

    planning cards
    Journey map level: Direct access to specific journey maps

    Once you've received an email invitation to any of the above, there are two options to accept it.

    Option 1: Accepting an invitation from the email

    1. Make sure you're logged into your Smaply account. If you don’t have an account yet, see our "Sign up for a Personal account" article.

    2. Click the "Join workspace/account" or "Access the journey map" link in the invitation email.

    3. The new account or workspace will now be available in your Smaply dashboard. The new journey map will appear under "Shared with me"

    Option 2: Accepting an invitation from within your Smaply Account

    1. Make sure you're logged into your Smaply account. If you don’t have an account yet, see our Sign up for Smaply article.

    2. Navigate to your user icon in the top right corner of your dashboard.

    ‍Tip: a small red dot will indicate if there are any pending invitations

    1. Click on invitations in the dropdown menu

    2. On the invitations page, accept the pending invitation(s)

    3. Refresh your browser: After accepting, refresh your browser, and the new account/workspace will appear in your dashboard. Journey Maps will show up under "Shared with Me."

    The
    journey map editor
    by clicking the
    Share
    icon.
  • The journey map list by selecting Share from the three-dot menu.

  • Steps to Enable Sharing

    1. Click Enable Sharing

    2. Copy the link and share it with anyone who needs access.

    Important: Keep in mind that anyone with the link can view your journey map.

    Password-protected sharing

    Add a password to your shared HTML journey maps, ensuring that only the right people have access. Available for our Governance and Framework plans.

    Journey info panel

    Edit your journey title by simply double clicking it.

    Next to the journey title, you find the dropdown that opens the journey info panel: add a description, a journey performance indicator, a journey coordinator or tags. The info panel also shows a summary of all the portfolio items used in this map, as well as their status.

    Create a journey map

    To create a journey map, you can choose from different options:

    1. Journey creation with Smaply AI

    2. Manually add lanes to your journey

    3. Create a journey from one of yours or our templates

    Google Analytics Integration: Integrate Google Analytics for more in-depth user journey insights.
    • Filters & Condition Bar Integration: Improved filtering with the condition bar across all menus.

    • Main Menu Drawer Component: New drawer component for a cleaner interface.

    • Updated Smaply Logo: We’ve refreshed our logo to match our evolving brand.

    🔧 Improvements

    • Additional Verifications for Account Deletions: Enhanced modal with more safeguards for account deletion.

    • Increased Request Rate Limit: Boosted rate limit for better performance.

    • Metrics Enhancements: Added more customization for metrics display and comparisons.

    Card Tagging: Users can now tag cards, improving searchability and project categorization.

    🔧 Improvements

    • Home Redirect: Clicking the Smaply logo will now always redirect you to the personal dashboard.

    • Tag Selection Improvements: We’ve improved the tag selection experience for a smoother, more intuitive process.

    • User List Sorting: The list of users in your organization is now sorted by name for easier navigation.

    • Portfolio Enhancements:

      • Interactive Portfolio Management: Added an interactive bubble chart and table for managing portfolio items

      • Styling Updates: Enhancements to the Portfolio Page’s styling make the design cleaner and more user-friendly.

      • Portfolio Item Dropdown: We’ve added a dropdown menu in the Create Opportunity button, allowing you to select between Opportunity, Pain Point, or Solution more efficiently.

      • Portfolio Item Modal Enhancements: The Create/Edit portfolio item modal has been improved for a more seamless experience when managing portfolio entries.

    Smart portfolio create: we brought in smarter portfolio item creation to easily search for existing or create new opportunities, pain points and solutions.

    🔧 Improvements

    • Bulk actions: Select and manage multiple templates or archived journeys at once

    • Embed card - Video support: Embed videos from multiple sources

    • Improved view-only mode for journeys & templates + Improved viewer role permissions

    • Portfolio CSV export now respects filters

    personas
    Column selection
    – Select all cards in one column.
  • Manual selection – Hold Shift and click on multiple cards.

  • Actions available for all card types

    No matter what type of card you select, you can:

    • Add or remove tags

    • Add or remove personas

    • Delete the selected cards

    Actions by card type

    When you filter your selection by card type, more bulk actions become available. Examples include:

    • Adding card headers

    • Applying styling and text formatting

    • Change the display type of portfolio cards

    This helps you quickly adjust the look and structure of your map, especially when working with many cards at once

    The axes in the chart view stand for "Impact" and "Reach" of the pain point. "Impact" is the y-axis and "Reach" is the x-axis in this example. "Cost" is in this example the third parameter, and it's decisive for the size of the circle. The taxonomy can be
    of your workspace.

    Filters

    Filtering for portfolio cards is also possible. You can filter for only those in a specific journey map, for types, according to status, priority or assignee. You can combine these filters according to your needs.

    Chart view
    Table view
    customized by the admin

    Within the same filter criterion (e.g., multiple tags), you can choose between AND and OR operators.

    Example: Filtering by tags

    Let’s say you want to filter journey maps by the tags “current-state” and “Level 0”:

    • Using OR – Shows maps that have either "current-state" or "Level 0."

    • Using AND – Shows only maps that have both "current-state" and "Level 0."

    💡 Tip: Active filters can be saved as views, either just for yourself, or for the whole team. Learn more about saved views.

    To copy one of your journey maps into another workspace, click the three dots on the right side of the journey map you want to copy and select "Copy to other workspace."

    After clicking, select the workspaces where you want to copy your journey map. You can copy journey maps to other workspaces of the same account, or even to workspaces of other accounts, if you are a member of more than one account.

    Note that external data such as personas, portfolio items, tags or metrics won't be copied along, but just the content that lives exclusively in your journey map.

    You can copy personas separately, but you would need to assign to the copied map.

    Copying personas

    To copy any persona to another workspace, go to your dashboard and click the persona section. Then, click the three dots on the right side of the persona you want to copy and select "Copy to other workspace."

    After clicking, select the workspaces where you want to copy your persona. After you copy, go to the workspace and click "Personas" to see the copied persona.

    Copying templates

    To copy any template to another workspace, go to your dashboard and click the templates section. There you can click the three dots on the right side of the template you want to copy and select "Copy to other workspace."

    After you copy, go to the workspace and click "Templates" to see the copied template.

    Account Library
    Guest dashboard: New users now see a dedicated guest dashboard when they're not a member of any account, providing better onboarding experience without automatically creating accounts
    • Portfolio edit full screen view: More room for descriptions of your opportunities, pain points etc.

    🔧 Improvements

    • Card header improvements: enable it directly when selecting the corresponding toolbar menu item; Improved visual consistency of card headers

    Bulk actions for cards:

    Step by step

    1: From a journey map, either open the column menu or use the paste keyboard shortcut (Control V or Command V).

    2: Either paste into the selected lane, or manually select the destination lane you'd like the content added to.

    3: Your content will be added as new cards spread accross the lane. Once added you can rearrange as desired.

    Linked portfolio items: You can now connect your portfolio items – pain points, opportunities, and solutions – to each other to create a meaningful network of insights and actions.
    • Display options for Opportunities, pain points, solutions cards in a journey map.

    🔧 Improvements

    • Embed Card Descriptions in Link View: Add context where it matters: You can now add descriptions directly in the link-only card view.

    • Filters and Views in the Journey Editor: Smarter filters, familiar look. The journey editor now matches the dashboard filter style—and you can save your default view.

    • Advanced image selection: More ways to add visuals: Upload, drag & drop, or pick from Giphy and Unsplash to enrich your journey maps.

    Custom portfolio statuses & icons:
    Create
    , you'll be directed to the full persona editor, where you can add more content to it, e.g., a persona description, images, text, icons, or sliders.

    Personas in journey maps

    1. Click on the card you want to add a persona to

    2. Open the card detail sidebar

    3. Scroll down to the persona section

    4. Click "Create new persona" or select an existing persona from the dropdown.

    5. The persona appears in the bottom of your card as little icon

    Creating a template

    Go to the dashboard and click "templates," and then on the top right corner, click "Create a template."

    2

    Using the template

    Once you define and structure your template, you can use it as a journey map.

    3

    Making a template out of a journey map

    You can also create a template from your journey maps. To do this, simply go to your journey maps, click three dots on the right of the journey map, and select "Copy as a template."

    When you click any of your templates within the "journey maps" section, this will automatically create a journey map from your template. Every time you want to create a journey map from your template, you can click one of your templates, and it will create a map for you.

    October

    🚀 New Features

    • Personal Dashboard: A new, personalized dashboard where users can view all of their accounts and workspaces at a glance, along with recent activity, shared journey maps, and more.

    • Account Home Page: Introducing a dedicated dashboard for shared accounts, making it easier to manage and access collective work.

    • Settings Pages Redesign: Settings are now organized into tabs for a more intuitive navigation experience.

    🔧 Improvements

    • Enhanced Tag Management:

      • Updated the color palette for tags and improved the visual design, creating a more cohesive look across the platform.

      • To improve organization, duplicate tags within a category are now blocked automatically, ensuring cleaner tag categorization.

    March

    Check out what we launched in March 2025!

    🚀 New Features

    • New dashboard sidebar: We introduced an improved sidebar experience for easier navigation. You can now switch between your accounts by opening the menu through clicking the little arrow in the lower left corner of your screen.

    • Notification enhancements: See where you were mentioned, invited, or where your help is requested – all in one place.

    • : Say hello to seamless integrations! Embed cards from monday.com, Power BI, and Tableau directly into your journey map.

    • Streamlined modal for creating & : Creating planning and embed cards just got easier with a refreshed modal experience.

    🔧 Improvements

    • : Side panel now supports real-time metric updates

    • Updated card & lane menus: Improved UI for better usability.

    • Membership visibility on invitations page: Users can now view their memberships and leave accounts, workspaces, or maps as needed.

    • Hide deleted memberships: Personal account memberships are no longer shown on the memberships page—keeping things clean and relevant.

    Lanes and columns

    Here you learn about lanes, columns and different card types, and how some show a slight divergence in behavior.

    Adding lanes and columns

    Adding lanes or columns: Hover between two column or lane headers, and a blue plus-button will appear, allowing you to add new elements.

    Add a column

    Managing lanes or columns: click the three-dot menu to move or delete lanes and columns.

    For lanes, there are even more options:

    Lane actions

    Lane and card types

    All lanes and cards are of a specific type, such as text lanes, stage lanes, and more. You might not see all options, depending on what plan you're on.

    Cards added to a lane will automatically have the same type as the lane. But the great thing is:

    Lane type: Grid

    Use the Grid to build channels or tables of any kind. The Grid is made up of sub-lanes, also known as swim lanes, making it ideal for displaying channels, e.g. using the . You can place cards of any type into the Grid, providing a flexible way to organize and visualize different aspects of your journey map.

    Lane type: Emotion chart

    The Emotion chart is used to display the emotional journeys of either personas or non-personas. Emotions are represented as dots on a 5-point Likert scale ranging from -2 to +2 by default, these values are customizable. You can add as many emotional journeys to your chart as you like, allowing for detailed comparison.

    September

    ✨ General news

    • Monthly subscriptions are now available

    • New sign ups now get a free 14-day trial

    🚀 New Features

    • for journey map creation

    • Lane duplication functionality for faster map building

    • Collapsible : Restyled the journey info panel, as well as the sharing and export mode along with being able to take journey actions like cloning and archiving within the map.

    🔧 Improvements

    • Card color for icon, image and slider cards: Added color support for icon, slider, and image cards, improving customization and clarity in visual design

    • Better pasting into text editor: Clear the formatting when you paste into the text editor to prevent unwanted or unsafe content from being inserted

    • New loading experience in journey map

    • for portfolio, image, slider and icon cards

    Sign up for a free account

    When signing up for Smaply, each user gets their own, forever free account.

    1. Go to Smaply

      Visit smaply.app and enter your email address to begin the registration process

    2. Choose your sign-up method

      You have three options to sign up for an account:

      1. Password: Set a password and use it to log in

      2. Email code: You’ll receive a code via email. Make sure to check your spam/junk folder or whitelist emails from @mail.smaply.app

      3. Google/Microsoft Account: Use your existing Google or Microsoft account to sign up

    You don't have to stick with your current choice. You can change it each time you log in. You only need to use the same email address.

    If you've received an email invitation to join a shared account (e.g., from your company), please follow the instructions in the next chapter .

    Upgrade your plan

    If you are interested in the Repository, Framework or Governance plan, click on one of the purple upgrade-buttons in your dashboard or account settings. You will get redirected to the plan selection page.

    Discounts

    If you need help, get in touch with us via [email protected]. We are happy to send you a tailored offer according to your needs, please also see our discount scheme:

    There are volume discounts available, starting from 20 users on.

    We offer discounts for projects with an educational purpose (schools and universities) NGOs, and public services.

    You can also get a discount if you agree on sharing insights to your project and collaborating on a case study that is relevant to the Smaply community.

    Educational institutions: up to 100% NGOs: up to 50% Public services: up to 20%

    The discounts are applicable to all plans.

    Journey creation with Smaply AI

    Creating journey maps with Smaply AI saves you a lot of time and manual labour, while you're still in control and can adapt at every step of the way.

    When creating a new journey map you now have the option to do so with AI. This feature is available for all paid plans, and in the 14-day free trial.

    Follow the steps below where the creation of a journey map with Smaply AI is described, or watch this video with Marc Stickdorn to see how it works.

    Step by step guide

    1. Go to your dashboard and create a new journey map.

    2. This will lead you to a field where you can enter the general description of the journey map you would like to create. There also are some examples to try out.

    1. In the next step you can refine your journey's name and description. By clicking the blue box in the lower left area of the screen another option for description styles opens up, that lets you change the focus of your journey map.

    1. Customize steps and stages in your journey. You can add, edit and change the order of steps and stages. It's also possible to add content by adding lanes. You have the option to select and deselect steps and stages, descriptions, emotion charts, storyboard images, channels and satisfaction sliders.‍

    Smaply AI understands multiple languages, but by default gives you an English journey map. To get results in your preferred language, for example German, try adding to the journey description prompt "Generate the content in German".

    1. Smaply AI then creates a journey map that you can continue working with.

    Disable AI for your account

    If you'd rather not have this feature available, or your organization doesn't allow the use of AI you can simply disable it for your account.

    Go to your Account settings, navigate to the tab "AI Features" and click the blue switch to disable it for your account.

    Linked portfolio items

    You can now connect your portfolio items – pain points, opportunities, and solutions – to each other to create a meaningful network of insights and actions.

    Why this matters

    Journey management doesn’t stop at identifying a problem. Now you can explicitly connect pain points, solutions and opportunities, helping teams see dependencies and track progress across your portfolio.


    How to link portfolio items

    You can link pain points, opportunities, and solutions to each other – as many as you need. Here's how to do it:

    In the Journey Editor

    • Double click a portfolio item card to open its card sidebar.

    • Click "Add linked items" (or View linked items, if there's already existing ones) to open the Link Tree.

    • Once you opened the Link Tree view, add or edit connected portfolio items, or explore these connections in detail by clicking the plus button, or hovering below any linked item.

    • You'll see the links you created as a pill connected to the card → Hover to see a quick overview

    • You also get to the link tree from the portfolio item edit-modal, including their statuses. In the example below, two opportunities are linked, of which one has the status "done" (green), and the other one is in progress (blue).

    • Switch the card display to Linked items: Change your card to display the links directly instead of the usual portfolio item detail.

    In the Portfolio Overview

    • Link counts in the table: See how many links each item has directly in the table view.


    The Link Tree

    • Open it from any of the above described locations

    • Add pain points, opportunities, or solutions from your workspace

    • See linked items per type, along with a status bar to track progress

    • Easily browse through all connections by clicking on "explore links" upon selecting a linked items.

    This helps you visually navigate and manage complex relationships between challenges and responses.

    Keyboard shortcuts

    These shortcuts help you navigate Smaply efficiently and improve your workflow.

    Shortkey
    Description

    CMD + Z

    Undo

    CMD + Y

    Redo

    +

    Zoom in

    -

    Zoom out

    Keybind
    Description

    Google Analytics

    This article gives a general overview of how to configure the integration, leads you to more detailed articles for Google OAuth or Google Service Accounts and explains how to add a property, dimension

    From the Account settings page, click on the "Integrations" section and then click "Set up" or "Edit" on the "Google Analytics" integration.

    Authenticate with a Service Account or OAuth​

    See detailed instructions:

    Configure properties

    A property in Google Analytics represents a website, mobile application, or device from which you want to collect data. It's a container for the data collected from your online presence.

    Select all properties you want to use with Smaply. Each property will be available to the users that create metrics using the Google Analytics integration. Each property has its own set of dimensions and metrics.

    Configure dimensions

    Dimensions are attributes of your data that are used to filter and group data in Smaply. They are made available to the users that create metrics using the Google Analytics integration.

    Tip: Keep it lean: only add dimensions that you need for your metrics. This will minimize the options a user has to consider, reducing confusion and making metrics easier to manage.

    Configure metrics

    Metrics are the quantitative measurements of user activity on your site or app, such as the number of sessions, page views, or goal completions.

    Save your configuration

    Click on the "Save" button to finalize your settings.

    Congratulations! You have now configured the Google Analytics integration. You can proceed to create metrics with live data from Google Analytics.

    Bulk actions

    Smaply offers bulk actions for journey maps and personas, making it easier to manage multiple items at once. Here's how to use them.

    1

    Select multiple items

    • Hover over the left side of a journey map or persona name in the respective list. A checkbox will appear.

    • Select multiple items by checking the boxes next to their names.

    2

    Access bulk edit menu

    Once you've selected the items, a bulk edit menu will appear at the bottom of the screen with the following options:

    • Bulk add and remove tags: Apply or remove tags to/from multiple journey maps or personas at once.

    • Bulk copy to other workspaces: Copy selected journey maps or personas to other workspaces.

    Setup O365 Excel using Microsoft account (oAuth)

    This guide explains how to set up OAuth authentication for Office 365 Excel integration with Smaply.

    Recommended Approach

    For enterprise use cases, we recommend using a Service Account instead of OAuth. Service Accounts provide more secure and scalable access to Office 365 data. However, if you prefer OAuth or have specific requirements, follow the steps below.

    Prerequisites

    • A Microsoft Office 365 account with access to the required Excel files.

    • Admin approval may be required for some organizations.

    OAuth Authentication Process

    1. Initiate OAuth Flow (Account settings, Integrations).

    • Click the Connect Office 365 Account button in Smaply.

    • You will be redirected to Microsoft's OAuth consent screen.

    2. Grant Permissions

    • Sign in with your Microsoft Office 365 account.

    • Review the permissions requested by Smaply:

      • Read all files that you have access to

      • Sign you in and read your profile

    Troubleshooting

    No Files Available: - confirm that your Microsoft Office 365 account has access to at least one Excel file. Authentication errors:

    • Try clearing your browser cache and cookies, then restart the process.

    • If problems persist, contact your Office 365 administrator to verify account permissions.

    • OAuth tokens have an expiration period. Smaply will handle token refresh automatically, but ensure you don’t revoke the app’s permissions in your Microsoft account to maintain uninterrupted access.

    If you need further assistance, reach out to Smaply support.

    Saved views

    Create a Saved view

    1

    Apply filters and create view

    Use the available filter options to customize your table view and cick on "Create view".

    2

    Name view and choose visibility

    Name the view and decide whether it is for personal use (private) or visible to everyone in the workspace (shared). Note: Only admins can create views for everyone.

    3

    Favorite the view

    Optionally, click the star icon to mark the view as a favorite. Favorited views will appear on the for quick access.

    4

    Save the view

    Click "Save." The new view will now appear in the list of views above the filters.

    Manage Saved Views

    • Edit Views: Click the pen icon next to your saved views to rename, rearrange, delete or favorite them for better organization.

    • Update a View: Select an existing view, make changes (e.g., add/remove filters), and click "Update view" to save the modifications.

    April

    🚀 New Features

    • Self-service accounts: Users can now upgrade from a free trial to a paid plan directly in the app – no need to contact support.

    • Link view for embed cards: We've added a new link view to our , making it easier to display and access external content.

    • Card headers: Cards now support headers, so you can give each card a clear and meaningful title.

    🔧 Improvements

    • You can now see the highest plan you’re part of right in your personal account settings. Transparency FTW.

    • Signing in now takes you to your first account instead of your favorites. A little more intuitive!

    • The pricing page now shows the Free plan if you’re on it — makes it easier to compare and decide if it’s time to level up

    Configuring the Google Analytics integration

    From the Account settings page, click on the "Integrations" section and then click 'Set up' or 'Edit' on the "Google Analytics" integration.

    Authenticate with a Service Account or OAuth

    See detailed instructions:

    Using the O365 Excel integration in a metric

    This guide explains how to use the Excel (Office 365) integration to create a metric in Smaply. After setting up the integration, you can map your Excel spreadsheet data to a metric and visualize it as a chart.

    Step 1: Add a Metric

    1. Navigate to the Metrics section in Smaply.

    Setup service account for O365 Excel

    Setting Up a Microsoft Service Account for Office 365 Integration

    Here are the steps to create a Microsoft service account for use with Office 365 in Smaply.

    Step 1: Register an App in Azure

    1. Go to the and navigate to App Registrations.

    First steps in Smaply

    This is an easy, click-by-click guide giving you orientation and showing you how to get started in Smaply.

    Once you've logged into Smaply, you will land on your personal dashboard and get an overview of all your work.

    Create your first journey map

    Now it’s time to get started! Click on + New journey and create your first journey map in 5 simple steps!

    1

    February

    🚀 New Features

    • : Easily add Miro post-its, Excel tables, images, and more directly into your journey maps.

  • CSV Export improvements: Including score names and values

  • Join by invitation
  • Click Add Metric.

  • Enter a descriptive Name for your metric (e.g., "Employee Salary").

  • Step 2: Select Excel as the Data Source

    1. In the Source dropdown, select Excel (Office 365).

    2. Choose the metric Type (e.g., Series).

    Step 3: Select Your Excel File and Sheet

    1. Click Change to select an Excel file from your connected Office 365 account.

    2. Select the relevant Sheet from the file.

    3. (Optional) Check Make top row headers if your data has labeled columns in the first row.

    Step 4: Map Data Fields

    1. Data Label: Choose the column that represents the category or labels for your metric (e.g., "Full Name").

    2. Data Values: Select the numerical column that you want to use for the chart visualization (e.g., "Annual Salary").

    3. (Optional) Select bottom rows if you want to pull data from the bottom of the sheet instead of the top. For example, selecting 10 rows from a sheet with 1,000 rows will take the last 10 instead of the first 10.

    4. (Optional) Number of rows: Specify how many rows of data should be included (maximum of 50).

    Step 5: Finalize and Save

    1. Review your selections to ensure the correct data mapping.

    2. Click Save to generate the metric.

    3. Your metric will now be visualized based on the selected data.

    Troubleshooting

    • No data appearing? Ensure that the selected Excel sheet contains the correct headers and data.

    • Incorrect values displayed? Verify that numeric data is mapped under Data Values.

    • Can't connect to Excel? Check your Office 365 authentication and permissions.

    Choose your template from 'journey maps' section.
    tag
  • UI text adjustments: Updated "View All" button text in dashboard section and adjusted account list item font size.

  • New & improved invite component: We’ve replaced the old invite user component with a sleek and nice invite component in organizations and workspaces.

  • Priority filter in portfolio: Need to focus on high-priority items? The new priority filter in portfolios helps you do just that.

  • Notification enhancements: You can now see pending invitations at a glance, and Smaply auto-scrolls to selected cards for smoother navigation.

  • Advanced filtering enhancements: UX fixes and improvements for lists

  • Updated tag UI: Improved tag styling in settings

  • Embedded cards for monday.com, Power BI & Tableau
    planning
    embed cards
    Live metric card updates
    AI support
    Journey info panel
    More bulk actions

    Bulk archive: Archive multiple journey maps or personas at once.

    dashboard

    Trello

    Monday.com

    Metric integration FAQs

    Q: When does Smaply refresh metric data?

    A: Smaply checks for updated metric data only when you open the metric section or access a map with a metric. If the data is over 1 hour old, it fetches the latest data. There’s no constant background refresh— updates happen on access to keep metrics current within about an hour.

    Asana

    Jira

    PowerBI

    Left arrow

    Shrink card

    CTRL + D

    Duplicate card

    Spacebar + Arrow up/down/left/right

    View mode / Hand mode

    ESC

    Exit Hand mode

    Backspace, delete

    Delete card

    Right arrow

    Expand card

    Left arrow

    Shrink card

    CMD + D

    Duplicate card

    Spacebar + Arrow up/down/left right

    View mode / Hand mode

    ESC

    Exit Hand mode

    CTRL + Z

    Undo

    CTRL + Y

    Redo

    +, CTRL + "+"

    Zoom in

    -, CTRL + "-"

    Zoom out

    Backspace, delete

    Delete card

    Right arrow

    Expand card

    Azure DevOps

    Planning tools

    Access Permissions on Free Plans:
    • Users on free plans can now assign tags to journey maps, although tag management remains a feature for paid plans only.

    • A user on the free plan can now only be assigned to one journey map per account, maintaining streamlined access and reducing user limitations.

    (Optional) Consent on behalf of your organization

  • Click Accept to grant access to your Office 365 data.

  • Google Account (OAuth)

    Configure Properties​

    A property in Google Analytics represents a website, mobile application, or device from which you want to collect data. It's a container for the data collected from your online presence.

    Select all properties you want to use with Smaply. Each property will be available to the users that create metrics using the Google Analytics integration. Each property has its own set of dimensions and metrics.

    Configure Dimensions​

    Dimensions are attributes of your data that are used to filter and group data in Smaply. They are made available to the users that create metrics using the Google Analytics integration.

    Tip: Keep it lean! Only add dimensions that you need for your metrics. This will minimize the options a user has to consider, reducing confusion and making metrics easier to manage.

    Configure Metrics​

    Metrics are the quantitative measurements of user activity on your site or app, such as the number of sessions, page views, or goal completions.

    Save Your Configuration

    Click on the "Save" button to finalise your settings.

    Congratulations! You have now configured the Google Analytics integration. You can proceed to create metrics with live data from Google Analytics.

    ​
    Service Account

    Click New registration.

  • Set Supported Account Types to:

    • Accounts in this organizational directory only (Single tenant).

  • Step 2: Find Your Registered App

    1. Search for the app you created in Step 1.

    Step 3: Create a Client Secret

    1. Navigate to Certificates & Secrets.

    2. Under Client Secrets, click + New client secret.

    3. Copy and save the generated Client Secret securely. You will need it later.

    Step 4: Set API Permissions

    1. Go to API Permissions > Add a permission.

    2. Choose Microsoft Graph.

    3. Under Application permissions, add Files.Read.All.

    4. Click Grant admin consent for Default Directory.

    Required Information for Smaply Integration

    You will need the following details to configure the integration:

    • (A) Client ID

    • (B) Tenant ID

    • (C) Client Secret

    🚀 Congratulations! You have successfully set up a service account for Office 365.

    Now! Go to Smaply Integration Configuration

    Troubleshooting

    • Ensure you have set up the Client Secret and API Permissions correctly in Azure.

    • Verify that you have granted admin consent for Microsoft Graph permissions.

    Azure Portal

    Add steps

    ‍Start by adding steps to build the core of your journey map.

    2

    Add stages

    Cluster your steps in stages for more structure. You can expand the cards to span multiple columns.

    3

    Add an emotional journey

    Emotion chart / Grid lane: Create an emotion chart to help empathize with your persona. You can move the emoticons by dragging and dropping.

    4

    Create a storyboard

    Images: Add images/screenshots or other artefacts to your journey map. It makes it easier to grasp and empathize, also then you have everything in one central place.

    5

    Add more lanes and columns

    Add more lanes: Hover between lanes to add new lane types such as opportunities, linked journey maps, grids, and many more. Get more details on lanes, columns, and cards.

    Congratulations on your first journey map! ‍🥳

    Getting started is always the hardest part, and you did it! 🎉

    Now, if you want to rename your journey map, add a description and tags, assign who is in charge, and select a Journey Performance Indicator, you can do so by clicking the journey info icon in the top right corner.

    Journey information

    You can find our Helpdesk in the dropdown of your user icon in the top right corner.

    Helpdesk
    Portfolio summary links from journeys: See a summary of portfolio items in the journey info section and jump to a filtered view of the portfolio with one click.

    • Power BI integration and Office 365 Excel integration: Connect your metric cards to external data sources and keep your insights up to date.

    • Embed content into journeys: Add interactive elements to your journey maps with embedded content from Miro, Figma, YouTube, Google Sheets, Docs, Slides, Mural, and Microsoft Office files.

    🔧 Improvements

    • New persona card types: Expand your persona documentation with additional card options.

    • Advanced filtering for dashboard lists: Use AND and OR operators for multi-selection filters to refine your searches.

    • Metrics: duplicate and bulk delete: Duplicate metrics or remove multiple metrics at once.

    • Bulk edit for coordinator and Journey Performance Indicator: Save time by editing multiple journey maps at once, including coordinators and performance indicators.

    Paste content from anywhere into journey maps
    Icon card
    Grid lane: Single icons as channels / teams / ...
    Grid lane: Processes made of spanned text cards
    Emotion chart
    Service Account
    Google Account (OAuth)
    ​
    ​
    ​
    ​
    embed card

    Cards

    All your journey content is organized in cards. Get an overview of all card types and learn about their functionalities and use cases.

    Card type overview

    All lanes and cards are of a specific type, such as text lanes, stage lanes, and more. You might not see all options, depending on what plan you're on. Read more about certain card types further down.

    Cards added to a lane will automatically have the same type as the lane. But the great thing is:

    Card detail panel

    For some card types like text or stage cards, you can simply click into the card and start typing. To keep it simple, we only added the main actions into the card toolbar.

    In the card detail panel, you can add more detail to your cards. Depending on the card type there are different editing options. These options are the same for all card types:

    • Add personas

    • Add tags

    • Add comments

    Double-click on a card to open the details panel.

    Card headers

    You can add headers to your cards, giving you more flexibility in organizing and labeling your content. You can also add icons to it for identification at a glance.

    Card type: Icon

    Icon cards come with several templates to get you started. Use the icon template "Channels" to quickly create a set of channels that you can duplicate throughout your lane. Upon clicking on an icon, you can turn the channel on or off.

    Card type: Link Journey Map

    Smaply allows you to connect your journey maps using Link Journey Map cards. This helps you build hierarchies or networks of journeys, making it easier to manage and navigate complex experiences across different levels.

    What is a Link Journey Map card?

    The Link Journey Map card lets you link another journey map from the same, or from another workspace directly into the card.

    Once linked, the card will display:

    • The title of the journey

    • Its description

    • The performance indicator (if set)

    • The assigned coordinator

    How to use it

    You can use Link Journey Map cards to:

    • Create high-level, end-to-end journeys that reference more detailed sub-journeys

    • Zoom into specific steps by linking a lower-level journey

    • Build a network of journeys to better reflect complex service structures

    This setup enables you to structure your journey maps more strategically — from broad overviews to detailed processes.

    Example use case

    Imagine you’re mapping an entire customer lifecycle. You can:

    • Build a high-level journey to visualize the full end-to-end experience

    • Link detailed journeys, like onboarding, support, or renewal, into individual steps

    • Allow different teams to manage sub-journeys, while keeping them connected at the top level

    Want to learn more about journey hierarchies and how to manage them? Check out our blog article on

    Card type: Portfolio cards

    Link your opportunities, pain points and solutions to portfolio cards. Learn more about the functionality in this chapter: .

    Emotion chart

    Creating Google Service Account

    This article goes into the details of how to set up a Google Analytics service account in Smaply and offers step-by-step instructions to do so.

    A service account acts as a virtual user for your application, allowing secure, programmatic access to Google Analytics data without using personal credentials.

    Steps to create and configure service account​

    1. Create a Google Cloud project (if not already done)

    1. Go to the Google Cloud Console:

    2. Click on "Select a project" > "New Project"

    3. Enter a project name and click "Create"

    4. Give it a sensible name like "Smaply-GA"

    Tip: Creating a dedicated Google Cloud Project for Smaply allows you to keep all related API access and settings in one place. This makes it easier to manage permissions and track usage specific to your Smaply integration.

    2. Enable the Google Analytics data API

    1. In your Google Cloud project, go to "APIs & Services" > "Library"

    2. Search for "Google Analytics Data API"

    3. Click on the API and then click "Enable"

    4. Do the same for the Google Analytics Admin API

    Important: Enabling the API is crucial for accessing GA4 data. Make sure you've completed this step before proceeding.

    3. Create a service account

    1. In the , navigate to "IAM & Admin" > "Service Accounts"

    2. Click "Create Service Account"

    3. Enter a name and description for your service account

    4. Click "Create and Continue"

    4. Grant permissions

    1. In the "Service account permissions" section, add the following role:

      • "Viewer" (for read-only access) or "Editor" (for read-write access)

    2. Click "Continue" and then "Done"

    Security Tip: Always follow the principle of least privilege. Grant only the permissions necessary for your intended use case.

    5. Create and download the key file

    1. Find your newly created service account in the list

    2. Click on the service account name

    3. Go to the "Keys" tab

    4. Click "Add Key" > "Create new key"

    6. Grant access in Google Analytics

    1. Navigate to Admin > Property > Property Access Management

    2. Click the "+" button to add a new user

    3. Enter the service account email address (found in the key file or service account details)

    Tip: If you need access to multiple GA4 properties, you can repeat this step for each property or use Google Analytics account-level access for broader permissions.

    Troubleshooting

    If you encounter issues during the OAuth process or property verification:

    1. No properties available: Ensure your Google account has access to at least one Google Analytics property

    2. Insufficient permissions: Check your access level in Google Analytics. You need at least "Read & Analyze" permissions for the properties you want to integrate

    Account Library

    Using the Account Library to manage content across workspaces

    The Account Library helps your team manage and reuse key content – journey maps, templates personas, opportunities, pain points, solutions, and metrics – across all workspaces within your account. Changes to Account Library content are reflected for all users.


    📚 What is the Account Library?

    The Account Library is a centralized space where you can:

    ☑️ Create and manage reusable content.

    ☑️ Ensure consistency across teams and workspaces of your account.

    ☑️ Save time by avoiding duplicated work.

    How Account Library content works

    The Account Library becomes available as soon as an account has more than one workspace. When content (e.g. an opportunity or persona) is added to the Account Library:

    • It becomes available across all workspaces.

    • Changes made to it are reflected wherever it’s used

    • A banner appears to indicate you're editing an Account Library item.

    Example: If a pain point is updated in one journey map, that change will appear in all maps where it’s used in the whole account.


    📥 What you can add to the Account Library

    • Journey maps

    • Personas

    • Portfolio items (opportunities, pain points, solutions)

    • Metrics

    Adding content to the Account Library

    You can promote existing content to the Account Library:

    • Use the Add to account library option from the context menu.

    • Or use the bulk action toolbar to add multiple items at once.

    All admins or editors of a workspace can do this.

    You can access your library icons both from the account library page in your dashboard, but also from your workspaces. You'll recognize them by the globe icon:


    📤 Removing content from the Account Library

    To demote content (move it back to a specific workspace):

    • Use Move to workspace in the item menu or bulk actions.

    • You'll get a warning if doing so would remove it from other journey maps.

    Only account admins can do this.

    Example: Removing a pain point from the Account Library removes it from any journey maps in other workspaces.


    Moving Journey maps

    When you move a journey map to the Account Library:

    Moving Portfolio items

    When you move a portfolio item, e.g. a pain point to the Account Library:

    -> linked portfolio items will not move along to the library, and stay in the origin workspace.


    ✅ Why use the Account Library?

    • Keep teams aligned with consistent content.

    • Avoid duplicate work.

    • Make updates once and reflect them everywhere.

    Comparison metrics

    Comparison metrics allow you to compare two or more data points against each other. This type is perfect for side-by-side evaluations, such as comparing revenues from different months or contrasting user engagement between various features or campaigns.

    Comparison: Displays a number with a percentage change below, ideal for showing improvements or declines over a period.

    Bar Comparison: Uses bars to compare different data points visually, making it easy to see which data point performs better.

    Number metrics

    Number metrics represent a single, standalone data value. This type is ideal for key figures or summary statistics that need to be highlighted, such as total number of users, one-time sales figures, or overall engagement rates.

    Number: Shows a single value prominently, ideal for displaying essential figures like total users or one-time sales.

    Gauge: A semi-circular gauge that shows the value relative to a target value, perfect for giving a quick visual of performance against goals.

    Opportunities, pain points, solutions

    Here you'll find information on how to create and edit portfolio cards.

    What is the portfolio?

    In the Portfolio section of your dashboard, you’ll find opportunities, pain points, and solutions – three types of cards designed to capture and organize key insights from your journey maps.

    Create a number metric

    Simply include a number to your journey, to show the most up to date information.

    Get going

    1. Create a new metric either from the journey map or from the metrics page

    2. Select source as "Google Analytics"

    Configure Trello with an api key

    Video overview

    Steps to authorize Trello with a token

    Configuring Linear with Personal API key

    Video overview

    Steps to set up your Personal Access Token (PAT)

    Configuring Asana using a Personal access token

    Video overview

    Steps to set up your Personal Access Token (PAT)

    Setup verification tool

    We provide a Python script that automatically checks your Power BI configuration and permissions.

    Prerequisites

    • Python 3.6 or higher installed

    Configuring the PowerBi Integration

    From the Account settings page, click on the "Integrations" section and then click 'Set up' or 'Edit' on the "Office 365 Excel" integration.

    See detailed instructions:

    Configuring Azure Devops with a personal token

    Video overview

    Steps to Set Up a Personal Access Token (PAT) in Azure DevOps:

    1. Log in to your Azure DevOps account.

    Set up PowerBi using Microsoft account (OAuth)

    This guide explains how to set up OAuth authentication for Power BI integration with Smaply.

    Recommended Approach

    For enterprise use cases, we recommend using a Service Account instead of OAuth. Service Accounts provide more secure and scalable access to Power BI data. However, if you prefer OAuth or have specific requirements, follow the steps below.

    Configuring JIRA with an api key

    Configuring Jira with an api key

    Video overview

    Steps to Set Up a Jira API Token:

    1. Log in to .

    Service Account
    Microsoft Account (OAuth)
    Templates

    All linked items (e.g. metrics, personas) will move along and also become available account-wide.

    When you move a journey map out of the Account Library:

    • Linked items stay in the library, unless you choose to move them also.

    Steps and stages
    Emotion chart
    Storyboard
    Add lanes

    Linear

    Download Python for Windows
  • Mac: brew install python3

  • Linux: sudo apt-get install python3

  • Running the setup verification tool

    1. Download and unzip powerbi_troubleshooting.zip

    2. Follow the instructions in the test_scripts/README

    3. Read the script output carefully!

    Manual Verification Steps

    1. Azure Portal Checks

      • App Registration exists

      • Required permissions granted

      • Admin consent provided

    2. Power BI Service Checks

      • Security group added to workspace

      • Service principal enabled

      • Dataset refreshed recently

    3. Integration Checks

      • Correct workspace name

      • Exact table name match

      • Security group name matches exactly

    Need More Help?

    Contact support with test script output. Please contact [email protected] and we'll try and get you up and running as fast as we can.

    13KB
    powerbi_troubleshooting.zip
    archive
    Open
    Troubleshooting python script

    Cards of any type can be placed into lanes of any type.‍

    Choose "JSON" as the key type
  • Click "Create" to download the key file

  • Assign the appropriate role (e.g., Viewer or Editor)

  • Click "Add" to save the changes

  • ​
    ​
    ​
    Google Cloud Console
    ​
    ​
    ​
    Log in to your Google Analytics account
    ​
    Opportunities: Highlight potential improvements or areas for growth within the journey.
  • Pain points: Identify specific obstacles or frustrations encountered by users.

  • Solutions: Outline proposed ideas or actions aimed at addressing the identified pain points.

  • Each card type helps teams prioritize and track actionable insights across journeys

    You can customize the names and statuses of your portfolio items in your account settings.

    How to add Opportunities, pain points, and solutions to your journey maps?

    1. First, you add the dedicated lane of which portfolio card you'd like to add, or simply add a portfolio card – depending on your needs.

    The portfolio lanes and cards are sorted into three different types: opportunities, pain points, and solutions. Choose the one that fits your purpose, they all work the same.

    1. When you add a portfolio card to your journey, you will get a modal that shows the items already created. You can choose one of those, or create a new one.

    Example: How to create a pain point

    In this example we create a new pain point.

    1. Name the pain point

    2. Describe it in detail -> This pain point will be reusable in all the maps of your workspace, so it's important to describe it in detail.

    3. Define parameters that are decisive for the position and size of the dot in the Portfolio matrix -> Here the parameters are called Impact, Reach, and Cost; they can be customized though by the admin of the shared workspace.

    4. Add a priority, a status, and an assignee.

    5. Add tags for easier management of your pain points in the portfolio matrix.

    The changes you make will affect all cards in journey maps of this workspace, where this portfolio data is linked.

    In this modal, you can also see in how many and which maps your pain point has been used.

    Clicking on a portfolio item card in your journey opens the card detail sidebar as below. Please note that all info in the gray box is referring directly to the pain point (and will affect all cards in journey maps of this workspace, where this portfolio data is linked).

    All white sections in this sidebar refer to the card, such as the persona assigned and tags, or the comments added to this card.

    Display options

    Choose from different options of how you want to display your portfolio item in a journey map: Full or shorened description, compact or custom view, or Linked portfolio items

    Portfolio summary in the journey map info section

    The journey information displays a summary of all added items. Click on an item to open the portfolio page, pre-filtered to show the relevant entries from the current map:

    Select type as "Number"

    Select date range​

    Select a date range for the number

    Select the metric​

    Select the metric you want to sum over the selected date range.

    select_metric

    If you don't see the metric you want to compare, your administrator can add it for you. See Google Analytics configuration for more information.

    Preview and save​

    preview_number

    (Optional) Apply filters​

    apply_filters

    Preview and save​

    preview_comparison

    If you don't see any data, check that the comparison period actually has data and that you don't have any filters that are returning no results.

    ​

    In Smaply, open the Trello configuration page. From your Account settings (a) > Integrations (b) > Trello Setup (c)

  • In the "How to setup the Trello integration" box, click on the link to open the authorization page

  • Authorize the smaply connector app

  • Copy the generated token and paste it into the field in the Smaply configuration

    1. Save the configuration and the connection success message should be shown

    In Smaply, Open the Linear configuration page. From your Account settings (a) > Integrations (b) > Linear Setup (c)

    1. Now, make sure you're logged into your Linear account at https://linear.app/

    2. Generate a Personal API key

      1. Go to the Linear security and access settings page at linear.app/settings/account/security

      2. Under Personal API keys, select 'Create a new API key' and give it a clear name, we suggest 'smaply-connector'

      3. Copy the generated token into the configuration screen in Smaply

    3. Save the configuration and the connection success message should be shown

    In Smaply, Open the Asana configuration page. From your Account settings (a) > Integrations (b) > Asana Setup (c)

    1. Now, make sure you're logged into your Asana account at app.asana.com

    2. To find your workspace ID open link app.asana.com/api/1.0/workspaces and copy the workspace gid from the result. Paste it into the Workspace ID field.

    3. Generate a Personal access token

      Generating a personal access token
      1. Open and under Personal access tokens select "Create new token"

      2. In the "Create new token" dialog, give it a clear name, we suggest 'smaply-connector' and click "Create token"

      3. Copy the generated token into the configuration screen in Smaply

    4. Save the configuration and the connection success message should be shown

    Learn more about Personal access tokens at https://developers.asana.com/docs/personal-access-token

    In the top-right corner, click on User Settings (to the left of your profile avatar)

  • Under the Personal Access Tokens section, click + New Token.

  • In the Create a new personal access token screen:

    • Enter a name for the token (e.g., "smaply-connector").

    • Set the scores to read/write and manage work items

  • Click Create and copy the generated Personal Access Token (you won’t be able to view it again).

  • Enter the Following Details in the Configuration:

    • organization: xxxxx (Replace with your Azure DevOps organization name)

    • project: XXX (Replace with your Azure DevOps project name)

    • personalAccessToken: XXX (Replace with your copied PAT)

    Prerequisites
    • A Microsoft Power BI account with access to the required workspaces and datasets.

    • Admin approval may be required for some organizations.

    OAuth Authentication Process

    1. Initiate OAuth Flow

    • Click the Connect Power BI Account button in Smaply (Account settings, Integrations).

    • You will be redirected to Microsoft's OAuth consent screen.

    2. Grant Permissions

    • Sign in with your Microsoft Power BI account.

    • Review the permissions requested by Smaply:

      • Read all datasets and reports that you have access to

      • Sign you in and read your profile

      • (Optional) Consent on behalf of your organization

    • Click Accept to grant access to your Power BI data.

    Troubleshooting

    No Workspaces Available

    • Confirm that your Microsoft Power BI account has access to at least one workspace containing datasets.

    Authentication Errors

    • Try clearing your browser cache and cookies, then restart the process.

    • If problems persist, contact your Power BI administrator to verify account permissions.

    • OAuth tokens have an expiration period. Smaply will handle token refresh automatically, but ensure you don’t revoke the app’s permissions in your Microsoft account to maintain uninterrupted access.

    If you need further assistance, reach out to Smaply support.

    Click Create API token.
  • From the dialog that appears, enter a memorable and concise Label for your token and click Create.

  • Click Copy to clipboard, then paste the token to your script, or elsewhere to save:

  • Copy the generated token (you won’t be able to view it again).

  • Enter the Following Details in the Configuration:

    • apiToken: XXXXXX (Replace with your copied API token)

    • baseUrl: https://xxxx.atlassian.net (Your atlassian cloud instance)

    • email: [email protected] (Your user account email)

    https://id.atlassian.com/manage-profile/security/api-tokens
    journey management using hierarchies.
    Opportunities, pain points, solutions

    Cards of any type can be placed into lanes of any type.‍

    Create a comparison metric

    Compare metrics and see how they developed over time.

    Get going​

    1. Create a new metric either from the journey map or from the metrics page

    2. Select source as "Google Analytics"

    3. Select type as "Comparison"

    Select date range

    Select a date range for the comparison. The previous period is calculated relative to the selected date range.

    Select the metric

    Select the metric you want to compare over the selected date ranges.

    If you don't see the metric you want to compare, your administrator can add it for you. See for more information.

    (Optional) Apply filters

    Preview and save

    If you don't see any data, check that the comparison period actually has data and that you don't have any filters that are returning no results.

    Getting up and running with PowerBI

    These guides should help you get up and running with Smaply. Also see: Configuring the PowerBi Integration Using the Power BI integration in a Metric

    Key Permission Checklist This video provides a walkthrough of the required API permissions to integrate Power BI using Microsoft Entra.

    You'll learn which permissions are necessary and how to configure them.

    Connecting Power BI Tables with Smaply Metrics This video provides a walkthrough of your first steps with PowerBI and Smaply. Giving Smaply access to your PowerBI workspaces and writing your first query.

    Configuring Monday.com

    Add your API key to connect your Monday.com account to Smaply.

    How to setup the Monday.com integration

    1. In Smaply, Open the Monday.com configuration page. From your Account settings > Integrations > Monday.com

    1. Make sure you're logged in to your monday.com account.

    2. Go to https://YOUR TEAM.monday.com/apps/manage/tokens to view your personal API token.

    1. Click "Show" to reveal the token, then copy and paste it in the field below:

    Alternative for Account Admins: You can also access your token by clicking your profile picture, then going to Administration > Connections > Personal API token.

    Series metrics

    ​Series metrics involve a sequence of data points collected over a period or categorically. This type allows for detailed analysis and visualization of trends, changes, and progressions in your data. For example, tracking monthly visitors over a year.

    Metrics: Bar chart

    Bar chart: Visualizes data points as vertical bars, useful for comparing categories.

    Metrics: Horizontal bar

    Horizontal bar: Similar to the bar chart but with horizontal bars, ideal for long category names.

    Metrics: Pie chart

    Pie chart: Displays data as slices of a pie, showing relative proportions.

    Metrics: Line chart

    Line chart: Plots data points on a line, best for showing trends over time.

    Table: Lists data points systematically, suitable for detailed viewing.

    Setting up metrics

    Adding KPIs to your customer journeys makes deriving actionable insights much clearer and easier.

    Two ways to create a new metric

    1. From a journey map: Add a new metric directly within your journey map with the metric card.

    1. From the metrics page: Create a new metric from the metrics page on your workspace dashboard.

    In both cases, the metric will be available across your entire account. Any changes made to the metric (e.g. adding or editing values) will be reflected in all its instances throughout all workspaces in the account.

    1. Enter details for your metric

    • Add a title

    • Select the data source: For now, we offer manual data entries including CSV uploads

    • Choose a type:some text

      • Series: Track values over time, such as monthly sign-ups or user growth

    1. Preview and set default display settings

    • View a preview of how the metric will look on a card in your journey map.

    • These default settings will apply to all cards of this metric but can be customized per card on the journey map. There you can adjust the heading, subheading, or chart type as needed.

    1. Save and add to your journey map

    • Save your metric and then add it to your journey map by selecting it from the dropdown menu in the metric card.

    Availability:

    This feature is available for all plans, but limited to 3 metrics per map on the free plan. Enterprise plans can set up an unlimited amount of metrics.

    Types of metrics

    The many different metrics in companies are best presented in different ways.

    You can choose between 3 types of metrics, each of which have several display options.

    Visualization Tip: Choose the right chart type to make your data easy to understand at a glance. Consider your audience and the story you want your data to tell.

    Learn how to create a manual metric in Smaply.

    Dashboard

    Here you find more info about all the sections in your dashboard navigation

    Once you've logged into Smaply, you will land on the dashboard of your personal account and get an overview of your work from all accounts you are a member of.

    The colored squares on the left represent the accounts you are part of. You might only have a Personal account , (it's always the topmost), but if you are part of several accounts, you can easily switch between them.

    Easily create new journey maps, personas or metrics from your dashboard, or revisit your recently opened journey maps or the ones you've highlighted as your favorites.

    The dashboard is also the place where you find journey maps that have been shared with you from workspaces or accounts you’re not a part of.

    Marc the tailored views of your journey map lists as favorites and access them directly from the dashboard.

    In the Learn section, you find helpful articles about different Smaply topics.

    The navigation

    • All your journey maps are located in the Journey maps tab. Learn more about the .

    • Under Personas, you can create and manage your personas. Read more about .

    • In your Portfolio, you can see the pain points, opportunities, and solutions from your all journey maps. Learn how to manage your .

    Using the Power BI integration in a Metric

    This guide explains how to map fields in the Smaply form to Power BI datasets and display the data as a chart.

    Steps to Add a Power BI Metric

    1. Open the Add Metric Form

    Introduction to metrics

    Metrics are powerful tools that bring key data from your organization into your journey maps, enabling data-driven decision making, insight discovery, and opportunity spotting.

    What are metrics in journey mapping?

    Metrics in journey mapping are quantitative measurements that provide concrete data points to support and enhance your customer journey analysis. They help you:

    • Validate assumptions about customer behavior

    Create a series metric

    Get going

    1. Create a new metric either from the journey map or from the metrics page

    2. Select source as "Google Analytics"

    Series metrics 📶

    Data trends or comparisons, visualized as pie, bar, horizontal bar, line charts, or tables

    Number metrics 🔢

    Single values with optional targets, shown as gauges or simple numbers

    Comparison metrics 🔁

    Compare two numbers, highlighting improvements or decrements

  • Identify pain points and areas for improvement

  • Measure the impact of changes to your customer experience

  • Prioritize initiatives based on data-driven insights

  • Tip: Incorporating metrics into your journey maps transforms them from static visualizations into dynamic, actionable tools for continuous improvement.

    Learn how to set up metrics in Smaply.

    Data Sources for Metrics​

    Smaply supports various data sources to populate your metrics:

    1. Manual entry: Ideal for quick updates or one-off data points

    2. Excel or CSV paste/import: Perfect for bulk data or periodic updates

    3. Live data integrations: Connect directly to analytics and other data tools for real-time insights

    Getting started with metrics​

    1. Identify key performance indicators (KPIs) relevant to your customer journey

    2. Set up integrations or prepare your data for import

    3. Add metric lanes to your journey map

    4. Configure your metrics with appropriate visualizations and targets

    Best Practice: Start with manual metrics and quickly get the visualization you want. Then transition to live data sources.

    ​
    Metrics cards
    Find all the Metrics you created in your workspace. To learn more about metrics, head over to the Introduction to Metrics.
  • Create Templates of journey maps for your team to get started, or copy your journey map as a Template.

  • Journey map editor
    Personas
    Portfolio

    Number: Specify targets or milestones, like sales targets or goal completions

  • Comparison: Compare two values, such as this month’s performance versus last month’s, or projected versus actual results.

  • Navigate to the Metrics section in Smaply.

  • Click Add Metric to open the form.

  • Fill in the Form Fields

    • Name: Choose a meaningful name for your metric (e.g., Employee count by city).

    • Source: Select Power BI.

    • Type: Right now we support series charts

    • Workspace: Select the appropriate Power BI workspace where your dataset is located.

    • Dataset: Choose the dataset that contains the relevant data.

    • Table: Enter the table name from Power BI and click Enter to load the available fields.

    • Data Label: Select the column that represents the categories (e.g., City).

    • Data Value: Select the column that represents the values to measure (e.g., Value).

  • Save and Display the Metric

    • Click Save to store the metric.

    • The metric will now be visualized as a chart in your dashboard.

  • Understanding Field Mapping Between Smaply and Power BI

    Smaply Field
    Power BI Equivalent

    Workspace

    Power BI Workspace

    Dataset

    Power BI Dataset

    Table

    Table in Power BI Dataset

    Data Label

    Column representing categories (e.g., City)

    Data Value

    Column representing numerical values (e.g., Employee Count)

    Troubleshooting

    • If no datasets or tables appear, ensure that the selected Power BI workspace contains the required data.

    • Check permissions in Power BI to verify that the service account has access to the selected dataset.

    • If the metric does not display correctly, confirm that the Data Label and Data Value fields are mapped correctly to Power BI columns.

    By following these steps, you can seamlessly integrate Power BI data into Smaply metrics and visualize key insights effortlessly.

    Select type as "Number"

    Select date range​

    Select a date range for the series

    Select the metric​

    Select the metric you want to compare over the selected date ranges.

    select_metric

    If you don't see the metric you want to compare, your administrator can add it for you. See Google Analytics configuration for more information.

    Select the dimension (Group by)​

    Select the dimension you want to group by over the selected date ranges.

    dimension

    If you don't see the dimension you want to compare, your administer can add it for you. See Google Analytics configuration for more information.

    (Optional) Apply filters​

    apply_filters

    Preview and save​

    If you don't see any data, check that the comparison period actually has data and that you don't have any filters that are returning no results.

    ​
    app.asana.com/0/my-apps
    ​
    ​
    Google Analytics configuration
    ​
    ​
    Date range
    Select metric
    Apply filters
    Preview comparison
    Metrics: Table

    Set up Service Account for PowerBI

    Setting up a Service Account for Power BI in Azure Entra requires multiple steps, including creating an app, assigning permissions, and configuring access. Follow this guide to complete the setup.


    Step 1: Register an App in Azure Entra

    1. Go to the Azure Portal. Navigate to Azure Entra ID

    2. Click "+ Add" > "App registration"

    3. Enter app registration details. name: Smaply Power Bi. connector Supported account type: Accounts in this organizational directory only (Single tenant no need to set a redirect URI And click "Register"

    Step 2: Assign API Permissions

    1. Within your app, navigate to Manage > API Permissions > Add a permission.

    2. Choose Power BI Service.

    3. Under Application permissions, add:

    Step 3: Create a Client Secret

    1. Within your app, navigate to Certificates & Secrets.

    2. Under Client Secrets, click + New client secret. description: Power Bi Smaply connector client secret expiry: [e.g. 12 months]

    3. Copy the generated Client Secret value, you will need it later.

    Step 4: Create a Security Group & Assign the Service Principal

    1. Navigate to .

    2. Create a new security group ("New Group"). type: Security name: smaply-powerbi description: Smaply PowerBI Connector security group members: assign the Service Principal (Application). E.g. "Smaply Power BI Connector" from step 1

    Step 5: Configure Power BI Admin Settings

    1. Go to the .

    2. Open Service Principal can use Fabric APIs (under tenant settings)

    3. Enable Service Principal access. Apply to: Specific security groups: type in the security group name from step4; e.g. smaply-powerbi Apply

    Step 6: Assign Access to PowerBI workspace

    In Power BI, do the following for all of the Workspace that Smaply should have access to:

    1. Assign the Security Group (created in Step 4) to a workspace. Note: your personal workspaces won't support this.

    2. Make sure you have given the service account member access to the workspace.

    3. Wait 30 to 60 minutes for the changes to propagate.

    Step 7: Configure Power BI in Smaply

    Once all configurations are in place, set up the integration in Smaply using from the service principal (Entra app). You'll need:

    • Tenant ID

    • Client ID

    • Client Secret (from step3)

    • In Smaply Account settings > Integrations > Power BI, add the details

    Now you're ready to create your first metric with Power BI 🚀.

    Deleting journey maps

    How to delete journey maps, templates and personas

    To help you avoid accidental loss of data, journey maps and templates cannot be deleted right away. You’ll need to archive a map first before you can permanently delete it. Personas can be archived or deleted right away.

    Step 1: Archive the map

    1. In your dashboard, go to the journey map you want to delete.

    2. Click the three-dot menu (•••) next to the map name or tick the checkboxes for bulk actions.

    3. Select “Archive” → The map will be moved to your archive

    Step 2: Permanently delete from the archive

    1. Go to the archive section in your workspace.

    2. Find the map you want to delete or select several maps via the checkboxes.

    3. Click “Delete” → This action cannot be undone.

    Free Plan Limits

    You can create up to 10 journey maps on the free plan. Archived maps still count toward this limit.

    To free up space, delete maps from your archive.

    Tip: Not sure yet? Keep maps in the archive for now — they’re safe and out of the way, but still restorable.

    Service account troubleshooting

    If you're experiencing issues with your Google Analytics service account access, this guide will help you diagnose and resolve common problems.

    If you're experiencing issues with your Google Analytics service account access, this guide will help you diagnose and resolve common problems.

    Test you can access properties

    Google has provided a tool to test your service account can access properties and their fields. It uses oauth rather than the service account, but will test if the properties are valid.

    Embedding external content

    Embedding Content in Your Journey Map

    Smaply now supports embedding content from other apps directly into your journey maps! This allows you to enhance your maps with interactive designs, videos, documents, and more.

    Supported Embeds

    Running the diagnostic script​

    Here is a Node.js script to help diagnose issues with your service account. Here's how to use it:

    1. Ensure you have Node.js installed on your system.

    2. Save the following script as test_ga_sa.js:

    ‍

    const { google } = require("googleapis"); const fs = require("fs"); const keyFilePath = process.argv[2]; const serviceAccountKey = JSON.parse(fs.readFileSync(keyFilePath, "utf8")); async function listGAAccountsAndProperties() { const auth = new google.auth.GoogleAuth({ credentials: serviceAccountKey, scopes: ["https://www.googleapis.com/auth/analytics.readonly"], }); const analyticsAdmin = google.analyticsadmin({ version: "v1beta", auth }); try { console.log("Attempting to list accounts..."); const accountSummariesResponse = await analyticsAdmin.accountSummaries.list(); const accountSummaries = accountSummariesResponse.data.accountSummaries || []; console.log( `Accounts found - data.accountSummaries: ${accountSummaries.length}` ); console.log( `Details: ${JSON.stringify( accountSummaries, null, 2 )}` ); console.log(`\n\n----------------------------------------\n\n`); for (const account of accountSummaries) { console.log(`\nAccount: ${account.displayName} (${account.name})`); const accountId = account.name.split("/")[1]; console.log(`Listing properties for account ${accountId}...\n\n`); const propertiesResponse = await analyticsAdmin.properties.list({ filter: `parent:accounts/${accountId}`, pageSize: 200, }); const properties = propertiesResponse.data.properties || []; console.log(`Properties found: ${properties.length}`); properties.forEach((property, index) => { console.log(JSON.stringify(property, null, 2)); }); } } catch (error) { console.error("Error encountered:"); if (error.response) { console.error(" Status:", error.response.status); console.error(" Data:", JSON.stringify(error.response.data, null, 2)); } else { console.error(" Message:", error.message); } console.log("\nPossible reasons for errors:"); console.log( "1. The service account does not have access to any Google Analytics accounts or properties." ); console.log( "2. There might be an issue with the service account permissions." ); console.log( "3. The Analytics Admin API might not be enabled for this project." ); } } listGAAccountsAndProperties();‍

    1. Install the required dependencies:npm install googleapis fs

    2. Run the script, providing the path to your service account key file:node test_ga_sa.js /path/to/your/service-account-key.json

    3. Analyze the output for any errors or issues

    Test access to individual property​

    1. Save the following script as test_ga_property.js:

    ‍

    const { google } = require('googleapis'); const fs = require('fs'); const keyFilePath = process.argv[2]; const propertyId = process.argv[3]; if (!keyFilePath || !propertyId) { console.error('Usage: node test_ga_property.js <path_to_service_account_key.json> <propertyId>'); process.exit(1); } const serviceAccountKey = JSON.parse(fs.readFileSync(keyFilePath, 'utf8')); async function runDiagnostics() { const auth = new google.auth.GoogleAuth({ credentials: serviceAccountKey, scopes: ['https://www.googleapis.com/auth/analytics.readonly'] }); const analyticsData = google.analyticsdata({ version: 'v1beta', auth }); try { console.log(`Running diagnostics for property: ${propertyId}`); console.log('\nFetching available metrics...'); const metadata = await analyticsData.properties.getMetadata({ name: `properties/${propertyId}/metadata` }); console.log('Available metrics:'); metadata.data.metrics.forEach(metric => { console.log(`- ${metric.apiName}`); }); console.log('\nAttempting to run a simple report...'); const report = await analyticsData.properties.runReport({ property: `properties/${propertyId}`, resource: { dateRanges: [{ startDate: '30daysAgo', endDate: 'today' }], metrics: [{ name: 'activeUsers' }] } }); console.log('Report run successfully. Sample data:'); console.log(report.data.rows[0].metricValues[0].value); } catch (error) { console.error('Error encountered:', error.message); if (error.response) { console.error('Status:', error.response.status); console.error('Data:', JSON.stringify(error.response.data, null, 2)); } console.log('\nPossible reasons for errors:'); console.log('1. The service account does not have access to this property.'); console.log('2. The property ID is incorrect or doesn\'t exist.'); console.log('3. The Google Analytics Data API is not enabled for this project.'); console.log('4. There might be an issue with the service account permissions.'); } } runDiagnostics();

    1. Run the script, providing the path to your service account key file: node test_ga_property.js /path/to/your/service-account-key.json

    2. Analyze the output for any errors or issues.

    Manual Checks​

    Verify service account permissions in Google Analytics​

    1. Go to Google Analytics

    2. Navigate to Admin > Property > Property Access Management

    3. Ensure your service account email is listed with the correct permissions

    Check Google Cloud project configuration​

    1. Visit the Google Cloud Console

    2. Ensure the Google Analytics Data API is enabled for your project

    3. Verify that your service account exists and has the necessary roles

    Common issues and solutions​

    1. No properties found: Ensure the service account has been added to the correct Google Analytics property with the right permissions.

    2. API not enabled: Make sure the Google Analytics Data API is enabled in your Google Cloud project.

    3. Invalid scope: Verify that the correct API scope is being used (https://www.googleapis.com/auth/analytics.readonly for read-only access).

    4. Organizational policy restrictions: Work with your organization's admin to review and potentially modify restrictive policies.

    Additional resources​

    • Google Analytics Data API Documentation

    • Google Cloud IAM Troubleshooter

    • Understanding Service Accounts

    • Google Cloud Organization Policy Documentation

    If you continue to experience issues after following these troubleshooting steps, please contact your organization's Google Cloud administrator or Google Cloud support for further assistance.

    ‍

    ​
    https://ga-dev-tools.google/ga4/dimensions-metrics-explorer/
    :rakete:
    Tenant.Read.All
  • Click Grant admin consent for {Your Tenant Name}.

  • Once validated, you will be able to select any workspace that you set up in step6

    Azure Groups Management
    Power BI Admin Portal
    Learn how.
    You can embed content from:
    • Figma

    • YouTube

    • Miro

    • Mural

    • Google Sheets, Docs, Slides

    • Sharepoint Excel, Word & PowerPoint

    • Onedrive Excel, Word & PowerPoint

    • Monday.com

    • PowerBI

    • Tableau

    How to Embed Content

    Embedding a Figma Design

    1. In Figma, select the frame you want to embed.

    2. Right-click the frame and go to Copy/Paste As → Copy Link.

    3. In Smaply, open your journey map and click Add Card → Embed.

    4. Paste the Figma link, and the selected frame will be embedded as a card.

    You can choose whether you want to display your Figma design as rich media or as link only in the editor sidebar.

    Embedding a YouTube Video

    1. Copy the URL of the YouTube video you want to embed.

    2. In Smaply, open your journey map and click Add Card → Embed.

    3. Paste the link, and the video will appear as a playable card.

    You can choose whether you want to display your Youtube video as rich media or as link only in the editor sidebar.

    Embedding a Miro Board

    1. In Miro, copy the link to the board or frame you want to embed.

    2. In Smaply, open your journey map and click Add Card → Embed.

    3. Paste the link, and the interactive board will be embedded in your map.

    You can choose whether you want to display your Miro board as rich media or as link only in the editor sidebar.

    Embedding Google Docs, Sheets, or Slides

    1. Open the Google document, sheet, or slide you want to embed.

    2. Click Share and ensure the link is accessible to your team.

    3. Copy the sharing link.

    4. In Smaply, open your journey map and click Add Card → Embed.

    5. Paste the link, and the document will appear as an interactive embed.

    You can choose whether you want to display your Google file as rich media or as link only in the editor sidebar.

    Embedding Sharepoint & OneDrive Excel, Word, or PowerPoint

    1. Open the Word document, Excel sheet, or PowerPoint you want to embed.

    2. Click File, Share and Embed this document.

    3. Copy the embed code.

    4. Note: The file will only be accessible to people with permission.

    5. In Smaply, open your journey map and click Add Card → Embed.

    6. Paste the code, and the document will appear as an interactive embed.

    Embedding tasks from monday.com

    1. Open the workspace in monday.com you want to embed.

    2. Click the three dot menu and Share View.

    3. Copy the embed code.

    4. In Smaply, open your journey map and click Add Card → Embed.

    5. Paste the link, and the document will appear as an interactive embed.

    You can choose whether you want to display your tasks as rich media or as link only in the editor sidebar.

    Embed card: Link view

    Visualize your embedded docs, boards, visuals etc. as links for easier overview. Simply choose to display it as a link in the card detail sidebar, and type in the title you want.

    Benefits of Embedding Content

    • Keep everything in one place – No need to switch between apps.

    • Enhance collaboration – Work on documents and designs directly within your journey map.

    • Improve visualization – Make journey maps more engaging and interactive.

    Click the folder icon to get back to the workspace you were coming from. And head to the 3-dot-menu to copy or archive your journey map.

    Number display
    Gauge display

    December

    🚀 New Features

    • Slider Card: Add customizable sliders to your personas or journey maps to represent scales, making it easier to visualize and compare data.

    🔧 Improvements

    • Deleted Accounts: Shared maps from deleted accounts no longer appear in "Shared from outside."

    • Account Details: Clearly display the applied subscription plan for all accounts.

    • Menu Organization: Workspaces in the main menu are now sorted alphabetically.

    • Card Organization: Cards in the add-card menu are now aligned with their lane order.

    Comparison display
    Table chart
    Bar comparison display
    Pie chart
    Line chart
    Bar chart
    Horizontal bar chart
    when adding a card, a drop down opens where you can choose from various card types.