Méthodes Analytics

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.

• 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.
  Si state est vide, il s’affiche sous la forme "nom d’application version d’application (compilation)" dans les rapports. Si cette valeur apparaît dans les rapports, veillez à définir state dans chaque appel TrackState.

  CONSEIL

  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.

  CONSEIL

  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.

  CONSEIL

  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;
    });