Utilisation de Adobe Target avec la balise Platform Web SDK

Adobe Experience Platform Web SDK peut fournir et générer des expériences personnalisées gérées dans Adobe Target sur le 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.

IMPORTANT

La documentation Adobe Target comprend des rubriques contenant des informations spécifiques au SDK Web Platform en ce qui concerne les fonctionnalités et fonctionnalités de Target.

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

Platform Web SDK diagramme de système

Le diagramme suivant vous aide à comprendre le processus de Target et de Platform Web SDK prise de décision en périphérie.

Diagramme de prise de décision Adobe Target Edge avec le SDK Web Platform

Appel Détails
1 L’appareil charge la balise Platform Web SDK. Platform Web SDK envoie une requête au réseau Edge avec des données XDM, l’identifiant d’environnement des flux de données, les paramètres transmis et l’identifiant du client (facultatif). La page (ou les conteneurs) est pré-masquée.
2 Le réseau Edge envoie la demande aux services Edge pour l’enrichir avec l’identifiant visiteur, le consentement et d’autres informations contextuelles sur le visiteur, telles que la géolocalisation et les noms conviviaux de l’appareil.
3 Le réseau Edge envoie la demande de personnalisation enrichie à la périphérie Target avec l’identifiant visiteur et les paramètres transmis.
4 Les scripts de profil s’exécutent, puis sont introduits dans le stockage des profils Target. Le stockage des profils récupère les segments de la bibliothèque d’audiences (par exemple, les segments partagés à partir de Adobe Analytics, Adobe Audience Manager, la Adobe Experience Platform).
5 Selon les paramètres de requête d’URL et les données de profil, Target détermine les activités et expériences à afficher pour le visiteur pour la page vue actuelle et pour les futures vues prérécupérées. Target renvoie ensuite à edge network.
6 a. Le réseau Edge renvoie la réponse de personnalisation à la page, y compris éventuellement les valeurs de profil pour une personnalisation supplémentaire. Le contenu personnalisé sur la page active est affiché aussi rapidement que possible sans scintillement du contenu par défaut.
b. Le contenu personnalisé pour les vues affichées à la suite d’actions de l’utilisateur dans une application d’une seule page (SPA) est mis en cache afin de pouvoir être appliqué instantanément sans appel au serveur supplémentaire lorsque les vues sont déclenchées.
c. Le réseau Edge envoie l’identifiant visiteur et d’autres valeurs dans les cookies, telles que le consentement, l’ID de session, l’identité, la vérification de cookies, la personnalisation, etc.
7 Le réseau Edge transfère Analytics for Target (A4T) les détails (métadonnées d’activité, d’expérience et de conversion) vers le serveur Analytics Edge.

Activation de Adobe Target

Pour activer Target, procédez comme suit :

  1. Activez Target dans votre flux de données avec le code client approprié.
  2. Ajoutez l’option renderDecisions à vos événements.

Vous pouvez ensuite, éventuellement, ajouter les options suivantes :

  • decisionScopes: Récupérez des activités spécifiques (utiles pour les activités créées avec le compositeur basé sur les formulaires) en ajoutant cette option à vos événements.
  • Fragment de prémasquage : Masquez uniquement certaines parties de la page.

Utilisation du VEC d’Adobe Target

Pour utiliser le compositeur d’expérience visuelle avec une mise en oeuvre Platform Web SDK, installez et activez Firefox ou Chrome l’extension d’assistance du compositeur d’expérience visuelle.

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

Rendu du contenu personnalisé

Voir Rendu du contenu de personnalisation pour plus d’informations.

Audiences dans XDM

Lors de la définition d’audiences pour vos activités Target diffusées via Platform Web SDK, XDM doit être défini et utilisé. Après avoir défini les schémas XDM, les classes et les groupes de champs de schéma, 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 Audience Builder en tant que paramètre personnalisé. Le XDM est sérialisé à l’aide de la notation par points (par exemple, web.webPageDetails.name).

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

  • Bibliothèque Target
  • Géo
  • Réseau
  • Operating System
  • Pages du site
  • Navigateur
  • Sources de trafic
  • Période

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

Jetons de réponse

Les jetons de réponse sont principalement utilisés pour envoyer des métadonnées à des tiers tels que Google, Facebook, etc. Les 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 à la promesse alloy.sendEvent, effectuer une itération sur propositions
et extrayez les détails à partir de items -> meta. Chaque proposition a un champ booléen renderAttempted
indiquant si proposition a été rendu ou non. Consultez 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 de propositions contient :

Au chargement de la page :

  • Compositeur d’après les formulaires basé sur propositions avec indicateur renderAttempted défini sur false
  • Propositions basées sur le compositeur d’expérience visuelle avec l’indicateur renderAttempted défini sur true
  • Propositions basées sur le compositeur d’expérience visuelle pour une vue d’application d’une seule page avec l’indicateur renderAttempted défini sur true

On View - change (pour les vues en mémoire cache) :

  • Propositions basées sur le compositeur d’expérience visuelle pour une vue d’application d’une seule page avec l’indicateur renderAttempted défini sur true

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

Au chargement de la page :

  • Compositeur d’après les formulaires basé sur propositions avec indicateur renderAttempted défini sur false
  • Propositions basées sur le compositeur d’expérience visuelle avec l’indicateur renderAttempted défini sur false
  • Propositions basées sur le compositeur d’expérience visuelle pour une vue d’application d’une seule page avec l’indicateur renderAttempted défini sur false

On View - change (pour les vues en mémoire cache) :

  • Propositions basées sur le compositeur d’expérience visuelle pour une vue d’application d’une seule page avec l’indicateur renderAttempted défini sur false

Mise à jour d’un profil unique

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

Pour mettre à jour un profil Target, vérifiez que les données de profil sont transmises avec les éléments suivants :

  • Sous “data {“
  • Sous “__adobe.target”
  • Préfixe “profile.” par exemple, comme ci-dessous
Clé Type Description
renderDecisions Booléen Indique au composant de personnalisation s’il doit interpréter les actions DOM.
decisionScopes Tableau <String> Liste des portées pour lesquelles récupérer les décisions
xdm Objet Données formatées dans XDM qui se trouvent dans le SDK Web Platform en tant qu’événement d’expérience
data Objet Paires clé/valeur arbitraires envoyées aux solutions Target sous la classe cible.

Le code Platform Web SDK type utilisant cette commande ressemble à ce qui suit :

sendEventavec données de profil

alloy("sendEvent", {
   renderDecisions: true|false,
   xdm: { // Experience Event XDM data },
   data: { // Freeform data }
});

Comment envoyer des attributs de profil à Adobe Target :

alloy("sendEvent", {
  renderDecisions: true,
  data: {
    __adobe: {
      target: {
        "profile.gender": "female",
        "profile.age": 30
      }
    }
  }
});

Demande de recommandations

Le tableau suivant répertorie les attributs Recommendations et indique si chacun est pris en charge via Platform Web SDK :

Catégorie Attribut État de la prise en charge
Recommendations - Attributs d’entité par défaut entity.id Pris en charge
entity.name Pris en charge
entity.categoryId Pris en charge
entity.pageUrl Pris en charge
entity.thumbnailUrl Pris en charge
entity.message Pris en charge
entity.value Pris en charge
entity.inventory Pris en charge
entity.brand Pris en charge
entity.margin Pris en charge
entity.event.detailsOnly Pris en charge
Recommendations - Attributs d’entité personnalisés entity.yourCustomAttributeName Pris en charge
Recommendations : paramètres de mbox/page réservés excludedIds Pris en charge
cartIds Pris en charge
productPurchasedId Pris en charge
Page ou catégorie d’élément pour les affinités catégorielles user.categoryId Pris en charge

Comment envoyer des attributs Recommendations à Adobe Target :

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

Débogage

mboxTrace et mboxDebug ont été abandonnés. Utilisez Platform Web SDK le débogage.

Terminologie

Propositions : dans Target, les propositions correspondent à l’expérience sélectionnée dans une activité.

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

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

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

Sur cette page