On-device decisioning pour at.js

À partir de la version 2.5.0, at.js propose 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 afin d’effectuer une prise de décision en mémoire sans bloquer une requête réseau à l’Edge Network Adobe Target.

Target offre également la flexibilité de fournir l’expérience la plus pertinente et la plus à jour à partir de vos activités de personnalisation d’expérimentation et d’apprentissage automatique (pilotées par ML) via un appel serveur actif. En d’autres termes, lorsque les performances sont 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 on-device decisioning incluent :

Fonctionnalités prises en charge

Le SDK JS Adobe Target offre aux clients la possibilité de choisir entre les performances et l’actualisation des données pour les décisions. En d’autres termes, si la diffusion de contenu personnalisé le plus pertinent et attrayant par le biais de l’apprentissage automatique 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 que on-device decisioning fonctionne, reportez-vous à la liste des fonctionnalités prises en charge :

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

Comment fonctionne on-device decisioning ?

Lorsque vous déployez et initialisez at.js avec 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é à partir du réseau de diffusion de contenu Akamai le plus proche de votre visiteur et mis en cache localement sur le navigateur de votre visiteur. Lorsqu’une demande est envoyé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 de prise de décision comporte trois valeurs :

Côté serveur uniquement

Côté serveur uniquement, la méthode de prise de décision par défaut est configurée en standard lorsque at.js 2.5.0+ est implémenté et déployé sur vos propriétés web.

L’utilisation de la configuration côté serveur uniquement comme configuration par défaut signifie que toutes les décisions sont prises sur le réseau Edge Target, ce qui implique un appel au serveur de blocage. Cette approche peut introduire une latence incrémentielle, mais elle offre également des avantages significatifs, comme la possibilité d'appliquer les fonctionnalités d'apprentissage automatique de Target qui incluent les activités Recommendations, Automated Personalization (AP) et de 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 de puissants résultats pour votre entreprise.

Enfin, côté serveur, vous pouvez uniquement utiliser Adobe Experience Cloud et affiner les audiences qui peuvent être ciblées par le biais des segments d’Audience Manager et d’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 agrandir l’image en largeur réelle.)

La liste suivante correspond aux nombres du diagramme :

Sur 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 peut diffuser rapidement vos expériences et vos activités de personnalisation, car les décisions sont prises à partir d’un artefact de règles mis en cache qui contient toutes vos activités qui remplissent les critères de on-device decisioning.

Pour en savoir plus sur les activités admissibles pour 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 extrêmement critiques sur toutes les pages qui nécessitent des décisions de Target. De plus, 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 on-device decisioning ne seront pas 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 mises 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 de diffusion de contenu Akamai. Le réseau de diffusion de contenu 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 de diffusion de contenu 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 de blocage. Le diagramme de flux suivant capture les nouveaux visiteurs.

(Cliquez sur l’image pour agrandir l’image en largeur réelle.)

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 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 de page ou les visiteurs récurrents qui s’ensuivent.

(Cliquez sur l’image pour agrandir l’image en largeur réelle.)

La liste suivante correspond aux nombres du diagramme :

Hybride

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

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

L’artefact de règles JSON comprend des métadonnées pour indiquer à 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 exécutées via on-device decisioning et que pour les activités nécessitant 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 de diffusion de contenu Akamai et l’Edge Network Adobe Target d’un nouveau visiteur qui consulte votre page pour la première fois. Ce diagramme montre 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 garantit 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 la décision par la suite peuvent également avoir des effets négatifs sur la latence et peuvent être incohérents. Par conséquent, la méthode de prise de décision hybride est une recommandation recommandée pour toujours effectuer un appel côté serveur pour la décision d’un nouveau visiteur, car l’artefact de règles JSON est mis en cache en parallèle. Pour toutes les visites de page suivantes et les visites récurrentes, les décisions sont prises à partir du cache et en mémoire par le biais de l’artefact de règles JSON.

(Cliquez sur l’image pour agrandir l’image en largeur réelle.)

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 ou une visite de retour ultérieure. Dans ce diagramme, concentrez-vous uniquement sur le cas d’utilisation où une décision sur l’appareil est prise pour la navigation ou la visite récurrente de la page suivante. Gardez à l’esprit que, selon les activités actives 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 agrandir l’image en largeur réelle.)

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 2.5.0+.

Pour activer on-device decisioning :

Après avoir activé le bouton bascule de prise de décision sur l’appareil, Target commence à générer et à propager les 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, on-device uniquement et hybride. La méthode de prise de décision sélectionnée dans l’interface utilisateur Target est configurée dans window.targetGlobalSettings sous le champ decisioningMethod. En savoir plus sur 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 decisioningMethod dans window.targetGlobalSettings, mais souhaitez remplacer decisioningMethod pour chaque décision 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 comme artefact constitué de métadonnées, de règles et de conditions. Cet artefact est mis en cache sur le réseau de diffusion de contenu 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 suivantes sur votre site, le navigateur vérifie automatiquement s’il doit télécharger une version plus récente de l’artefact. Cette vérification ajoute une latence. La durée de vie (TTL) du cache des artefacts définit le nombre de minutes pendant lesquelles le navigateur ne doit pas rechercher 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, plus l’actualisation des données est importante, mais au prix d’une latence supplémentaire.

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

Une fois que vous avez créé une activité on-device decisioning éligible, un libellé qui indique Prise de décision sur l’appareil éligible est visible dans 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 on-device decisioning éligibles sur la page Activités via le filtre Éligible de prise de décision sur périphérique .

Résumé des étapes pour garantir que mes activités on-device decisioning sont diffusées via At.js 2.5.0+?