Developers » AS2 tagging » Android » Contenus de l'application » Gestes 2.3.0
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 lutilisateur a cliqué sur un élément dun 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
- 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); }
- 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); }
- 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
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
name | String | Chaîne vide | Obtient ou définit le nom du geste |
chapter1 | String | null | Obtient ou définit le premier chapitre |
chapter2 | String | null | Obtient ou définit le second chapitre |
chapter3 | String | null | Obtient ou définit le troisième chapitre |
action | Enum | Action.Touch | Obtient ou définit le type d’action |
level2 | Int | -1 | Obtient ou définit l’identifiant du niveau 2 |
CustomObjects | CustomObjects | null | Classe permettant lajout dobjets personnalisés/td> |
Méthodes
Nom | Type de retour | Description |
---|---|---|
sendTouch | void | Envoie un hit indiquant qu’un élément « cliquable » a été touché |
sendNavigation | void | Envoie un hit indiquant qu’un élément de navigation a été touché |
sendDownload | void | Envoie un hit indiquant qu’un téléchargement a été provoqué |
sendExit | void | Envoie un hit indiquant que l’utilisateur a changé de vue ou a quitté l’application |
sendSearch | void | Envoie un hit indiquant que l’utilisateur a « cliqué » sur un élément d’un résultat de recherche |
InternalSearch(String keywordLabel, int resultPageNumber) | InternalSearch | Ajout des informations de recherche interne |