useBeacon

Dernière mise à jour : 18 juillet 2024
  • Rubriques :

Créé pour :

  • Administration
  • Développeur

La plupart des navigateurs modernes incluent la méthode native navigator.sendBeacon(). Elle envoie de manière asynchrone une petite quantité de données via HTTP à un serveur web. AppMeasurement peut utiliser la méthode navigator.sendBeacon() si la variable useBeacon est activée. Il est utile pour les liens de sortie et les autres situations où vous souhaitez envoyer des informations avant le déchargement de la page.

Si useBeacon est activé, l’accès suivant envoyé à Adobe utilise la méthode navigator.sendBeacon() du navigateur au lieu d’une demande d’image GET standard. Cette variable s’applique aux demandes d’image s.t() et aux demandes d’image s.tl(). Elle nécessite AppMeasurement 2.17.0 ou une version ultérieure.

TIP
AppMeasurement active automatiquement les demandes d’image de lien de sortie useBeacon.

La variable useBeacon est ignorée lorsque le visiteur utilise un navigateur qui ne prend pas en charge navigator.sendBeacon(). L’utilisation de cette variable nécessite AppMeasurement 2.16.0 ou une version ultérieure.

Utilisation de l’API sendBeacon à l’aide de l’extension SDK Web

La case à cocher Le document se décharge dans une configuration d’action détermine si les données envoyées à Adobe utilisent l’API sendBeacon.

  1. Connectez-vous à la 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 à l’onglet Rules , puis cliquez sur la règle de votre choix.
  4. Sous Actions, cliquez sur l’action souhaitée ou cliquez sur l’icône '+' pour ajouter une nouvelle action.
  5. Définissez la liste déroulante Extension sur SDK Web Adobe Experience Platform et le Type d’action sur Envoyer l’événement
  6. Cochez la case Le document se décharge à droite.

Si cette case est cochée, les données sont envoyées à l’Adobe à l’aide de l’API sendBeacon. Cette case est désactivée par défaut.

Utilisation de l’API sendBeacon pour implémenter manuellement le SDK Web

Définissez documentUnloading sur true lors de l’envoi d’un événement. Si elle n’est pas définie, sa valeur par défaut est false.

alloy("sendEvent", {
  "documentUnloading": true,
  "xdm": {}
});

Pour plus d’informations, voir Utilisation de l’API sendBeacon dans la documentation du SDK Web.

Utilisation de la balise à 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.useBeacon dans AppMeasurement et l’éditeur de code personnalisé de l’extension Analytics

La variable s.useBeacon est une valeur booléenne qui détermine si AppMeasurement utilise la méthode navigator.sendBeacon() du navigateur. Sa valeur par défaut est false. Définissez cette variable sur true avant d’appeler une fonction de suivi si vous souhaitez utiliser la nature asynchrone de navigator.sendBeacon().

s.useBeacon = true;
NOTE
Après l’exécution d’un appel de suivi, cette variable est réinitialisée sur false. Si votre mise en œuvre envoie plusieurs demandes d’image au même chargement de page (comme les applications d’une seule page), définissez cette variable sur true avant chaque appel de suivi.
Page précédentetrackOffline
Page suivanteuseLinkTrackSessionStorage

Analytics