Utilisation de Adobe Target et Web SDK pour la personnalisation

Adobe Experience Platform Web SDK peut diffuser et générer des expériences personnalisées gérées dans Adobe Target au canal web. Vous pouvez utiliser un éditeur WYSIWYG, appelé Compositeur d’expérience visuelle (VEC), ou une interface non visuelle, le Compositeur d’expérience d’après les formulaires, pour créer, activer et diffuser vos activités et expériences de personnalisation.

Les fonctionnalités suivantes ont été testées et sont actuellement prises en charge dans Target :

Diagramme système Web SDK

Le diagramme suivant vous aide à comprendre le workflow de la prise de décision Target et Web SDK Edge.

Activation de Adobe Target

Pour Target activer, procédez comme suit :

Vous pouvez ensuite éventuellement ajouter les options suivantes :

Utilisation du VEC d’Adobe Target

Pour utiliser le VEC avec une implémentation Web SDK, installez et activez l’extension d’assistance du VEC Firefox ou Chrome.

Pour plus d’informations, voir Extension d’assistance du compositeur d’expérience visuelle dans le guide Adobe Target.

Rendu du contenu personnalisé

Pour plus d’informations, consultez Rendu de contenu de personnalisation.

Audiences dans XDM

Lors de la définition des audiences pour vos activités Target diffusées via le Web SDK, XDM doit être défini et utilisé. Après avoir défini des schémas, des classes et des groupes de champs de schéma XDM, vous pouvez créer une règle d’audience Target définie par les données XDM pour le ciblage. Dans Target, les données XDM s’affichent dans le Audience Builder sous la forme d’un paramètre personnalisé. Le fichier XDM est sérialisé à l’aide de la notation par points (par exemple, web.webPageDetails.name).

Si vous disposez d’activités Target avec des audiences prédéfinies qui utilisent des paramètres personnalisés ou un profil utilisateur, elles ne sont pas correctement diffusées via le SDK. Au lieu d’utiliser des paramètres personnalisés pour le profil utilisateur, vous devez utiliser XDM. Cependant, il existe des champs de ciblage d’audience prêts à l’emploi pris en charge via le Web SDK qui ne nécessitent pas XDM. Ces champs sont disponibles dans l’interface utilisateur de Target qui ne nécessitent pas XDM :

Pour plus d’informations, voir Catégories d’audiences dans le guide Adobe Target.

Jetons de réponse

Les jetons de réponse sont utilisés pour envoyer des métadonnées à des tiers tels que Google ou Facebook. Des jetons de réponse sont renvoyés.
dans le champ meta dans propositions -> items. Voici un exemple :

{
  "id": "AT:eyJhY3Rpdml0eUlkIjoiMTI2NzM2IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
  "scope": "__view__",
  "scopeDetails": ...,
  "renderAttempted": true,
  "items": [
    {
      "id": "0",
      "schema": "https://ns.adobe.com/personalization/dom-action",
      "meta": {
        "experience.id": "0",
        "activity.id": "126736",
        "offer.name": "Default Content",
        "offer.id": "0"
      }
    }
  ]
}

Pour collecter les jetons de réponse, vous devez vous abonner à alloy.sendEvent promesse, effectuer une itération sur propositions et extraire les détails de items -> meta.

Chaque proposition comporte un champ booléen renderAttempted indiquant si le proposition a été rendu ou non. Voir l’exemple ci-dessous :

alloy("sendEvent",
  {
    "renderDecisions": true,
    "decisionScopes": [
      "hero-container"
    ]
  }).then(result => {
    const { propositions } = result;

    // filter rendered propositions
    const renderedPropositions = propositions.filter(proposition => proposition.renderAttempted === true);

    // collect the item metadata that represents the response tokens
    const collectMetaData = (items) => {
      return items.filter(item => item.meta !== undefined).map(item => item.meta);
    }

    const pageLoadResponseTokens = renderedPropositions
      .map(proposition => collectMetaData(proposition.items))
      .filter(e => e.length > 0)
      .flatMap(e => e);
  });

Lorsque le rendu automatique est activé, le tableau des propositions contient :

Au chargement de la page :

En mode Modification (pour les vues mises en cache) :

Lorsque le rendu automatique est désactivé, le tableau des propositions contient :

Au chargement de la page :

En mode Modification (pour les vues mises en cache) :

Mise à jour de profil individuel

L’Web SDK vous permet de mettre à jour le profil vers le profil Target et vers le Web SDK en tant qu’événement d’expérience.

Pour mettre à jour un profil de Target, assurez-vous que les données du profil sont transmises avec les éléments suivants :

Retarder l’enregistrement des paramètres de profil ou d’entité jusqu’à ce que le contenu ait été affiché à l’utilisateur final

Pour retarder l’enregistrement des attributs dans le profil jusqu’à ce que le contenu ait été affiché, définissez data.adobe.target._save=false dans votre requête.

Par exemple, votre site web contient trois portées de décision correspondant à trois liens de catégorie sur le site web (hommes, femmes et enfants) et vous souhaitez effectuer le suivi de la catégorie que l’utilisateur a finalement visitée. Envoyez ces requêtes avec l’indicateur de __save défini sur false pour éviter de conserver la catégorie au moment où le contenu est demandé. Une fois le contenu visualisé, envoyez la payload appropriée (y compris les eventToken et les stateToken) pour que les attributs correspondants soient enregistrés.

L’exemple ci-dessous envoie un message de style trackEvent, exécute des scripts de profil, enregistre des attributs et enregistre immédiatement l’événement.

alloy("sendEvent", {
    "renderDecisions": true,
    "xdm": { /* Experience Event XDM data */ },
    "data": {
        "__adobe": {
            "target": {
                " __save": true|false,
                //defaults to true if omitted
                "profile.gender": "female",
                "profile.age": 30,
                "entity.name": "T-shirt",
                "entity.id": "1234"
            }
        }
    }
})

Recommandations de requêtes

Le tableau suivant répertorie Recommendations attributs et indique si chacun est pris en charge par le biais du Web SDK :

Comment envoyer des attributs Recommendations à Adobe Target :

alloy("sendEvent", {
  "renderDecisions": true,
  "data": {
    "__adobe": {
      "target": {
        "entity.id": "123",
        "entity.genre": "Drama"
      }
    }
  }
});

Affichage des mesures de conversion de mbox display-mbox-conversion-metrics

L’exemple ci-dessous montre comment vous pouvez effectuer le suivi des conversions de mbox d’affichage et envoyer des paramètres de profil à Adobe Target, sans avoir à qualifier de contenu ou d’activité.

alloy("sendEvent", {
    "xdm": {
        "_experience": {
            "decisioning": {
                "propositions": [{
                    "scope": "conversion-step-1" //example scope name
                }],
                "propositionEventType": {
                    "display": 1
                }
            }
        },
        "eventType": "decisioning.propositionDisplay"
    }
});

Débogage

mboxTrace et mboxDebug ont été rendus obsolètes. Utilisez plutôt une méthode de débogage Web SDK.

Terminologie

Propositions : dans Adobe Target, les propositions sont corrélées à l’expérience sélectionnée dans une activité.

Schéma : le schéma d’une décision est le type d’offre dans Adobe Target.

Portée : portée de la décision. En Adobe Target, la portée est la mBox. La mBox globale est la portée __view__.

XDM: le XDM est sérialisé en notation par points, puis placé dans Adobe Target en tant que paramètres mBox.