Guggy Integration Guideline & Recommendations

Prologue

This document is a guideline and provides recommendations for companies who want to integrate Guggy in their product and are coming from a product point of view.

Technical aspect guidelines can be found at our docs.

Method of integration

Preview results once

When using this method the user needs to perform a specific action (like pressing a button) to preview the results. A good use case is to show the user a Guggy button near the send button to indicate that they are related. Tapping on the Guggy button will preview results according to the user’s text message.

Examples for this method of integration can be found in apps such as Guggy FunApp, Sila Messenger, a.i. type keyboard, BobbleApp and more.

Another example for a use case can be a long press on the send button to preview the results. However, in that case the user should be indicated somehow that he can perform this action.

Pros

Easy to understand what Guggy does

Cons

Whereas it is more complicated to find a way to show trending content (see rules and guidelines), a good example of implementation can be found in BobbleApp.

Examples

Demo Demo

Preview results as the user is typing

When using this method the app previews the results as the user types. This can be done by pressing a specific button that toggles the user to a preview-while-typing mode, or can be automatic by displaying the results after waiting a short amount of time (500-700 milliseconds). Examples for this method of integration can be found in apps such as Viber, Telegram, Hop Messenger and more. The main drawback with this method is the need to explain the user that this is not a search mechanism but a send text message as GIFs and stickers mechanism. This can be done by a hint inside the input and/or a popup in an onboarding process.

Pros

Very familiar UX and UI-wise for the user

Cons

Need a good way to explain the users that Guggy is not a search engine and they can just type naturally

Examples

Demo

Rules and guidelines

Sending the lang parameter

This parameter is very important for the functionality of the service and must be sent to support correct language analyzing and language based trending results.

Sending the userId parameter

This parameter can be scrambled and hashed but has to be unique for each user in order to have features such as “displaying a specific result to a user once” and others like that.

Fetching and displaying only the shown results

This mechanism is very efficient and will reduce the number of times and data the user fetches from the servers. You can see an example for this mechanism in Guggy FunApp where while scrolling horizontally the new results are being loaded.

Order of rendering while previewing

In order to improve the user experience it is recommended to first show the thumbnail of the result and then the preview version. Please notice that only the preview version is allowed to be used while previewing.

Hint

In case you are going to integrate Guggy in a “preview results while the user types” mode it is very important to include a hint about what Guggy is. While with features like GIPHY and Tenor you would normally add a “search gifs” hint, with Guggy you should add a “write a message”.

This feature will provide the trending texts of recent time by language (see section 1). It should be used when the user hasn’t written anything yet. Here are some examples of trending texts in the Russian and English languages:

Russian: доброе утро, спокойной ночи, как дела, люблю тебя, как дела?, я тебя люблю, всем привет.

English: i love you, good morning, love you, happy birthday, good night, how are you.

Correct order of display after user selected a result

It is very important to first display the preview result (since the use already have it on his device) and then replace it with the low res, original or high resolution version, depending on the bandwidth (3G, 4G, wifi) of the user. Example for this can be shown in Hop messenger.