Gestes

 

Pour bien débuter

Une fois votre marqueur initialisé, vous pouvez débuter le marquage des gestes effectués par vos utilisateurs.

Dans le cas où vous souhaitez utiliser des variables, veillez à importer les classes ATInternet, Tracker et Gesture dans votre Activity.

Déclarez une variable de type Tracker dans votre Activity

package com.atinternet.atinternetdemo;

import android.app.Activity;
import android.os.Bundle;

import com.atinternet.tracker.ATInternet;
import com.atinternet.tracker.Tracker;


public class MainActivity extends Activity {

    private Tracker tracker;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        tracker = ATInternet.getInstance().getDefaultTracker();
    }
}
 

Marquage

Pour marquer un geste, le tracker expose un objet Gestures proposant une méthode add.

Par défaut, cette méthode ajoute un marquage de type « Touch ». Vous pouvez modifier le type d’évènement via la propriété action de l’objet Gesture retourné par la méthode add.

Les différentes actions sont les suivantes :

  • Touch : Envoie un hit indiquant qu’un « touch » a eu lieu
  • Navigate : Envoie un hit indiquant qu’un élément de navigation a été touché
  • Download : Envoie un hit indiquant qu’un téléchargement a été provoqué
  • Exit : Envoie un hit indiquant que l’utilisateur a changé de vue ou a quitté l’application
  • Search : Envoie un hit indiquant que l’utilisateur a “cliqué” sur un élément d’un résultat de recherche

Pour envoyer les informations définies, vous devrez appeler manuellement la méthode sendNavigation, sendExit, sendDownload, sendTouch ou sendSearch de votre objet Gesture ou appeler la méthode dispatch du Tracker.

Attention, l’appel aux méthodes sendNavigation, sendExit, sendDownload, sendTouch et sendSearch, modifie la propriété action de l’objet Gesture.

 

Exemples de marquage

  1. Marquage d’un bouton de navigation :
    @Override
    public void onClick(View v) {
            tracker.Gestures().add("Go to product detail").sendNavigation();
            Intent intent = new Intent(MainActivity.this, SecondActivity.class);
            startActivity(intent);
    }
  2. Marquage d’un bouton de navigation avec chapitrage :
    @Override
    public void onClick(View v) {
            tracker.Gestures().add("Go to product detail", "Products", "Cart").sendNavigation();
            Intent intent = new Intent(MainActivity.this, SecondActivity.class);
            startActivity(intent);
    }
  3. Marquage d’un touch sur un bouton :
    @Override
    public void onClick(View v) {
            tracker.Gestures().add("Say Hello Everybody").setLevel2(1).sendTouch();
    }
 

Classe Gesture

 

Propriétés

NomTypeValeur par défautDescription
nameStringChaîne videObtient ou définit le nom du geste
chapter1StringnullObtient ou définit le premier chapitre
chapter2StringnullObtient ou définit le second chapitre
chapter3StringnullObtient ou définit le troisième chapitre
actionEnumAction.TouchObtient ou définit le type d’action
level2Int-1Obtient ou définit l’identifiant du niveau 2
CustomObjectsCustomObjectsnullClasse permettant l’ajout d’objets personnalisés/td>
 

Méthodes

NomType de retourDescription
sendTouchvoidEnvoie un hit indiquant qu’un élément « cliquable » a été touché
sendNavigationvoidEnvoie un hit indiquant qu’un élément de navigation a été touché
sendDownloadvoidEnvoie un hit indiquant qu’un téléchargement a été provoqué
sendExitvoidEnvoie un hit indiquant que l’utilisateur a changé de vue ou a quitté l’application
sendSearchvoidEnvoie un hit indiquant que l’utilisateur a « cliqué » sur un élément d’un résultat de recherche
InternalSearch(String keywordLabel, int resultPageNumber)InternalSearchAjout des informations de recherche interne
Dernière mise à jour : 05/04/2018