Frequently Asked Questions

Nearby Notifications

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

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.
  • 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 Landing Framework and the Nearby Platform use the Google Beacon Platform's API, and have no control over whether Nearby Notifications are shown on a device. The software solely adds the beacon and Nearby Notification entry 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.

Nearby Platform

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

It's free with a limit of 3 content items of each type. If you want to use your own domain without NowSquare references, and with the option to have multiple user accounts for your clients, you need a premium subscription for $12 a month.

The free version has NowSquare branding, and the premium version for $12 a month is white label.

No, the Nearby Platform is a managed service.

Follow these instructions to export a Google key for proximity applications: generate a Google key.

You can add unlimited beacons and messages to the platform.

If you use the same key for multiple accounts, each account will see the same beacons and messages. This is probably not what you want, so you best use a different key for different accounts.

You can create different projects in your Google back-end, or have users create their own key in their own Google account.

Apart from the quotas, another advantage is that if one user violates the Google terms, this does not affect other user accounts.

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 A record".

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 IP address.
  • If you want to use a top level domain, use @ for the value and not example.com because that will resolve to example.com.example.com.

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.

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. 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 these 6 months 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 these 6 months 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.