- Before You Begin
- Organization And Members
- Project Overview
- Project Info
- Private keys
- Woosmap Usage Reports
- Multi-Factor Authentication
The Woosmap Console is a user-friendly dashboard that enables you to manage your assets and review your metrics. It’s the easiest way to upload your data and get your first experience with Woosmap.
Before You Begin
If you don’t already have a Woosmap account, follow our signup process at this page.
Otherwise, if you’ve already created an account or accepted an invitation from your Organisation owner, just log in directly to the Woosmap Console.
After signing up, creating a local search experience is just three simple steps:
- Create an Organization, an associated Project and a Private API Key
- Import the data you want to display, recommend and search
This three steps are described at the get started guide.
Organization And Members
Once your account is activated, if you’re the first user of your team to login, you are invited to create an organization. An organization allows a group of users to collaborate together effectively, all while keeping your organization’s information private. After creating the organization, you can invite users to join in by specifying their email. Click on the Invitations button located at the upper right side of the dashboard.
An email invitation is valid for 7 days. If your teammates forgot to sign up through the invitation email, don’t worry, you can send another invitation.
All your projects will belong to this organization so if the owner decides to remove a user, the projects he created will still be accessible. It is not possible to change a projects from an organization to another.
By default, the person who creates the organization becomes the Owner. Only Owners and Co-Owners can create or administrate Teams. Teams allow to separate visibility rights over Projects.
Warning: only active users of Woosmap can be assigned to Teams.
Teams are useful to separate teammates depending on the Projects they are working on. Clients mostly use them to define Projects by markets (eg: Northern Europe, Eastern Europe, France..). See an example below:
A Team is composed of Members, who can have specific rights over one or more Projects
In a Team, members have the same rights over specific projects. There are 3 rights levels:
- Read: you only have the ability to visualize data in the Project. This level is particularly indicated for people willing to follow API consumption through the Metrics for instance or just access public API keys for integration.
- Write: same rights but with the additional ability to create create, edit or delete Assets in a project.
- Admin: you can act upon anything in the project, including creating and deleting private API keys.
Nota: one member can be part of multiple teams. An invited member will have access to no projects upon joining the Organization. An owner or co-owner must assign him to the expected Team(s) he should be part of.
Projects are containers for your assets and associated analytics usage. The first step before uploading your assets is to create a new Project specifying at least a name. For your first experience, we recommend you to begin with our integrated step-by-step guide by clicking the tutorial button on top of the Project listing page.
When you login to Woosmap, the console displays a dashboard of counters for your projects, users and aggregated metrics.
You are able to quickly refine your metrics for a specific project. Click on All Projects drop-down list to select the one you want. This page also enable you to navigate to your Project listing and Members listing by clicking the corresponding block.
Click Projects on the left sidebar and select the one you want to manage.
This tab is an overview of your project representing the number of assets, your authorized domains and your Public Key.
The Public Key is automatically generated when you add a new project to your organization. You could have only one Public Key per project.
You can here authorize new domains name (allowed referrers -
*.mydomain.com) where your assets will be displayed, recommended or searched.
Private keys allow you to manage integrations on the server-side and perform creation of new and updates of existing assets. As we aggregate analytics usage per project, it is good form to create separate projects based on intended use, such as one for your staging environment and one for the production environment.
Click Assets tab when viewing a Project.
The page displays a table of your assets. As a prerequisite to manage them, you’ll need to create a Private Key. From your assets dashboard, you can:
- Add new assets by clicking the UPLOAD button and choosing POST method
- Modify your existing assets with the UPLOAD button and choosing PUT method
- View individual Input and Output asset JSON (as expected and returned by the Woosmap API)
- Delete all your assets with the DELETE ALL button. Use this feature with caution because you will not be able to recover your assets!
Please note that to add or replace your assets using the console, the expected source data must be in native Woosmap JSON format.
Click Widgets tab when viewing a Project.
To match your preferences and website’s graphic style, several properties of your Store Locator Widget can be customised by the Woosmap team.
Woosmap Usage Reports
To view the Woosmap usage reports, click Metrics tab when viewing a Project.
The Woosmap usage reports provide real-time usage data for any APIs for which you use an API key, Private or Public. Note that the reports provide data from one hour and for up to 12 months.
See below all the metrics you can retrieve. Click on each metrics to access corresponding fine-tuned indicators.
This counter represents the total number of times the search endpoint API was used using one of the following operations:
- Get Stores: report each use of
- Get Position: report each use of
Ten Mapping are counted when any of the following occur:
- A web page or application displays a map using the Woosmap Store Locator Widget.
After a web page or application loads a map, any user interactions with it, such as panning, zooming, or switching map layers, do not generate additional Mapping count.
Count the use of internal data management operations. Please note that the increment is based on each asset and not on each call.
For example a call to the endpoint api
/replace giving it a json file of 100 assets will increment by 200 this counter (100 deleted and 100 created)
- Import Stores: the number of assets updated or created using the
- Delete Stores: the number of assets deleted using the
- Replace all Stores: the number of assets replaced x2 (it first delete then create the asset) using the
The Multi-factor Authentication is an authentication method that requires you to provide several verification factors to access your account. It is an easy way to strengthen your account security and prevent any authentication problems.
In the Woosmap Console, the Multi-factor Authentication requires you to link your mobile device to your Woosmap account and use a tokens system to access the console. You can use apps such as Google Authenticator or Microsoft Authenticator, available on both the Play Store and the Apple Store.
You can able the multi-factor authentication in just a few steps:
- Go to “My Profile” (bottom-left hand corner)
- Click on “Multi-Factor Authentication”
- Enter your password
- Click on “Add Mobile Device” button
- Enter a device name
Scan the QR code with your multi-factor authentication app on your phone and enter the two tokens it shows you
- Copy and save your recovery tokens in a place you’ll remember!
Next time you’ll login to the Console, you’ll have to first enter your password and then the token generated by the app you’re using.