Administrator Manual
The Managers

Inside the “Resellers” branch there are also, in addition to advertisers, the managers. They are subjects, at a lower level than reseller is, who manage domains.

The Context Dropdown menu

By clicking the bar with the right mouse button, or pressing the context properties button, you expand the context dropdown menu with a range of options grouped by: default; edit; admin.

The “Default” Section

It contains the following options:

Option Description
 Advertising Dashboard

By selecting the branch, you are displayed the advertising dashboard for the manager with the following tiles: main chart; context data; advertising sold; clicks; impressions; clicks through rate; users/customers across multiple gateways.
For further details about the content of the various tiles, please refer to the “Tile Types of the Dashboards” paragraph.

Dashboard

Selecting the branch, you are displayed the manager’s dashboard with the following tiles: the main chart; count of users per domain; connections; traffic; new users; sold GW; sold advertising; click; impression; click through rate; domains with multiple connections; users with more traffic; social users; context data.
For further details about the content of the various tiles, please refer to the “Tile Types of the Dashboards” paragraph.

The “Edit” Section

In addition to the standard editing fields, it contains the following options:

Option Description
Add Campaign

Allows to add a new campaign.

Add Domain

Allows you to add a new domain.

The “Admin” Section

Contains the following options:

Option Description
 Currency and Payment Systems

Allows you to define the configuration data of the currency and payment systems of the manager.

Daily Summary of Campaigns

Shows a table with the daily summary of results of all campaigns of the manager with the description of the campaign, count of impressions, cost of impressions, count of clicks and cost of clicks.

Display All Connected Users

Shows in a table all the users connected to the manager’s gateways.

Display all Users

Shows all the manager’s registered users.

Federation Groups among Domains

Opens the page for managing federation groups across manager’s domains.

List of Access Points

Opens the page containing the list of all the access points entered at the manager-wide level.

List of the Gateways

Opens the page containing the list of all the gateways entered at the manager-wide level.

Manager System Users

Opens the page for managing users that can log in to the system with the “Manager” role.

Map of the Gateways

Shows the map of all the gateways configured based on their GPS coordinates.

Notifications

Opens a page for managing notifications for the manager

 Prepaid Credit for Advertising

Shows in a table with the summary by month and year the sales amounts for the advertising campaigns to invoice to the managers.

 Prepaid Credit of the Manager

Shows in a table grouped by month and year, the sales made for charging prepaid amounts for the managers 

 Product Policies

Opens the management of the product policies specific to the manager.

Products

Opens the management of the products saleable to the users, specific for the manager.

Sales to Users

Shows a table grouped by manager, product, month and year, costs incurred by the manager, and the revenue always obtained by the managers from the connectivity sales to users.

SMS Sales

Shows in a table, grouped by manager, product, month and year, the sales amount to the manager of SMS packages.

SSL Certificates

Shows the SSL certificate management page that can be used on MikroTik gateways.

TAX Sales

Allows defining a tax rate list with the related parameters to be assigned to the manager when selling products to the users.

Data Management Tool

Opens the page for managing manager-wide data.

The “Welcome Portal” Section

It contains the following options:

Option Description
Bypass or block IP/MAC-address

Opens the page that allows defining the IP address, the subnets, or the MAC address of the devices that must bypass the Welcome Portal or/and that must be blocked into all the gateways of the manager.

Surveys, Quizzes and Tests

Opens the page for managing surveys, quizzes and tests.

For further details about roles and permissions for the managers, please refer to the “ Users Administering the System” section.

Adding or Editing

To add a manager, select the data tab, press the button of the context properties button of the reseller in which insert a manager and select “Add manager”. While, to modify a manager, always in the data tab, press the context button on the manager and select ” Edit”. In both cases, a page appears that allows you to manage the following fields:

General Data

Field Description
ID

ID of the record. Auto-assigned Identifier of the record. It can be used to use the API or external integrations.

It is displayed during editing phase of an existing data and not during insertion of a new record.

Created on

Date and time of creation of the manager.

Category

Defines the category of the manager.

Company Name

Enter the company name.

Address

Address (E.g. Street Rome, 1234).

ZIP Code

Postal code.

City

City.

Province or State

Province or state

Country

Country.

VAT-Id Number

VAT identification number.

Phone

Enter the phone number (mobile or landline).

Fax

Fax number.

Web Address

Enter the web address.

Email Address

Enter your e-mail address. It is used as sender in sending notification mails to users. Unless you have prior defined it it considers the reseller’s one and in case, the one of the system.

Contact Person’s Last Name

Last name of the contact person.

Contact Person’s First Name 

First name of the contact person.

Registered at Register of Companies of

Indicate the place of registration of the company in the register of companies.

Place of Jurisdiction

Place of jurisdiction to be displayed in the use contract for the users.
The contents of this field can be placed using the variable% ContractPlaceOfJurisdiction%, in the field “terms of service” of the “ General Options” (this option is only available for the administrator of the system.)

Discount

Percentage discount on the price list of the products sold.
Enter the discount percentage (without the% symbol) that will be applied to the price list of the products sold by the manager. For example, if the HSNM administrator has created a product with the price of € 10 and the discount percentage of the manager is 10%, the reseller will invoice the product to the manager at a cost of € 9 (when it will be bought by the user)
Usually the discount percentage defined for the manager is lower than the one set on the reseller, otherwise the reseller would have no revenue for the product sales.

Editable only if the user has the administrator role and the permissions to manage the manager data.

Timezone

Manager’s Timezone.
It defines the timezone for the manager. The entered value parameterizes dates/hours, based on the set time zone and effects the start time, end time and the working times of the gateway.
Using this value, you can parameterize international gateways with different timezones than the one set in the system.
If you select “Use default”, it will consider the Timezone defined in the manager.

Modules and Limits

Internet Gateways Modules

Field

Description

Enable

Enable gateway management features for internet connections.

Visible only if you purchased the license for managing gateways for internet connections.

Maximum Number of Gateways

Maximum number of definable gateways. A value equals to zero states that the maximum number is limited only by the licence currently in use in your system or by the maximum number of gateway defined in the reseller.

It is used to create a multi-tenant system. Using this feature allows you to give freedom to the resellers and managers to create, modify and add gateways but also it sets a limit on the maximum number that can be inserted.

Editable only if user has permission to manage the manager’s data.

Maximum Number of Users

The maximum number of concurrent users connected to the gateways.

The defined value cannot exceed by the sum of the maximum number of users defined in the gateway. A value of zero considers the maximum number of users defined by the reseller.

By defining a value, you also activate a control on the minimum number of concurrent users on each gateway, which is set on five.

The maximum value that can be inserted depends on the “Number of users” defined in the reseller. If the reseller has a value of zero, there are no controls on the maximum number that can be inserted.

It is used to create a multi-tenant system. This option gives to managers the opportunity to create, modify and add data but it gives a limitation on the number of gateways insertable.

Editable only if user has permission to manage the manager’s data.

Maximum Users for each Gateway

The maximum number of concurrent users definable for each gateway. A value of zero considers the maximum number of users defined by the reseller.

If a value is defined on each reseller’s gateway in the “Maximum number of users” field, it will not be possible to set an upper value.

It is used to create a multi-tenant system.

Editable only if user has permission to manage the manager’s data.

Maximum Number of Views per Minute

Maximum number of Welcome Portal views per minute.

The sum of the maximum number of views per minute entered in the manager’s gateways, cannot exceed the value you define.

To indicate that the number of views is not limited, edit a zero value.

If you need to decrease or reset this value, you must first change the values defined in the gateways.

It is used to create a multi-tenant system. It allows limiting access to the Welcome Portal. When several devices try to view the Welcome Portal in the same minute and their number exceeds the defined value, the user will see a message that the system is busy and to wait for X seconds.

Editable only if the user has permission to administrate the manager’s data.

Reduce the Maximum Number of Users of the Gateways to

If you select a non-zero value during the disabled months of the gateway, the service will work the same, reducing the maximum number of users to the indicated percentage.

For example, if in the gateway, in the “Maximum Number of Users” field, you defined fifty users, in the field you select ten percent and the current month is disabled by the values selected in the gateway “Operating Months” field, the maximum number of users will be reduced to five.

If you select zero percent, in the disabled months it will not be possible to use the service and the message “Sorry, the system is not active in this month” will be displayed to users.

If you select ‘Default’ it will be considered the percentage defined at reseller level.

Maximum Number of Cards/Vouchers

Define the maximum number of “Cards“/” Vouchers” that the manager may have. If the manager has already reached the specified number, he will not be able to create others unless users use them or are cancelled. To indicate that the number of “ Cards“/” Vouchers” for the manager is not limited, edit a zero value.

Editable only if the user has permissions to manage the manager data.

Maximum Number of Active Campaigns

It indicates the maximum number of campaigns that can be activated simultaneously by the manager.

A zero value states that the maximum number is limited only by the license in use in the system except defined in the reseller.It is used to create a multi-tenant system which can limit the maximum number of active campaigns for the manager.

Editable only if user has the permissions to manage the manager’s data.

Maximum Media Size (MB)

Maximum size in megabytes of image, audio and video files that the manager can upload. The count considers the custom images, the images for the campaign banners and the media uploaded to the places of the maps.

If the reseller provides a limit in the Maximum Media Size field, the maximum value that you can enter is the one of the reseller.

When verifying the maximum media size, it takes into account the same name value defined at the reseller level. That means for example that if 10MB has been defined in the reseller and 10MB are defined in two individual managers/advertisers each, the total limit will not be 20MB but 10MB.

A value of zero declares to consider only the maximum size defined in the reseller.

Current Size (MB)

The current size of image, audio and video files.

Read-only property.

Show the Products

Define which products can be used for the domain and for the manager system users.

The possible options are:

  • Of the system, reseller and manager
  • Of the reseller and manager
  • Of the manager
  • Of the reseller
  • Of the system

Warning! If this option changes to a more restrictive setting, you may lose domain products parameters.

Fleet GPS Tracking & Telemetry Module

Field

Description

Enable

Enable the fleet GPS tracking & telemetry feature.

Maximum Number of Vehicles

Maximum number of vehicles the manager can add. A value equal to zero states that the maximum number is limited only by the license in use in the system.

Used to create a multi-tenant system. The use of this feature allows the managers to create, modify and add vehicles but places a limit on the maximum number that can be inserted.

Editable only if the the system user has permission to admin the mananger data and if the system user is enabled to manage data for fleet GPS tracking & telemetry.

Visible only if you have purchased the license for fleet tracking and if you have enabled fleet GPS tracking & telemetry from previous feature.

SMTP

Custom SMTP for the manager to use to send email notifications and/or advices. If defined, it does not consider any SMTP defined at the reseller or system level.

Field

Description

SMTP Server Address

Enter the address of the SMTP server that will be used to send email notifications and/or advices.

Secure Connection for SMTP

It enables secure connections (SSL or TLS) for SMTP.

For Gmail use SSL and port 465, and enable access to less secure app at the URL https://www.google.com/settings/security/lesssecureapps.

Possible options are:

  • No: does not enable SSL and TLS
  • Yes with SSL: enable SSL
  • Yes with TLS: enable TLS

SMTP Port

Enter the SMTP port. Generally, it is 25. For Gmail, you need to enter 587.

Enable SMTP Authentication

If enabled, it enables SMTP authentication.

SMTP Username

Username of the SMTP.

SMTP Password

Password of the SMTP.

SMS Gateway

If in the gateway type, you chose “Mail transport” or “HTTP request”, it allows you to define a custom gateway for the manager, avoiding the use of the system one. Using a custom gateway allows the manager to use his own gateway without buying SMS packages from the reseller.

To receive you can define an HTTP request to the URL http://DomainName/functions/sms-receive.php? number = Phonenumber and text = message text

Field Description
SMS Gateway Type

Defines the type of gateway to be used for sending SMSs specific to the manager. Possible values are:

  • Default (to send, it uses what is defined in system options);
  • Mail transport (it uses an external gateway for sending SMSs and requests are transmitted via SMTP);
  • HTTP request (SMS sending is done via an HTTP request. You must fill in the “URL” field with the proper variables.

This option can be modified only if the system user has the administrator/reseller role with administrative rights and a SMS gateway having the “Transport mail” or “HTTP Request” type.

Number

Define the number that is associated with the gateway to receive SMS. 

Visible only if the type of gateway is “Mail Transport” or “HTTP request””.

Sender Email Address

Sender’s email address for the gateway with transport via mail.

Visible only if the type of gateway is “Mail Transport”.

Recipient’s Address

Recipient’s email address for the gateway with transport via mail. Usually it is in the form %Number%@NomeDominioGateway.com or %NumberNoIntPrefix%@NomeDominioGateway.com where instead of %Number%, the destination mobile phone number will be inserted and instead of %NumberNoIntPrefix%, the mobile number without the international country calling code will be inserted.

  • Visible only if the type of gateway is “Mail Transport”.
  • Some SMS gateways require the recipient’s email address in the form
    InternationalPrefixMobileNumber@GatewayDomainName.com
  • (example: +393351234567@nomedominiogateway.com);
    in these cases, you have to use the %NumberPlus% variable
    (example: %NumberPlus%@NomeDominioGateway.com).
Email Subject

Object of the email to be sent to the gateway. The available variables are the same as the ones defined in the recipient’s address.

Visible only if the type of gateway is “Mail Transport”.

Request Type

Defines the type of request to execute for the specified URL.

Visible only if the type of gateway is “HTTP Request”.

URL Address

URL address for gateway with HTTP requests. In the address, you can use the variables:

  • %Number%
  • %NumberPlus% (destination number with + in the international county calling code); 
  • %NumberNoIntPrefix% (destination number without international country calling code);
  • %NumberNoIntPrefixZero% (destination number with no zeros in the international county calling code);
  • %UserName% (username);
  • %Password% (password);
  • %Message% (text to be sent).

Example:

http://DomainSmsGateway/smssend.php?username

%UserName%&password=%Password%&to=%Number%&text=

%Message%.

Visible only if the type of gateway is “HTTP Request”.

Gateway Username

Username of the gateway. It is used to enhance the % UserName% variable. Usually gateways that use HTTP requests, require the credentials in the URL.

Visible only if the type of gateway is “HTTP Request”

Gateway password

The password of the gateway. It is used to enhance the %Password% variable. Usually gateways that use HTTP requests, require the credentials in the URL.

Visible only if the type of gateway is “HTTP Request”.

Type of Country Calling Code in Receiving 

Defines the type of international country calling code received by the SMS gateway. Possible values are:

  • Auto (auto recognises the international country calling code);
  • With 00 (e.g. 0039);
  • With + (e.g. +39)
  • Without 00 nor + (e.g. 39).
  • The field is visible only if you have defined “HTTP request” in the type of gateway.
Unit Price per SMS

Enter the unit price that the reseller will apply to the manager for SMS purchases. Usually this price is higher than the price of the SMS defined in the reseller. This price is the one that will appear in the purchase procedure of SMS packages, being activated through the dropdown menu item “Buy SMS”.

Visible only if the type of gateway is “Default”.

This option can be modified only if the system user has the administrator/reseller role with administrative rights and a SMS gateway having the “Transport mail” or “HTTP Request” type.

Total Number of SMS Purchased

This field can be changed by the HSNM administrator and it states the number of SMS that the manager has purchased.

The manager also can change the value using the SMS purchase procedure accessible from the context dropdown menu of the main branch if logged in as administrator.

In case the manager has not purchased a package of sms or the administrator has not edited a value in this field, when a user registers does not receive the SMS with the log in credentials (if provided in the domain configuration “Enter SMS notification”).

This option can be modified only if the system user has the administrator/reseller role with administrative rights and a SMS gateway having the “Transport mail” or “HTTP Request” type.

Total Number of SMS Sent

Defines the total number of SMS that the manager has sent to the users. If the type of gateway is “Mail transport” or “HTTP request”, If the total number of sent SMSs corresponds to the total number of the purchased SMSs, the Manager will not be able to send SMS to users unless you purchase another package using the SMS purchasing procedure that is displayed on the left menu when you are logged in to HSNM as manager.

For each SMS sending to a user, the value of this field will be automatically increased by 1. The value of the field is eventually editable only by the administrator.

This option can be modified only if the system user has the administrator/reseller role with administrative rights and a SMS gateway having the “Transport mail” or “HTTP Request” type.

Privacy Policy to be Accepted by Users

Field Description
Privacy Policy

Enter any description of the privacy policy. It is possible to use variables:

  • %CompanyName% (managers’ company name);
  • %PrivacyPolicyRefreeName% (contact person for managers’ privacy policy);
  • %ExternalWelcomePortalLoginURL%: allows you to include in the email body, a link to access the Welcome Portal even if not directly connected to a gateway. In this way, in compliance to GDPR, users can log in with their credentials and access to their user profile data.

If not entered, it loads the one defined in the General Options.

Privacy Contact Person

Last and first name of contact person for the protection of personal data to be displayed in the information on Privacy Policy to the users. The content of this field can be edited using the %PrivacyPolicyRefreeName% variable, in the “Privacy Policy” field of the “ General Options“.

Version

Version of the Privacy Policy

If in the domain it is provided to approve the Privacy Policy statement, changing the version will prompt users for re-approval.

Revision Date

Date of last revision of the Privacy Policy.

Terms & Conditions to be Accepted by Users

Field

Description

Terms of Service

Enter the contract terms of service provided to the users. These conditions will be those that the users have to accept when registering to use the service.

It is possible to use the following variables: %CompanyName%, %Address%, %VAT%, %Web%, %EmailAddress%, %Phone%, %ContractPlaceOfJurisdiction%. These variables refer to the manager’s fields.

If not entered, it loads the one defined in the General Options.

Version

Version of the Terms & Conditions statement.

If in the domain, it is provided to approve the Terms & Conditions statement, changing the version will prompt users for re-approval.

Revision Date

Date of the last revision of the Terms & Conditions statement.

For any external integration, you can use the following URL to display the Terms & Conditions and Privacy Policy statements:

http://DomainOrIP/terms.php?id=ManagerID&domain=DomainName&lang=Language

http://DomainOrIP/privacy.php?id=ManagerID&domain=DomainName&lang=Language

The variables are:

Variable Description
DomainOrIP

Domain or IP address of HSNM.

DomainName

Name of the domain.

ManagerID

Manager’s ID.

Language

Language code to display. The possible values are:

  • it: Italian;
  • en: English;
  • es: Spanish;
  • de: German;
  • fr: French;
  • l1: first additional language;
  • l2: second additional language;
  • l3: third additional language.

MailChimp

Field

Description

MailChimp API Key

To synchronize the domain’s users, enter the MailChimp API Key.

On domains to be enabled, it must be defined also the “Audience ID”, also called “ID List”.

Custom CSS

Field Description
CSS

Custom CSSs for the manager that are applied in the Administration pages.

Warning! Customised CSSs are applied only if you log in with a user of the manager.

Options

Field Description
Delete Inactive Users

Delete automatically the inactive users according to the time indicated. 

Possible values are: default (it uses the value defined in the reseller); never; one day; one week; two weeks; one month; three months; six months; one year; eighteen months; two years; three years.

Editable only if the system user has permission to manage the manager’s data.

External ERP/PMS Code

External code of the ERP/PMS. It is used to associate the reseller with the registry of an external ERP/PMS database.

Editable only if the system user has the permissions to manage the manager’s data

Note

Enter possible notes for the manager.

Editable only if the system user has permissions to manage the manager data.

Blocked Manager

If enabled, it blocks the log in on all HGWs and PGWs of the manager’s users. 

Editable only if the system user has permissions to manage the manager data.

Warning! If a form of payment has not been enabled, the user registration procedure will work e only using a purchase from a card.