Utilisation Adobe Target et Web SDK personnalisation

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, 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:

Web SDK diagramme de système

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

Activation Adobe Target

Pour activer Target, procédez comme suit :

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

Utilisation du VEC d’Adobe Target

Pour utiliser le VEC avec une 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’ 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 Web SDK qui ne nécessitent pas XDM. Ces champs sont disponibles dans la variable Target IU qui ne nécessite 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. 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, puis extrayez 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 :

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

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

Au chargement de la page :

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

Mise à jour d’un profil unique

La variable Web SDK permet de mettre à jour le profil vers la fonction Target et au 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 :

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

Pour retarder l’enregistrement des attributs dans le profil jusqu’à ce que le contenu soit 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 la fonction __save indicateur défini sur false pour éviter de conserver la catégorie au moment de la demande de contenu. Une fois le contenu visualisé, envoyez la charge utile appropriée (y compris la variable eventToken et stateToken) pour les attributs correspondants à enregistrer.

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,
  data : {
    __adobe : {
      target : {
        "profile.gender" : "female",
        "profile.age" : 30,
        "entity.name" : "T-shirt" ,
        "entity.id" : "1234" ,
        "track": {
          "scopes": [ "mbox1", "mbox2"],
          "type": "display|click|..."
        }
      }
    }
  }
} ) ;

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’ Web SDK:

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 d’une méthode de Débogage du SDK Web au lieu de .

Terminologie

Propositions : Dans Adobe 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 Adobe Target.

Portée : Portée de la décision. Dans Adobe 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 Adobe Target comme paramètres mBox.