Help Docs

Create Apps

  1. Open AimMatic My Apps
  2. Login usign AimMatic credentials alt text
  3. Select your account name alt text
  4. Type your App name alt text
  5. Finally click create App

Create an API key

  1. Open AimMatic My Apps
  2. Login usign AimMatic credentials alt text
  3. Select an App alt text
  4. Click on Create Key alt text
  5. From the dialog choose API Key alt text
  6. Check “Test KEY” if you would like to create a test ApiKey
  7. Click “OK” to create the key

Create a KeyPair

  1. Open AimMatic My Apps
  2. Login usign AimMatic credentials alt text
  3. Select an App alt text
  4. Click on Create Key alt text
  5. From the dialog choose API Key alt text
  6. Check “Test KEY” if you would like to create a test KeyPair
  7. Click “OK” to create the key
  8. Save the Secret Key because you won’t be able to retrieve it again. alt text

Free Map Instructions

Free Map is a secure, cloud-based map drawing tool built on top of Google Maps. Free Map includes unlimited free map storage, advanced filters, and several drawing modes.

Free Map is available to all users after the login to AimMatic services.

  1. Select the hand icon to enter pan mode

  2. Use the zoom slider to zoom in or zoom out

Draw shapes

  1. Select a draw mode: Freeform, Rectangle, Circle
    • Grid of squares draw mode is a beta feature and has limited functionality
    • Click anywhere on the map to draw your shape
    • Freeform shapes are formed when the end point is connected to the start point

Edit shapes

  1. Select pencil icon to enter edit mode
    • Edit the vertices of freeform and rectangle polygons
    • Edit the radius of circles

InfoWindow features

  1. Select the polygon to call up the InfoWindow info for that polygon

  2. InfoWindow includes settings for:

    • Polygon edit the fill and stroke
    • Edit publish status: Publish <-> Unpublish OR Unpublish <-> Trash
    • Get location list is a special function for Double Click Bid Manager Geography Targeting
    Read More:

    DBM Geography Targeting

    PROXIMITY TARGETING Add latitude/longitude coordinates in bulk. Proximity targeting is limited to mobile app inventory.

    • If the location list is empty NULL, then the shape is too small. Edit the shape to make it larger, or try a different size location list.
    • VERY IMPORTANT Use the location list of lat/long coordinates that matches the new radius label you will use for proximity targeting
    E.g., Get a MEDIUM location list for use with MEDIUM proximity radius

Search Bar features

  1. Search Google Maps will find a place from Google Places API

  2. Filter has two types. More than one filter can be used; filters not mutually exclusive.

    • Date filter displays the shapes created with the date range
    • Status filter displays the shapes based on publish status
    • Select the print icon to print the screen

Natural Voice Integration

Concept

Natural Voice makes it easy to integrate voice feedback into your web pages and mobile apps.

Products

Several implementations are supported.

Natural Voice Web Elements

Quickly add hosted voice feedback widgets to your web pages. This is a low code implementation consisting of a small javascript snippet. Please read about our web libraries for more information.

Natural Voice Mobile

Quickly set-up your mobile app for voice feedback using Natural Voice Mobile SDKs for Android and iOS. Please read below steps to customize your implementation.

Natural Voice Java

Quickly add voice feedback to your web pages using Natural Voice Java SDK. Please read below steps to customize your implementation.

Natural Voice Customization

1. Set-Up your Frontend

Recommendations

Download an SDK for your dev environment, either Android, iOS, or Java. The SDK is the developer toolkit to add Natural Voice services to your frontend application. Github

Langs API

Developers use the Langs API to retrieve the list of languages that Natural Voice supports. The API returns a list of supported Natural Voice languages including the language name to display and the language code parameter for speech-to-text recognition.

We recommend that the language be user-defined for improved speech-to-text recognition results. Alternately, your application should have confirmation that the device language is the same as the preferred language for speaking. Keep in mind that speech-to-text recognition results will be degraded if your user has set their device language as English United States but they are not a native English speaker from the United States, for example.

Upload Audio API

Developers use the Upload Audio API to upload audio from a Natural Voice session for speech-to-text recognition in the cloud as well as automated text analysis by natural language processing (NLP). The default parameters are recommended for most applications.

About audio recording:

2. Get Natural Voice Results

Daily Insights Email

One the Natural Voice services is the Daily Insights Email. Every 24 hours, an email is automatically delivered to specified email address for that account. The Daily Insights Email includes expiring links to download the results of the sessions sent-in during the past 24 hours for the account, including:

Set-Up a Server-to-Server Connection to Retrieve Results

Developers create an App and create an API Key plus Secret Key or KeyPair to authenticate to Natural Voice services then retrieve results from the available Insights RESTful APIs.

PRO Insights APIs include:

Virtual Assistants and Natural Voice

Overview

Natural Voice libraries support two upload methods, audio and text. Both methods are valid for text analytics and other services provided by Natural Voice. Our investigations indicate that for reasons of user privacy, virtual assistants are more likely to support an implementation that uploads text.

Build for iOS with SiriKit

Concept

User interactions on iOS follow a specific pattern after Siri is invoked:

Text from either the intent or the input can be extracted and uploaded to Natural Voice using the OnVoiceSent method in our client library.

Suggested Implementations

1. Lists and Notes Intents Domain Text from user input is sent in to Natural Voice.

Requirement: iOS 10+ Natural Voice upload method: TEXT

Apple says:
Use SiriKit to handle user requests for your app’s services that originate from Siri. You implement Intent App Extensions to integrate Natural Voice requests with Siri. SiriKit defines the types of requests-—known as intents—-that users can make. Related intents are grouped into domains to make it clear which intents you might support in your app. With the lists and notes domain, users can create or modify notes in your app. Read more

To extract text for Natural Voice, developers should provide support for Create Note.

There are two classes:

A request to create a new note.

Your app’s response to a request to create a note.

After the note is created, call the Natural Voice method UploadText to send in the text in the note. Please see the Read Me in github for documentation of UploadText method.

2. Custom Intent Siri Shortcut Text from user intent is sent in to Natural Voice.

Requirement: iOS 12+ Natural Voice upload method: TEXT

Step 1: Define Shortcuts Apple says: You determine which actions in your app are pertinent to the user and may be something they’d like to do in the future. Your app tells Siri about these actions by specifying them as relevant shortcuts.
Read more

Step 2: Add Custom Intent Configure a custom intent and define the parameters for Natural Voice. Apple says: You define a custom intent by first adding an Intent Definition file to your Xcode project. Then add the custom intent to the definition file. Read more

Step 3: Donate Shortcuts You should donate a shortcut each time the user invokes your Natural Voice functions in your app. Apple says: Don’t donate intents handled by your Intent App Extension. Siri already knows about those intents and will consider them when predicting suggestions in the future. Siri can predict shortcuts to actions that a user may want to perform using your app, and suggest those shortcuts to the user in places such as Spotlight search, Lock Screen, and Siri Watch Face. Siri learns about the shortcuts available for your app through donations that your app makes to Siri. Users can also use donated shortcuts to add personalized voice phrases to Siri. Read more

Step 4: Suggesting Shortcuts to Users Apple says: Sometimes there are actions in your app the user hasn’t performed that might be of interest to them. If you think a user may want to add your Natural Voice functions to Siri, you can suggest a shortcut to Natural Voice functions. Read more

To capture the user text from a Custom Intent Siri Shortcut, you extract the parameter in event handling. Then call the Natural Voice method UploadText to send in the parameters as text. Please see the Read Me in github for documentation of UploadText method.