Utilisation Adobe Target avec le 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 au canal web. Vous pouvez utiliser un éditeur WYSIWYG, appelé Compositeur d’expérience visuelle (VEC), ou une interface non visuelle, la variable Compositeur d’expérience d’après les formulaires, pour créer, activer et diffuser vos activités et expériences de personnalisation.

IMPORTANT

Le Documentation Adobe Target comprend des rubriques contenant des informations spécifiques au SDK Web de 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 workflow de Target et Platform Web SDK prise de décision Edge.

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

Appel Détails
1 L’appareil charge la variable Platform Web SDK. Le 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 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 au Target Edge avec l’identifiant visiteur et les paramètres transmis.
4 Les scripts de profil s’exécutent, puis sont introduits dans Target stockage des profils. Le stockage des profils récupère les segments du Bibliothèque d’audiences (par exemple, les segments partagés à partir de Adobe Analytics, Adobe Audience Manager, la variable Adobe Experience Platform).
5 En fonction des paramètres de requête d’URL et des 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 En amont du réseau Edge Analytics pour Target (A4T) des détails (métadonnées d’activité, d’expérience et de conversion) sur la variable Analytics edge.

Activation Adobe Target

Pour activer Target, procédez comme suit :

  1. Activer Target dans votre datastream avec le code client approprié.
  2. Ajoutez la variable 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 d’après les formulaires) en ajoutant cette option à vos événements.
  • Prémasquer le fragment de code: Masquez uniquement certaines parties de la page.

Utilisation du VEC d’Adobe Target

Pour utiliser le compositeur d’expérience visuelle avec une Platform Web SDK implémentation, installez et activez l’une des options suivantes : Firefox ou Chrome 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 votre Target les activités diffusées via l’ Platform Web SDK, XDM doit être définie et utilisée. Après avoir défini des schémas XDM, des classes et des groupes de champs de schéma, vous pouvez créer un Target règle d’audience définie par les données XDM pour le ciblage. Within Target, les données XDM s’affichent dans la variable Audience Builder comme paramètre personnalisé. Le XDM est sérialisé à l’aide de la notation par points (par exemple, web.webPageDetails.name).

Si vous avez Target les activités avec des audiences prédéfinies qui utilisent des paramètres personnalisés ou un profil utilisateur 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. Toutefois, des champs de ciblage d’audience d’usine sont pris en charge via le Platform Web SDK qui ne nécessitent pas XDM. Ces champs sont disponibles dans la variable Target IU 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 la variable meta champ 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, itérer propositions
et extraire les détails de items -> meta. Chaque proposition a une renderAttempted champ booléen indiquant si la variable 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 propositions avec renderAttempted indicateur défini sur false
  • Propositions basées sur le compositeur d’expérience visuelle avec renderAttempted indicateur défini sur true
  • Propositions basées sur le compositeur d’expérience visuelle pour une application d’une seule page avec renderAttempted indicateur 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 application d’une seule page avec renderAttempted indicateur 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 propositions avec renderAttempted indicateur défini sur false
  • Propositions basées sur le compositeur d’expérience visuelle avec renderAttempted indicateur défini sur false
  • Propositions basées sur le compositeur d’expérience visuelle pour une application d’une seule page avec renderAttempted indicateur 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 application d’une seule page avec renderAttempted indicateur défini sur false

Mise à jour d’un profil unique

Le Platform Web SDK permet de mettre à jour le profil vers la fonction Target et au Platform Web SDK comme événement d’expérience.

Pour mettre à jour une Target , assurez-vous 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 à Target solutions sous la classe cible.

Typique Platform Web SDK Le code 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 Recommendations les attributs et si chacun d’eux est pris en charge via l’ 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. Utilisation Platform Web SDK 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 : Portée de la décision. Dans Target, la portée est la mBox. La mBox globale est la __view__ portée.

XDM : Le XDM est sérialisé en notation par points, puis placé dans Target comme paramètres mBox.

Sur cette page