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.

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

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 automatique des activités du VEC

La fonction Adobe Experience Platform Web SDK peut rendre automatiquement vos expériences définies via le compositeur d’expérience visuelle de Adobe Target sur le web pour vos utilisateurs. Pour indiquer à Experience Platform Web SDK d’effectuer le rendu automatique des activités du VEC, envoyez un événement avec renderDecisions = true :

alloy
("sendEvent", 
  { 
  "renderDecisions": true, 
  "xdm": {
    "commerce": { 
      "order": {
        "purchaseID": "a8g784hjq1mnp3", 
         "purchaseOrderNumber": "VAU3123", 
         "currencyCode": "USD", 
         "priceTotal": 999.98 
         } 
      } 
    }
  }
);

Utilisation du compositeur d’après les formulaires

Le compositeur d’expérience d’après les formulaires est une interface non visuelle utile pour configurer les tests A/B, ciblage d’expérience, Automated Personalization et les activités Recommendations avec différents types de réponse, tels que JSON, HTML, etc. Selon le type de réponse ou la décision renvoyé par Target, votre logique métier principale peut être exécutée. Pour récupérer les décisions pour vos activités de compositeur d’après les formulaires, envoyez un événement avec tous les "périmètres de décision" pour lesquels vous souhaitez récupérer une décision.

alloy
  ("sendEvent", { 
    decisionScopes: [
      "foo", "bar"], 
      "xdm": {
        "commerce": { 
          "order": { 
            "purchaseID": "a8g784hjq1mnp3", 
            "purchaseOrderNumber": "VAU3123", 
            "currencyCode": "USD", 
            "priceTotal": 999.98 
          } 
        } 
      } 
    }
  );

Portées de décision

decisionScopes définissez des sections, des emplacements ou des parties de vos pages dans lesquelles vous souhaitez effectuer le rendu d’une expérience personnalisée. Ces decisionScopes sont personnalisables et définies par l’utilisateur. Pour les clients [!DNL Target] actuels, decisionScopes sont également appelés "mbox". Dans l’interface utilisateur [!DNL Target], decisionScopes apparaît comme "emplacements".

Portée __view__

Experience Platform Web SDK fournit la fonctionnalité permettant de récupérer les actions du VEC sans compter sur le SDK pour effectuer le rendu des actions du VEC pour vous. Envoyez un événement avec __view__ défini comme decisionScopes.

alloy("sendEvent", {
      "decisionScopes": ["__view__", "foo", "bar"], 
      "xdm": { 
        "web": { 
          "webPageDetails": { 
            "name": "Home Page"
          }
        } 
      }
    }
  ).then(function(results) {
    for (decision of results.decisions) {
      if (decision.decisionScope === "__view__") {
        console.log(decision.content)
      }
    }
  });

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
  • Browser
  • Sources de trafic
  • Période

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

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 stuff (event & profile) }
});

Exemple de code

alloy("sendEvent", {
  renderDecisions: true,
  xdm: {
    device: {
      screenWidth: 9999
    }
  },
  data: {
    __adobe: {
      target: {
        "profile.gender": "female",
        "profile.age": 30,
	"entity.id" : "123",
	"entity.genre" : "Drama"
      }
    }
  }
}) 
.then(console.log);

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

Débogage

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

Terminologie

Décisions : dans Target, les décisions sont corrélées à l’expérience sélectionnée à partir d’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