Informations destinées à vous aider à utiliser le SDK de plateforme Windows universelle avec Adobe Analytics.
Le SDK prend actuellement en charge plusieurs solutions Adobe Experience Cloud, notamment Analytics, Cible et Audience Manager. Un préfixe est ajouté aux méthodes selon la solution. Les méthodes Analytics comportent le préfixe "Analytics".
Chacune de ces méthodes est utilisée pour envoyer des données dans la suite de rapports Adobe Analytics.
Lorsque vous utilisez winmd
des méthodes de winJS (JavaScript), toutes les méthodes ont automatiquement leur première lettre minuscule.
TrackState (winJS: trackState)
Contrôle l’état d’une application avec les données contextuelles facultatives. Les états sont les vues disponibles dans votre application, telles que "tableau de bord d’accueil", "paramètres de l’application", "panier", etc. Ces états sont semblables aux pages d’un site web ; les appels TrackState
incrémentent les pages vues.
If state
is empty, it displays as "app name app version (build)" in reports. If you see this value in reports, make sure you are setting state
in each TrackState
call.
Il s’agit du seul appel de suivi qui incrémente les pages vues.
Voici la syntaxe de cette méthode :
static void TrackState(Platform::String ^state, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object> ^contextData);
Voici l’exemple de code pour cette méthode :
var ADB = ADBMobile
ADB.Analytics.trackState("loginScreen", null);
TrackAction (winJS: trackAction)
Effectue le suivi d’une action dans votre application. Les actions sont les actions qui se produisent dans votre application et que vous souhaitez mesurer, telles que les "connexions", les "clics sur la bannière", les "abonnements de flux" et d’autres mesures.
Voici la syntaxe de cette méthode :
static void TrackAction(Platform::String ^action, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object> ^contextData);
Voici l’exemple de code pour cette méthode :
varADB=ADBMobile;
ADB.Analytics.trackAction("ButtonClick",null);
GetTrackingIdentifierAsync (winJS : getTrackingIdentifierAsync)
Renvoie l’ID de visiteur généré automatiquement pour Analytics. Il s’agit d’un identifiant de visiteur unique propre à l’application, qui est généré au lancement initial, puis stocké et utilisé à partir de ce moment. Cet identifiant est conservé entre les mises à niveau de l’application et supprimé lors de la désinstallation.
Voici la syntaxe de cette méthode :
static Windows::Foundation::IAsyncOperation<Platform::String> ^GetTrackingIdentifierAsync();
Voici l’exemple de code pour cette méthode :
vartrackingIdentifier;
ADBMobile.Analytics.getTrackingIdentifierAsync().then(function(trackingid){
trackingIdentifier=trackingid;
});
TrackLocation (winJS : trackLocation)
Envoie les coordonnées x et y actuelles. Utilise également les points ciblés définis dans le fichier ADBMobileConfig.json
pour déterminer si l’emplacement fourni comme paramètre se trouve dans l’un de vos points ciblés. Si les coordonnées actuelles se trouvent dans un point ciblé défini, une variable de données contextuelle est renseignée et envoyée avec l’appel trackLocation
.
Voici la syntaxe de cette méthode :
static void TrackLocation(double lat, double lon, double accuracy, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object> ^contextData);
Voici l’exemple de code pour cette méthode :
varADB=ADBMobile;
ADB.Analytics.trackLocation(47.60621,-122.33207,null);
TrackLifetime ValueAugmentation (winJS : trackLifetime ValueAugmentation)
Ajoute amount
à la valeur de durée de vie de l’utilisateur.
Voici la syntaxe de cette méthode :
static void TrackLifetimeValueIncrease(float amount, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object> ^contextData);
Voici l’exemple de code pour cette méthode :
varADB=ADBMobile;
ADB.Analytics.trackLifetimeValueIncrease(10,null);
TrackTimed ActionStart (winJS : trackTimed ActionStart)
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.
Voici la syntaxe de cette méthode :
static void TrackTimedActionStart(Platform::String ^action, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object^> ^contextData);
Voici l’exemple de code pour cette méthode :
varADB=ADBMobile;
ADB.Analytics.trackTimedActionStart("cartToCheckout",null);
TrackTimed ActionUpdate (winJS : trackTimed ActionUpdate)
Transmet contextData
afin de mettre à jour les données contextuelles associées à l’action
donnée. Les data
(données) transmises sont ajoutées aux données existantes pour l’action donnée et remplacent les données si la même clé est déjà définie pour l’action
.
Cet appel n’envoie pas d’accès.
Voici la syntaxe de cette méthode :
static void TrackTimedActionUpdate(Platform::String ^action, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object> ^contextData);
Voici l’exemple de code pour cette méthode :
varADB = ADBMobile;
varcontextData = newWindows.Foundation.Collections.PropertySet();
contextData["quantity"]=3;
ADB.Analytics.trackTimedActionUpdate("cartToCheckout",contextData);
TrackTimedActionExistsAsync (winJS : trackTimedActionExistsAsync)
Renvoie true si l’action minutée donnée existe et false si elle n’existe pas.
Voici la syntaxe de cette méthode :
static Windows::Foundation::IAsyncOperation<bool> ^TrackTimedActionExistsAsync(Platform::String ^action);
Voici l’exemple de code pour cette méthode :
ADBMobile.Analytics.trackTimedActionExistsAsync("signUp").then(function(exists){
actionExists = exists;
});
TrackTimed ActionEnd (winJS : trackTimed ActionEnd)
Termine une action minutée.
Voici la syntaxe de cette méthode :
static void TrackTimedActionEnd(Platform::String ^action);
Voici l’exemple de code pour cette méthode :
varADB = ADBMobile;
ADB.Analytics.trackTimedActionEnd("cartToCheckout");
ClearTrackingQueue (winJS: clearTrackingQueue)
Efface tous les accès stockés de la file d’attente de suivi Analytics.
Voici la syntaxe de cette méthode :
static void ClearTrackingQueue();
Voici l’exemple de code pour cette méthode :
ADBMobile.Analytics.clearTrackingQueue();
GetQueueSizeAsync (winJS : getQueueSizeAsync)
Renvoie le nombre d’accès actuellement stockés dans la file d’attente Analytics.
Voici la syntaxe de cette méthode :
static Windows::Foundation::IAsyncOperation<int> ^GetQueueSizeAsync();
Voici l’exemple de code pour cette méthode :
varqueueSize;
ADBMobile.Analytics.getQueueSizeAsync().then(function(size){
queueSize=size;
});