DocumentationExperience PlatformGuide du SDK web

Utilisation de Adobe Journey Optimizer avec le Experience Platform Web SDK

Dernière mise à jour : 5 mai 2025
  • Rubriques :

Créé pour :

  • Développeur

Adobe Experience Platform Web SDK peut diffuser et générer des expériences personnalisées gérées dans Adobe Journey Optimizer au canal web. Vous pouvez utiliser un éditeur WYSIWYG, Adobe Journey Optimizer canal web ou une interface non visuelle, le canal d’expérience basé sur le code pour créer, activer et diffuser vos campagnes Journey Optimizer Web et expériences de personnalisation.

IMPORTANT
Lisez la Documentation du canal web Adobe Journey Optimizer pour plus d’informations sur la prise en main de la création et du reporting d’expérience Journey Optimizer Web.

Terminologie

Surface : une surface web est une page web ou un emplacement sur une page identifiée par un URI où le contenu de l’expérience Adobe Journey Optimizer sera diffusé.

Propositions : dans Adobe Journey Optimizer, les propositions sont corrélées à l’expérience sélectionnée dans un Journey Optimizer Campaign.

Activation de Adobe Journey Optimizer

Pour commencer à utiliser Adobe Journey Optimizer, procédez comme suit.

  1. Parcourez les conditions préalables du Adobe Journey Optimizer Guide des expériences web, en particulier :

    • Configurez des Adobe Experience Cloud Visual Editing Helper.
    • Activez la Adobe Journey Optimizer dans votre flux de données.
    • Activez l’option ​ Politique de fusion Active-On-Edge ​.
  2. Ajoutez l’option renderDecisions à vos événements. Définissez renderDecisions sur true pour le rendu automatique des propositions de contenu Journey Optimizer diffusées sur les surfaces de vos pages web.

    alloy("sendEvent", {
        ...,
        "renderDecisions": true
    })
    
  3. Vous pouvez éventuellement spécifier des surfaces supplémentaires dans vos événements. Par défaut, le Web SDK génère automatiquement la surface web de la page web active et l’inclut dans la requête envoyée à Edge Network. Si nécessaire, des surfaces supplémentaires peuvent être incluses dans la requête en les spécifiant dans l’option personalization.surfaces de la commande sendEvent ou dans la configuration correspondante Surfaces Événement d’envoi de l’action de l’extension Web SDK.

    alloy("sendEvent", {
        ...
        "personalization": {
            "surfaces": [ "web://my.site.com/about.html", "web://my.site.com/contact.html" ]
        }
    })
    

    extension-add-surface

    Les surfaces d’événement sont incluses dans le champ de requête query.personalization.surfaces :

    {
    "events": [
        {
            "query": {
                "personalization": {
                "schemas": [
                    ...
                ],
                "decisionScopes": [
                    "__view__"
                ],
                "surfaces": [
                    "web://ajostage.weebly.com/"
                ]
                }
            },
            ...
        }
    ]
    }
    
  4. Comme pour d’autres fonctionnalités de personnalisation, vous pouvez ajouter un fragment de code de masquage préalable pour ne masquer que certaines parties de la page lors de la récupération d’expériences.

Création d’expériences web Adobe Journey Optimizer

Suivez les instructions création de campagnes web du Adobe Journey Optimizer Guide des expériences web pour créer des campagnes et des expériences Journey Optimizer Web.

Rendu du contenu personnalisé

Pour plus d’informations, consultez la documentation sur le rendu de contenu de personnalisation.

Les propositions Adobe Journey Optimizer pour les surfaces web sont traitées de la même manière que les propositions de portée de décision __view__. Plus précisément, lorsque renderDecisions option est définie sur true dans la commande sendEvent, elle est automatiquement rendue par le SDK Web.

Exemple de proposition de contenu Journey Optimizer :

{
    "scope": "web://ajostage.weebly.com/",
    "scopeDetails": {
        "correlationID": "ccfaf19c-6360-4aea-b464-0cf924db5da7",
        "characteristics": {
            "eventToken": "eyJtZXNzYWdlRXhlY3V0aW9uIjp7Im1lc3NhZ2VFeGVjdXRpb25JRCI6ImEzNDYxYTMzLTc5MjktNGQyNS1hNmMxLTVkYzM2YWY1NzRmMyIsIm1lc3NhZ2VJRCI6ImNjZmFmMTljLTYzNjAtNGFlYS1iNDY0LTBjZjkyNGRiNWRhNyIsIm1lc3NhZ2VUeXBlIjoibWFya2V0aW5nIiwiY2FtcGFpZ25JRCI6IjEzN2JmMzllLWM1ODgtNGI1My1iODQxLTJiMWZiZDYxM2JkYiIsImNhbXBhaWduVmVyc2lvbklEIjoiMTA1NzY1MmEtZWYwNS00YjE3LWExMmUtY2FlOTQyOTFhMWFjIiwiY2FtcGFpZ25BY3Rpb25JRCI6ImViNTlmODQ4LTk5ZDYtNGE1OC05YmU4LTk4MjIxODU0NmYzNiIsIm1lc3NhZ2VQdWJsaWNhdGlvbklEIjoiYzg2NzFjZmItNDdjYS00YTVjLTg4Y2YtNzYwZDFlZjU1MzQyIn0sIm1lc3NhZ2VQcm9maWxlIjp7ImNoYW5uZWwiOnsiX2lkIjoiaHR0cHM6Ly9ucy5hZG9iZS5jb20veGRtL2NoYW5uZWxzL3dlYiIsIl90eXBlIjoiaHR0cHM6Ly9ucy5hZG9iZS5jb20veGRtL2NoYW5uZWwtdHlwZXMvd2ViIn0sIm1lc3NhZ2VQcm9maWxlSUQiOiI2YTViY2I3ZC02MmYxLTQ5NDItODRkMC02MzE5ZjM5Zjk1ZGUifX0="
        },
        "decisionProvider": "AJO",
        "activity": {
            "id": "137bf39e-c588-4b53-b841-2b1fbd613bdb#eb59f848-99d6-4a58-9be8-982218546f36"
        }
    },
    "id": "002321c0-dff5-4153-b171-a9dfb70b9750",
    "items": [
        {
            "schema": "https://ns.adobe.com/personalization/dom-action",
            "data": {
                "uiData": {
                    "tagType": "Text",
                    "actionType": "changed"
                },
                "content": "Welcome AJO!",
                "prehidingSelector": "#wsite-content > DIV:nth-of-type(2) > DIV:nth-of-type(1) > DIV:nth-of-type(1) > DIV:nth-of-type(1) > DIV:nth-of-type(1) > DIV:nth-of-type(3) > FONT:nth-of-type(1) > SPAN:nth-of-type(1)",
                "type": "setHtml",
                "selector": "#wsite-content > DIV.wsite-section-wrap:eq(1) > DIV.wsite-section:eq(0) > DIV.wsite-section-content:eq(0) > DIV.container:eq(0) > DIV.wsite-section-elements:eq(0) > DIV.paragraph:eq(0) > FONT:nth-of-type(1) > SPAN:nth-of-type(1)"
            },
            "id": "0a522f66-9e6a-4ded-b1d0-e9167f103290"
        },
        {
            "schema": "https://ns.adobe.com/personalization/dom-action",
            "data": {
                "uiData": {
                    "tagType": "Text",
                    "actionType": "changed"
                },
                "content": {
                    "font-weight": "bold"
                },
                "prehidingSelector": "#wsite-content > DIV:nth-of-type(2) > DIV:nth-of-type(1) > DIV:nth-of-type(1) > DIV:nth-of-type(1) > DIV:nth-of-type(1) > DIV:nth-of-type(3) > FONT:nth-of-type(1) > SPAN:nth-of-type(1)",
                "type": "setStyle",
                "selector": "#wsite-content > DIV.wsite-section-wrap:eq(1) > DIV.wsite-section:eq(0) > DIV.wsite-section-content:eq(0) > DIV.container:eq(0) > DIV.wsite-section-elements:eq(0) > DIV.paragraph:eq(0) > FONT:nth-of-type(1) > SPAN:nth-of-type(1)"
            },
            "id": "66216ca5-5d0f-4239-a8c8-6bc4a5a7cbdb"
        }
    ]
}

Débogage

Pour déboguer les implémentations de la personnalisation Adobe Journey Optimizer, utilisez débogage Web SDK. Adobe Journey Optimizer traces de débogage sont disponibles lors du dépannage à l’aide de Adobe Experience Platform Assurance. Recherchez les événements comportant le préfixe AJO:.

assurance-ajo-trace

recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636