registerPreTrackCallback

La variable registerPreTrackCallback permet à votre entreprise d’associer une fonction JavaScript après la compilation d’une URL de demande d’image, mais avant son envoi. Vous pouvez utiliser cette variable pour envoyer les données collectées par AppMeasurement à un partenaire ou à une infrastructure interne.

AVERTISSEMENT

N’appelez aucun appel de suivi tel que t() ou tl() à l’intérieur de la variable registerPostTrackCallback. Les fonctions de suivi de cette variable provoquent une boucle infinie de demandes d’image !

Chaque fois que vous appelez la variable registerPreTrackCallback, vous associez cette fonction pour qu’elle s’exécute chaque fois qu’une URL de demande d’image est compilée. Évitez d’enregistrer la même fonction plusieurs fois au même chargement de page.

REMARQUE

Le timing et l’ordre des fonctions déclenchées entre registerPreTrackCallback et registerPostTrackCallback ne sont pas garantis. Évitez les dépendances entre ces deux fonctions.

Rappel de pré-suivi à l’aide de l’extension SDK Web

Le SDK Web ne permet pas d’associer une fonction après la compilation des données, mais avant leur envoi à Adobe. Cependant, vous pouvez utiliser onBeforeEventSend pour enregistrer une fonction à exécuter juste avant l’envoi des données.

  1. Connectez-vous à Collecte de données Adobe Experience Platform à l’aide de vos identifiants Adobe ID.
  2. Cliquez sur la propriété de balise de votre choix.
  3. Accédez au Extensions , puis cliquez sur le bouton Configurer sous SDK Web Adobe Experience Platform.
  4. Sous Collecte de données, cliquez sur le bouton Modifier avant le code de rappel d’envoi d’événement bouton .
  5. Placez le code de votre choix dans l’éditeur.

Rappel de pré-suivi implémentant manuellement le SDK Web

Le SDK Web ne permet pas d’associer une fonction après la compilation des données, mais avant leur envoi à Adobe. Cependant, vous pouvez utiliser onBeforeEventSend pour enregistrer une fonction à exécuter juste avant l’envoi des données, comme suit : doPlugins. Voir Modification globale des événements pour plus d’informations, voir la documentation du SDK Web .

// Set the trackingCode XDM field to "New value"
alloy("configure", {
  "onBeforeEventSend": function(content) {
    content.xdm.marketing.trackingCode = "New value";
  }
})

Rappel de pré-suivi à l’aide de l’extension Adobe Analytics

Il n’existe pas de champ dédié dans l’extension Adobe Analytics pour utiliser cette variable. Utilisez l’éditeur de code personnalisé, en respectant la syntaxe AppMeasurement.

s.registerPreTrackCallback dans AppMeasurement et l’éditeur de code personnalisé de l’extension Analytics

La fonction s.registerPreTrackCallback prend une fonction comme son seul argument. La fonction imbriquée s’exécute juste avant l’envoi d’une demande d’image.

s.registerPreTrackCallback(function(){/* Desired code */});

Si vous souhaitez utiliser l’URL de demande d’image dans votre code, référencez l’argument de chaîne requestUrl dans la fonction imbriquée. Vous pouvez analyser la variable requestUrl en fonction de l’utilisation souhaitée ; l’ajustement de cette variable n’a aucune incidence sur la collecte des données.

s.registerPreTrackCallback(function(requestUrl){
  console.log(requestUrl); // Outputs the full image request URL
});

Vous pouvez inclure des arguments supplémentaires dans la fonction s.registerPreTrackCallback, qui peuvent être utilisés dans la fonction imbriquée :

s.registerPreTrackCallback(function(requestUrl,a,b,c) {
    console.log(requestUrl); // Full image request URL
    console.log(a); // param1
    console.log(b); // param2
    console.log(c); // param3
}, "param1", "param2", "param3");
REMARQUE

La définition de variables de page ou la modification de la chaîne requestUrl dans cette fonction n’ont pas d’incidence sur la demande d’image envoyée peu après cet appel de fonction. Utilisez plutôt la variable doPlugins().

Sur cette page