On-device decisioning pour at.js

À partir de la version 2.5.0, at.js offre on-device decisioning. On-device decisioning vous permet de mettre en cache vos activités Test A/B et Ciblage d’expérience (XT) sur le navigateur pour prendre des décisions en mémoire sans bloquer la requête réseau à Adobe Target Edge Network.

Target offre également la flexibilité de fournir l’expérience la plus pertinente et la plus récente à partir de vos activités d’expérimentation et de personnalisation pilotées par le machine learning (pilotées par ML) via un appel au serveur en direct. En d’autres termes, lorsque les performances sont les plus importantes, vous pouvez choisir d’utiliser on-device decisioning. Cependant, lorsque l’expérience la plus pertinente, à jour et pilotée par ML est nécessaire, un appel au serveur peut être effectué à la place.

Quels sont les avantages de on-device decisioning ?

Les avantages de la on-device decisioning sont les suivants :

Fonctionnalités prises en charge

Le SDK JS Adobe Target offre aux clients et aux clientes la possibilité de choisir entre les performances et la fraîcheur des données pour les décisions. En d’autres termes, si la diffusion du contenu personnalisé le plus pertinent et le plus attrayant via le machine learning est la plus importante pour vous, un appel au serveur en direct doit être effectué. Mais lorsque les performances sont plus critiques, une décision doit être prise sur l’appareil et en mémoire. Pour on-device decisioning à fonctionner, reportez-vous à la liste des fonctionnalités prises en charge :

Pour plus d’informations, voir Fonctionnalités prises en charge par on-device decisioning.

Comment on-device decisioning agit-il ?

Lorsque vous déployez et initialisez at.js avec le on-device decisioning activé, un artefact de règle qui inclut votre on-device decisioning pour les activités A/B et XT, les audiences et les ressources, est téléchargé du réseau CDN Akamai le plus proche du visiteur et mis en cache localement sur le navigateur de ce dernier. Lorsqu’une requête est effectuée à partir d’at.js pour récupérer une expérience, la décision concernant l’expérience à renvoyer est prise en mémoire, en fonction des métadonnées codées dans l’artefact de règle mis en cache.

Méthode de prise de décision

Avec on-device decisioning, Target introduit un nouveau paramètre appelé Méthode de prise de décision. Le paramètre Méthode de prise de décision détermine la manière dont at.js diffuse vos expériences. La méthode Decisioning possède trois valeurs :

Côté serveur uniquement

Côté serveur uniquement est la méthode de prise de décision par défaut préconfigurée lors de l’implémentation et du déploiement d’at.js 2.5.0+ sur vos propriétés web.

L’utilisation de Côté serveur uniquement comme configuration par défaut signifie que toutes les décisions sont prises sur le réseau Edge de Target, ce qui implique un appel au serveur bloquant. Cette approche peut entraîner une latence incrémentielle, mais elle offre également des avantages significatifs, comme la possibilité d’appliquer les fonctionnalités de machine learning de Target qui incluent les activités Recommendations, Automated Personalization (AP) et Ciblage automatique.

En outre, l’amélioration de vos expériences personnalisées à l’aide du profil utilisateur de Target, qui est persistant entre les sessions et les canaux, peut fournir des résultats performants pour votre entreprise.

Enfin, la valeur côté serveur uniquement vous permet d’utiliser Adobe Experience Cloud et d’affiner les audiences qui peuvent être ciblées par le biais des segments Audience Manager et Adobe Analytics.

Le diagramme suivant illustre l’interaction entre votre visiteur, le navigateur, at.js 2.5.0+ et le réseau Edge Adobe Target. Ce diagramme de flux capture les nouveaux visiteurs et les visiteurs récurrents.

(Cliquez sur l’image pour l’agrandir sur toute la largeur.)

{modal="regular"}

La liste suivante correspond aux nombres du diagramme :

Sur l’appareil uniquement

Sur l’appareil uniquement est la méthode de prise de décision qui doit être définie dans at.js 2.5.0+ lorsque on-device decisioning doit être utilisé uniquement sur l’ensemble de vos pages web.

On-device decisioning pouvez diffuser vos expériences et vos activités de personnalisation à une vitesse incroyablement rapide, car les décisions sont prises à partir d’un artefact de règles mis en cache qui contient toutes vos activités remplissant les critères de l’on-device decisioning.

Pour en savoir plus sur les activités qui remplissent les critères de l’on-device decisioning, voir Fonctionnalités prises en charge dans on-device decisioning.

Cette méthode de prise de décision ne doit être utilisée que si les performances sont très critiques sur toutes les pages qui nécessitent des décisions de la part de Target. En outre, gardez à l’esprit que lorsque cette méthode de prise de décision est sélectionnée, vos activités Target qui ne remplissent pas les critères pour la on-device decisioning ne seront ni diffusées ni exécutées. La bibliothèque at.js version 2.5.0+ est configurée pour rechercher uniquement l’artefact de règles mis en cache afin de prendre des décisions.

Le diagramme suivant illustre l’interaction entre votre visiteur, le navigateur, at.js 2.5.0+ et le réseau CDN Akamai. Le réseau CDN Akamai met en cache l’artefact de règles pour la première visite du visiteur. Pour la première visite de page d’un nouveau visiteur, l’artefact de règles JSON doit être téléchargé à partir du réseau CDN Akamai pour être mis en cache localement sur le navigateur du visiteur. Une fois l’artefact de règles JSON téléchargé, la décision est prise immédiatement sans appel réseau bloquant. Le diagramme de flux suivant capture les nouveaux visiteurs.

(Cliquez sur l’image pour l’agrandir sur toute la largeur.)

{modal="regular"}

La liste suivante correspond aux nombres du diagramme :

Le diagramme suivant illustre l’interaction entre votre visiteur, le navigateur, at.js 2.5.0+ et l’artefact de règle JSON mis en cache pour l’accès à la page suivant ou la visite récurrente du visiteur. Comme l’artefact de règles JSON est déjà mis en cache et disponible sur le navigateur, la décision est prise immédiatement sans appel réseau bloquant. Ce diagramme de flux capture la navigation ultérieure dans la page pour les visiteurs récurrents.

(Cliquez sur l’image pour l’agrandir sur toute la largeur.)

{modal="regular"}

La liste suivante correspond aux nombres du diagramme :

Hybride

Hybride représente la méthode de prise de décision qui doit être définie dans at.js 2.5.0+ lorsque les on-device decisioning et les activités nécessitant un appel réseau au réseau Edge Adobe Target doivent être exécutées.

Lorsque vous gérez des activités on-device decisioning et des activités côté serveur, il peut s’avérer un peu compliqué et fastidieux de réfléchir à la manière de déployer et de configurer des Target sur vos pages. Avec la méthode de prise de décision hybride, Target sait quand il doit effectuer un appel au serveur vers le réseau Edge Adobe Target pour les activités qui nécessitent une exécution côté serveur. Il sait également quand exécuter uniquement les décisions sur l’appareil.

L’artefact de règles JSON comprend des métadonnées qui indiquent à at.js si une mbox comporte une activité côté serveur en cours d’exécution ou une activité on-device decisioning. Cette méthode de prise de décision garantit que les activités que vous prévoyez de diffuser rapidement sont effectuées par le biais de on-device decisioning. Pour les activités qui nécessitent une personnalisation plus puissante pilotée par ML, ces activités sont effectuées via le réseau Edge Adobe Target.

Le diagramme suivant illustre l’interaction entre votre visiteur, le navigateur, at.js 2.5.0+, le réseau CDN Akamai et Adobe Target Edge Network pour un nouveau visiteur qui visite votre page pour la première fois. Ce qu’il faut retenir de ce diagramme, c’est que l’artefact de règles JSON est téléchargé de manière asynchrone pendant que les décisions sont prises via le réseau Edge Adobe Target.

Cette approche permet de s’assurer que la taille de l’artefact, qui peut inclure de nombreuses activités, n’influence pas négativement la latence de la décision. Le téléchargement synchrone de l’artefact de règles JSON et la prise de décision par la suite peuvent également avoir des effets indésirables sur la latence et peuvent être incohérents. Par conséquent, la méthode de prise de décision hybride est une recommandation de bonne pratique consistant à toujours effectuer un appel côté serveur pour la décision pour un nouveau visiteur, et comme l’artefact de règles JSON est mis en cache en parallèle. Pour les visites de page et les visites récurrentes suivantes, les décisions sont prises à partir du cache et en mémoire via l’artefact de règles JSON.

(Cliquez sur l’image pour l’agrandir sur toute la largeur.)

{modal="regular"}

La liste suivante correspond aux nombres du diagramme :

Le diagramme suivant illustre l’interaction entre votre visiteur, le navigateur, at.js 2.5.0+ et l’artefact de règles JSON mis en cache pour une navigation de page ultérieure ou une visite récurrente. Dans ce diagramme, concentrez-vous uniquement sur le cas d’utilisation dans lequel une décision sur l’appareil est prise pour la navigation ultérieure sur la page ou la visite de retour. Gardez à l’esprit que, selon les activités qui sont en ligne pour certaines pages, un appel côté serveur peut être effectué pour exécuter des décisions côté serveur.

(Cliquez sur l’image pour l’agrandir sur toute la largeur.)

{modal="regular"}

La liste suivante correspond aux nombres du diagramme :

Comment activer on-device decisioning ?

On-device decisioning est disponible pour tous les clients Target qui utilisent At.js version 2.5.0 ou ultérieure.

Pour activer on-device decisioning :

Après avoir activé le bouton (bascule) Prise de décision sur l’appareil, Target commence à générer et à propager des artefacts de règle pour votre client.

Comment configurer at.js 2.5.0+ pour utiliser on-device decisioning ?

Paramètres globaux

Vous pouvez configurer une méthode de prise de décision par défaut pour toutes les décisions Target. Les différentes méthodes de prise de décision sont Côté serveur uniquement, Sur l’appareil uniquement et Hybride. La méthode de prise de décision sélectionnée dans l’interface utilisateur de Target est configurée dans window.targetGlobalSettings sous le champ decisioningMethod . En savoir plus sur les decisioningMethod dans targetGlobalSettings().

<head>
    <script type="text/javascript">

        window.targetGlobalSettings = {
            clientCode: "yourClientCodeHere",
            imsOrgId: "imsOrgId@AdobeOrg",
            decisioningMethod: "on-device"

        };
    </script>

    <script type="text/javascript" src="at.js"></script>
</head>

Paramètre personnalisé

Si vous définissez la decisioningMethod dans window.targetGlobalSettings, mais souhaitez remplacer le decisioningMethod de chaque décision de Adobe Target en fonction de votre cas d’utilisation, vous pouvez effectuer cette procédure en spécifiant decisioningMethod dans l’appel getOffers() d’At.js2.5.0+.

adobe.target.getOffers({

  decisioningMethod:"on-device",
  request: {
    execute: {
      mboxes: [
        {
          index: 0,
          name: "homepage"
        }
      ]
    }
 }
});

TTL du cache d’artefacts

Target représente vos activités qui remplissent les critères de on-device decisioning en tant qu’artefact composé de métadonnées, de règles et de conditions. Cet artefact est mis en cache sur le réseau CDN Akamai. Lors de la première visite de votre utilisateur, le navigateur de l’utilisateur télécharge et met en cache l’artefact qui représente vos activités on-device decisioning.

Lors des visites ultérieures de votre site, le navigateur vérifie automatiquement s’il doit télécharger une version plus récente de l’artefact. Ce contrôle ajoute de la latence. La durée de vie du cache d’artefacts définit le nombre de minutes pendant lesquelles vous ne souhaitez pas que le navigateur recherche un artefact mis à jour depuis le dernier téléchargement réussi. Plus la période est longue, meilleures sont les performances. Plus la période est courte, meilleure est la fraîcheur des données, mais au prix d’une latence supplémentaire.

Comment savoir si une activité est on-device decisioning éligible ?

Après avoir créé une activité on-device decisioning éligible, un libellé lisant Éligible pour la prise de décision sur l’appareil s’affiche sur la page Aperçu de l’activité.

Ce libellé ne signifie pas que l’activité sera toujours diffusée via on-device decisioning. Cette activité ne sera exécutée sur l’appareil que lorsque at.js 2.5.0+ est configuré pour utiliser on-device decisioning. Si at.js 2.5.0+ n’est pas configuré pour utiliser sur l’appareil, cette activité sera toujours diffusée via un appel au serveur effectué à partir d’at.js.

Vous pouvez filtrer toutes les activités qui sont on-device decisioning éligibles sur la page Activités à l’aide du filtre Éligible pour la prise de décision sur l’appareil .

Résumé des étapes permettant de s’assurer que mes activités on-device decisioning sont diffusées via At.js 2.5.0+?