Frequently Asked Questions

Nearby Platform [product]

You can find technical documentation for the Nearby Platform here.

When the payment is received, you will automatically receive an invitation for the NowSquare Gitlab account to get access to the script(s) you've purchased.

You have access to updates as long as your a member of the Gitlab repository. By default you will get access for 6 months, depending on the package you've purchased. During this period you can update by entering git pull origin master in your CLI. Or download the latest version as a Zip file.

After this period a new license is required to update to the latest version.

As long as your an active member of the Gitlab repository, you can ask questions at https://nowsquare.com/contact. We strive to give adequate answers as soon as possible, but in the first instance we only provide support on bugs and usage issues that prevent working of the system. No consultancy on how to develop your own features.

Showstoppers and non-critical bugs reported after the support period require an active license. Due to the complexity of the software and the large code base, it's inevitable there will be issues. Third party requirements may change outside our control, so if you experience issues that have been fixed after your subscription, you will have to buy an update.

Support has to be reasonable and fair. We can't support you with setting up any kind of hardware, or implementing or usage of third party features. When starting a business, you need to invest time yourself. We can only keep the price low because we don't provide personal help. This would cost our regular hourly rate.

Yes. The Nearby Platform can be branded with your logo and name, and installed on your own server and domain.

One license allows you to install a script on one server (VPS, cluster or other cloud setup) and have unlimited user registrations.

Yes, if you have the knowledge. All PHP code is unencrypted and you're free to modify everything. All PHP, JavaScript, CSS, Sass, Gulp and Bower files are included.

Probably not. Though it may seem an easy feature, projects like this take thousands of hours to develop in the first place. New features require consideration, design, development, testing, documentation and when it's implemented, it has to be supported. There will be bugs, questions, backwards compatibility issues, and more. So, you need a serious budget, or the skills to build upon it yourself.

Nearby Platform [service]

The Nearby Platform service is the online system you can find here.

Landing Framework

You can find technical documentation for the Landing Framework here.

You can find the user manual for the Landing Framework here.

You can find the technology stack for the Landing Framework here.

When the payment is received, you will automatically receive an invitation for the NowSquare Gitlab account to get access to the script(s) you've purchased.

You have access to updates as long as your a member of the Gitlab repository. By default you will get access for 6 months, depending on the package you've purchased. During this period you can update by entering git pull origin master in your CLI. Or download the latest version as a Zip file.

After this period a new license is required to update to the latest version.

As long as your an active member of the Gitlab repository, you can ask questions at https://nowsquare.com/contact. We strive to give adequate answers as soon as possible, but in the first instance we only provide support on bugs and usage issues that prevent working of the system. No consultancy on how to develop your own features.

Showstoppers and non-critical bugs reported after the support period require an active license. Due to the complexity of the software and the large code base, it's inevitable there will be issues. Third party requirements may change outside our control, so if you experience issues that have been fixed after your subscription, you will have to buy an update.

Support has to be reasonable and fair. We can't support you with setting up any kind of hardware, or implementing or usage of third party features. When starting a business, you need to invest time yourself. We can only keep the price low because we don't provide personal help. This would cost our regular hourly rate.

Yes. The Landing Framework can be branded with your logo and name, and installed on your own server and domain.

One license allows you to install a script on one server (VPS, cluster or other cloud setup) and have unlimited user registrations.

Yes, if you have the knowledge. All PHP code is unencrypted and you're free to modify everything. All PHP is included. Build files for client-side scripting can be bought separately.

Proximity App

The Android application is written in Java language in Android Studio environment and is a loosely integrated solution. The iOS application is written in Swift language in Xcode environment and is a tightly integrated solution.

At the moment only the code is documented. Since the apps are simple and straightforward, it should be easy for anyone with app development experience to use it as a base.

When the payment is received, you will automatically receive an invitation for the NowSquare Gitlab account to get access to the script(s) you've purchased.

You have access to updates as long as your a member of the Gitlab repository. By default you will get access for 6 months. During this period you will be able to download the latest version as a Zip file.

After this period a new license is required to update to the latest version.

As long as your an active member of the Gitlab repository, you can ask questions at https://nowsquare.com/contact. We strive to give adequate answers as soon as possible, but in the first instance we only provide support on bugs and usage issues that prevent working of the system. No consultancy on how to develop your own features.

Showstoppers and non-critical bugs reported after the support period require an active license. Due to the complexity of the software and the large code base, it's inevitable there will be issues. Third party requirements may change outside our control, so if you experience issues that have been fixed after your subscription, you will have to buy an update.

Support has to be reasonable and fair. We can't support you with setting up any kind of hardware, or implementing or usage of third party features. When starting a business, you need to invest time yourself. We can only keep the price low because we don't provide personal help. This would cost our regular hourly rate.

Yes. The Proximity App can be branded with your logo and name, and deployed on your own app store accounts.

One license allows you to compile and deploy one app.

Multiple apps require multiple licenses, also if you modify the source code.

Yes, if you have the knowledge. All source code is unencrypted and you're free to modify everything.

Nearby Notifications

Nearby Notifications are notifications on Android devices that don't require an app. Learn more.

Start here to create a new project for your proximity service key: https://console.developers.google.com/apis/dashboard.

Google shut down the Nearby Notification service December 5th 2018. All Nearby Notifications stopped working.

If a Nearby Notification is not shown, verify the following:

  • The beacon battery is charged.
  • The beacon is transmitting the Eddystone UID protocol (check this with the vendor's app).
  • The Android device has Bluetooth turned on.
  • Make sure the url of the Nearby Notification is SSL (https NOT http).
  • Make sure the phone you test on has the same language as selected at the notification.
  • Make sure the url is reachable with this tool.
  • Make sure the content of the url does not conflict with Google's Nearby Notification policies.

Troubleshooting

  • Make sure you're close enough to the beacon. For testing purposes try a distance shorter than 1 meter.
  • If you use a date and a time range, the time range is on a daily base. Meaning, that if you broadcast from January 10th to June 20th and from 8am to 10am, the message will show each day between 8am and 10am. Not from January 10th 8am to June 20th 10am.
  • Try different URLs, non-working URLs may be cached by Google.
  • Log into the Google Beacon Dashboard and create a Nearby Notification in debug mode.
  • Turning Bluetooth off and on again sometimes solves the issue.
  • Create a new service key.
  • Make sure no quotas are attained in the Google API dashboard.
  • Google uses an algorithm to decide whether a Nearby Notification is relevant for users and whether it's shown. If a user gets a Nearby Notification each day, but doesn't open it, it tends to get hidden. Because Google wants to provide useful content, and appearently the user is not interested in the notification.

Finally, verify directly in the Google Beacon Platform if the entries are correct. This rules out that the issue is related to the software. The Nearby Platform uses the Google Beacon Platform API, and has no control over whether Nearby Notifications are shown on a device. The software is just an interface to add beacon and Nearby Notification entries to the Google Beacon Platform.

No. It's a Google concept for Android devices, and it's unlikely it will ever be supported by Apple.

Eddystone beacons

You can find the Instance and Namespace ID with the app provided by the vendor of the beacon. These are assigned and can not be changed. With some beacons you can turn the Eddystone UID protocol on or off.

If you can't find the IDs with the included app, you best contact the vendor.

Domain DNS management

You can manage your DNS at your domain registrar.

You can either send a support ticket to your registrar, or Google something like "[insert name hosting provider] add an CNAME record".

Go to the DNS management of your domain registrar, and add the following A record (naming can vary per registrar):

Type: CNAME

Host / Name: add the first part of your subdomain. In case of nearby.example.com add nearby.

Points to / Value: nowsquare.com

It may take a couple of hours for the DNS to propagate. DNS can be cached at your Internet Service Provider, that's why it sometimes doesn't work on your desktop PC, but it does work on your 4G phone.

Troubleshooting

  • Make sure there are no conflicting records, maybe you have to delete an existing record with the same value pointing to a different host or IP address.

If you get an SSL related error, that is because it can take up to a couple of hours for the SSL certificate to be generated. If the SSL certificate isn't generated after 24 hours, this means the DNS is not configured correctly.