Liste des méthodes Adobe Analytics fournies par la bibliothèque Android.
Le SDK prend actuellement en charge plusieurs solutions Adobe Experience Cloud, notamment Analytics, Target, Audience Manager, ainsi que le service d’identification Adobe Experience Platform. Un préfixe est attribué aux méthodes selon la solution. Par exemple, les méthodes d’Experience Cloud ID sont affectées du préfixe analytics
.
Chacune des méthodes suivantes est utilisée pour envoyer des données vers la suite de rapports Adobe Analytics :
trackState
Contrôle l’état d’une application avec les données contextuelles facultatives. Les états sont les affichages disponibles dans l’application, par exemple home dashboard
, app settings
, cart
, etc. Ces états sont semblables aux pages d’un site web ; les appels trackState
incrémentent les pages vues.
Si state
est vide, app name app version (build)
s’affiche dans les rapports. Si cette valeur s’affiche dans les rapports, assurez-vous que vous avez défini state
dans chaque appel trackState
.
Il s’agit du seul appel de suivi qui incrémente les pages vues.
Voici la syntaxe de cette méthode :
public static void trackState(String state, Map<String, Object> contextData);
Voici l’exemple de code pour cette méthode :
Analytics.trackState("loginScreen", null);
trackAction
Effectue le suivi d’une action dans votre application.
Actions que vous voulez mesurer, par exemple logons
, banner taps
, feed subscriptions
, et d’autres mesures, qui se produisent dans l’application.
Voici la syntaxe de cette méthode :
public static void trackAction(String state, Map<String, Object> contextData);
Voici l’exemple de code pour cette méthode :
Analytics.trackAction("heroBannerTouched", null);
getTrackingIdentifier
envoie l’identifiant visiteur automatiquement généré pour Analytics.
Il s’agit d’un ID de visiteur unique spécifique à l’application, qui est généré au lancement initial et qui est stocké et utilisé à partir de ce moment. L’identifiant est conservé entre les mises à niveau de l’application et supprimé lorsque l’application est désinstallée.
Voici la syntaxe de cette méthode :
public static String getTrackingIdentifier();
Voici l’exemple de code pour cette méthode :
String trackingId = Analytics.getTrackingIdentifier();
trackLocation
Envoie la latitude, la longitude et la position actuelles dans un point ciblé défini. Pour plus d’informations, voir Géolocalisation et points ciblés.
Voici la syntaxe de cette méthode :
public static void trackLocation(Location location, Map<String, Object> contextData);
Voici l’exemple de code pour cette méthode :
Analytics.trackLocation(userLocation, null);
trackLifetimeValueIncrease
Ajoute amount
à la valeur de durée de vie de l’utilisateur.
Voici la syntaxe de cette méthode :
public static void trackLifetimeValueIncrease(BigDecimal amount, Map<String, Object> contextData);
Voici l’exemple de code pour cette méthode :
Analytics.trackLifetimeValueIncrease(new BigDecimal(30), null);
trackTimedActionStart
Commence une minutée portant le nom action
action.
Si vous appelez cette méthode pour une action qui a déjà commencé, l’action minutée précédente est écrasée.
Cet appel n’envoie pas d’accès.
public static void trackTimedActionStart(String action, Map<String, Object> contextData);
Voici l’exemple de code pour cette méthode :
Analytics.trackTimedActionStart("cartToCheckout", null)
trackTimedActionUpdate
Transmet contextData
pour mettre à jour les données contextuelles associées à l’action
. Les données data
transmises sont ajoutées aux données existantes pour l’action et, si la même clé est déjà définie pour action
, écrase les données.
Cet appel n’envoie pas d’accès.
Voici la syntaxe de cette méthode :
public static void trackTimedActionUpdate(String action, Map<String, Object> contextData);
Voici un exemple de code pour cette méthode :
HashMap cdata = new HashMap<String Object> ();
cdata.put("quantity",3);
Analytics.trackTimedActionUpdate("cartToCheckout", cdata);
trackTimedActionEnd
Termine une action minutée. Si vous fournissez block
, vous pouvez accéder aux valeurs temporelles finales et manipuler data
avant d’envoyer l’accès final.
Si vous fournissez un block
, vous devez renvoyer true
(OUI) pour envoyer un accès. La transmission de null
pour block
envoie l’accès final.
Voici la syntaxe de cette méthode :
public static void trackTimedActionEnd(String action, TimedActionBlock<Boolean> logic);
Voici l’exemple de code pour cette méthode :
Analytics.trackTimedActionEnd("cartToCheckout",new
Analytics.TimedActionBlock<Boolean>(){
@Override
public Boolean call(long inAppDuration, long totalDuration, Map<String, Object> contextData) {
contextData.put("price", 49.95);
return true;
}
});
sendQueuedHits
Requiert le SDK 4.1.
Quel que soit le nombre d’accès mis en file d’attente, cette méthode force la bibliothèque à envoyer tous les accès dans la file d’attente hors ligne.
Voici la syntaxe de cette méthode :
public static void sendQueuedHits();
Voici l’exemple de code pour cette méthode :
Analytics.sendQueuedHits();
getQueueSize
Renvoie le nombre d’appels de suivi stockés dans la file d’attente hors ligne.
Voici la syntaxe de cette méthode :
public static long getQueueSize();
Voici l’exemple de code pour cette méthode :
long queueSize = Analytics.getQueueSize();
clearQueue
Efface tous les accès de la file d’attente hors ligne.
Voici la syntaxe de cette méthode :
public static void clearQueue();
Voici l’exemple de code pour cette méthode :
Analytics.clearQueue();
Soyez prudent lorsque vous effacez manuellement la file d’attente. Cette action est irréversible.
processReferrer
Traite les données de campagne des référents de la boutique Google Play pour une utilisation ultérieure.
Voici la syntaxe de cette méthode :
public static void processReferrer(final Context context, final Intent intent);
Voici l’exemple de code pour cette méthode :
Analytics.processReferrer(getApplicationContext(), intent);
processGooglePlayInstallReferrerUrl
Cette API est disponible à partir de la version 4.18.0 du SDK.
Récupère les données d’acquisition à partir de l’URL du référent d’installation Google Play fournie.
Les données collectées à partir de cette API seront envoyées lors des accès d’installation envoyés à Analytics et seront disponibles dans le rappel de données Adobe.
Si les données du référent ont déjà été collectées par le SDK, l’appel de cette méthode n’aboutira pas.
Pour plus d’informations sur la récupération de l’URL du référent, consultez la documentation Google : https://developer.android.com/google/play/installreferrer/library (documentation en anglais).
Voici la syntaxe de cette méthode :
public static void processGooglePlayInstallReferrerUrl(final String referrerUrl);
Voici l’exemple de code pour cette méthode :
Analytics.processGooglePlayInstallReferrerUrl(referrerUrl);