Comparer la bibliothèque at.js au SDK Web

Vue d’ensemble

Cet article présente un aperçu des différences entre la bibliothèque at.js et le SDK Web d’Experience Platform.

Installation des bibliothèques

Installation d’at.js

Nous autorisons nos clients à télécharger la bibliothèque directement depuis l’onglet Mise en oeuvre de Adobe Experience Cloud. La bibliothèque at.js est personnalisée avec les paramètres du client : clientCode, imsOrgId, etc.

Installation du SDK Web

La version prédéfinie est disponible sur un réseau de diffusion de contenu. Vous pouvez référencer la bibliothèque sur le réseau de diffusion de contenu directement sur votre page, ou la télécharger et l’héberger sur votre propre infrastructure. Il est disponible dans des formats minimisés et non minimisés. La version non minimisée est utile à des fins de débogage.

Pour plus d’informations, voir Installation du SDK Web à l’aide de la bibliothèque JavaScript .

Configuration des bibliothèques

Configuration d’at.js

À la fin de chaque fichier at.js, vous trouverez une section dans laquelle nous instancions et transmettons un objet de paramètre. Il est personnalisable. Au téléchargement, nous renseignons cette section avec les paramètres client actuels.

window.adobe.target.init(window, document, {
  "clientCode": "demo",
  "imsOrgId": "",
  "serverDomain": "localhost:5000",
  "timeout": 2000,
  "globalMboxName": "target-global-mbox",
  "version": "2.0.0",
  "defaultContentHiddenStyle": "visibility: hidden;",
  "defaultContentVisibleStyle": "visibility: visible;",
  "bodyHiddenStyle": "body {opacity: 0 !important}",
  "bodyHidingEnabled": true,
  "deviceIdLifetime": 63244800000,
  "sessionIdLifetime": 1860000,
  "selectorsPollingTimeout": 5000,
  "visitorApiTimeout": 2000,
  "overrideMboxEdgeServer": false,
  "overrideMboxEdgeServerTimeout": 1860000,
  "optoutEnabled": false,
  "optinEnabled": false,
  "secureOnly": false,
  "supplementalDataIdParamTimeout": 30,
  "authoringScriptUrl": "//cdn.tt.omtrdc.net/cdn/target-vec.js",
  "urlSizeLimit": 2048,
  "endpoint": "/rest/v1/delivery",
  "pageLoadEnabled": true,
  "viewsEnabled": true,
  "analyticsLogging": "server_side",
  "serverState": {},
  "decisioningMethod": "server-side",
  "legacyBrowserSupport":  false
});

En savoir plus

Configuration du SDK Web

La configuration du SDK est effectuée à l’aide de la commande configure. La commande configure est always appelée en premier.

Comment demander et générer automatiquement des offres Target de chargement de page

Utilisation d’at.js

Avec at.js 2.x, si vous activez le paramètre pageLoadEnabled, la bibliothèque déclenchera un appel à Target Edge avec execute -> pageLoad. Si tous les paramètres sont définis sur les valeurs par défaut, aucun codage personnalisé n’est nécessaire. Une fois at.js ajouté à la page et chargé par le navigateur, un appel Target Edge est exécuté.

Utilisation du SDK Web

Le contenu créé dans Adobe Target Visual Experience Composer peut être récupéré et rendu automatiquement par le SDK.

Pour demander et générer automatiquement des offres Target, utilisez la commande sendEvent et définissez l’option renderDecisions sur true. Cela oblige le SDK à effectuer automatiquement le rendu de tout contenu personnalisé éligible au rendu automatique.

Exemple :

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

Le SDK Web Experience Platform envoie automatiquement une notification avec les offres qui ont été exécutées par le SDK WEB. Voici un exemple de l’aspect d’une payload de requête de notification :

{
  "events": [{
      "xdm": {
        "_experience": {
          "decisioning": {
            "propositions": [
              {
                "id": "AT:eyJhY3Rpdml0eUlkIjoiMTI3MDE5IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
                "scope": "cart",
                "scopeDetails": {
                  "decisionProvider": "TGT",
                  "activity": {
                    "id": "127019"
                  },
                  "experience": {
                    "id": "0"
                  },
                  "strategies": [
                    {
                      "step": "entry",
                      "algorithmID": "0",
                      "trafficType": "0"
                    },
                    {
                      "step": "display",
                      "algorithmID": "0",
                      "trafficType": "0"
                    }
                  ],
                  "characteristics": {
                    "eventToken": "bKMxJ8dCR1XlPfDCx+2vSGqipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q=="
                  }
                }
              }
            ]
          }
        },
        "eventType": "display",
        "web": {
          "webPageDetails": {
            "viewName": "cart",
            "URL": "https://alloyio.com/personalizationSpa/cart"
          },
          "webReferrer": {
            "URL": ""
          }
        },
        "device": {
          "screenHeight": 800,
          "screenWidth": 1280,
          "screenOrientation": "landscape"
        },
        "environment": {
          "type": "browser",
          "browserDetails": {
            "viewportWidth": 1280,
            "viewportHeight": 284
          }
        },
        "placeContext": {
          "localTime": "2021-12-10T15:50:34.467+02:00",
          "localTimezoneOffset": -120
        },
        "timestamp": "2021-12-10T13:50:34.467Z",
        "implementationDetails": {
          "name": "https://ns.adobe.com/experience/alloy",
          "version": "2.6.2",
          "environment": "browser"
        }
      }
    }
  ]
}

En savoir plus

Comment demander et NE PAS générer automatiquement des offres Target de chargement de page

Utilisation d’at.js

Il existe deux façons de déclencher un appel à Target Edge qui récupérera les offres pour le chargement de la page.

Exemple 1 :

adobe.target.getOffer({
   mbox: "target-global-mbox",
   success: console.log,
   error: console.error
});

Exemple 2 :

adobe.target.getOffers({
    request: {
      execute: {
        pageLoad: {}
    }
  }
})
.then(console.log)
.catch(console.error);

En savoir plus

Utilisation du SDK Web

Exécutez une commande sendEvent avec une portée spéciale sous decisionScopes : __view__. Nous utilisons cette portée comme signal pour récupérer toutes les activités de chargement de page de Target et prérécupérer toutes les vues. Le SDK Web tente également d’évaluer toutes les activités basées sur les vues du VEC. La désactivation de la prérécupération des vues n’est actuellement pas prise en charge dans le SDK Web.

Pour accéder à tout contenu de personnalisation, vous pouvez fournir une fonction de rappel qui sera appelée une fois que le SDK aura reçu une réponse réussie du serveur. Votre rappel reçoit un objet result qui peut contenir la propriété de proposition contenant tout contenu de personnalisation renvoyé.

Exemple :

alloy("sendEvent", {
    xdm: {...},
    decisionScopes: ["__view__"]
  }).then(function(result) {
    if (result.propositions) {
      result.propositions.forEach(proposition => {
        proposition.items.forEach(item => {
          if (item.schema === HTML_SCHEMA) {
            // manually apply offer
            document.getElementById("form-based-offer-container").innerHTML =
              item.data.content;
            const executedPropositions = [
              {
                id: proposition.id,
                scope: proposition.scope,
                scopeDetails: proposition.scopeDetails
              }
            ];
          // manually send the display notification event, so that Target/Analytics impressions aare increased
            alloy("sendEvent",{
              "xdm": {
                "eventType": "decisioning.propositionDisplay",
                "_experience": {
                  "decisioning": {
                    "propositions": executedPropositions
                  }
                }
              }
            });
          }
        });
      });
    }
  });

En savoir plus

Comment demander des mbox Target spécifiques basées sur un formulaire

Utilisation d’at.js

Vous pouvez récupérer les activités du compositeur d’après les formulaires à l’aide de la fonction getOffer :

Exemple 1 :

adobe.target.getOffer({
   mbox: "hero-banner",
   success: console.log,
   error: console.error
});

Exemple 2 :

adobe.target.getOffers({
    request: {
      execute: {
        mboxes: [
        {
          index: 0,
          name: "hero-banner"
        }]
    }
  }
})
.then(console.log)
.catch(console.error);

En savoir plus

Utilisation du SDK Web

Vous pouvez récupérer les activités basées sur le compositeur d’après les formulaires à l’aide de la commande sendEvent et transmettre les noms de mbox sous l’option decisionScopes . La commande sendEvent renvoie une promesse résolue avec un objet contenant les activités/propositions demandées :
Voici à quoi ressemble le tableau propositions :

[
  {
    "id": "AT:eyJhY3Rpdml0eUlkIjoiNDM0Njg5IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
    "scope": "hero-banner",
    "scopeDetails": {
      "decisionProvider": "TGT",
      "activity": {
        "id": "434689"
      },
      "experience": {
        "id": "0"
      },
      "strategies": [
        {
          "algorithmID": "0",
          "trafficType": "0"
        }
      ],
      "characteristics": {
        "eventToken": "2lTS5KA6gj4JuSjOdhqUhGqipfsIHvVzTQxHolz2IpTMromRrB5ztP5VMxjHbs7c6qPG9UF4rvQTJZniWgqbOw=="
      }
    },
    "items": [
      {
        "id": "1184844",
        "schema": "https://ns.adobe.com/personalization/html-content-item",
        "meta": {
          "geo.state": "bucuresti",
          "activity.id": "434689",
          "experience.id": "0",
          "activity.name": "a4t test form based activity",
          "offer.id": "1184844",
          "profile.tntId": "04608610399599289452943468926942466370-pybgfJ"
        },
        "data": {
          "id": "1184844",
          "format": "text/html",
          "content": "<div> analytics impressions </div>"
        }
      }
    ]
  },
  {
    "id": "AT:eyJhY3Rpdml0eUlkIjoiNDM0Njg5IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
    "scope": "hero-banner",
    "scopeDetails": {
      "decisionProvider": "TGT",
      "activity": {
        "id": "434689"
      },
      "characteristics": {
        "eventToken": "E0gb6q1+WyFW3FMbbQJmrg=="
      }
    },
    "items": [
      {
        "id": "434689",
        "schema": "https://ns.adobe.com/personalization/measurement",
        "data": {
          "type": "click",
          "format": "application/vnd.adobe.target.metric"
        }
      }
    ]
  }
]

Exemple :

alloy("sendEvent", {
  xdm: { ...},
  decisionScopes: ["hero-banner"]
}).then(function (result) {
  var propositions = result.propositions;

  if (propositions) {
    // Find the discount proposition, if it exists.
    for (var i = 0; i < propositions.length; i++) {
      var proposition = propositions[i];
      for (var j = 0; j < proposition.items; j++) {
        var item = proposition.items[j];
        if (item.schema === HTML_SCHEMA) {
          // apply offer
          document.getElementById("form-based-offer-container").innerHTML =
            item.data.content;
          const executedPropositions = [
            {
              id: proposition.id,
              scope: proposition.scope,
              scopeDetails: proposition.scopeDetails
            }
          ];

          alloy("sendEvent", {
            "xdm": {
              "eventType": "decisioning.propositionDisplay",
              "_experience": {
                "decisioning": {
                  "propositions": executedPropositions
                }
              }
            }
          });
        }
      }
    }
  }
});

En savoir plus

Comment appliquer les activités Target

Utilisation d’at.js

Vous pouvez appliquer les activités Target en utilisant la fonction applyOffers : adobe.target.applyOffer(options)

Exemple :

adobe.target.getOffers({...})
  .then(response => adobe.target.applyOffers({ response: response }))
  .then(() => console.log("Success"))
  .catch(error => console.log("Error", error));

Pour en savoir plus sur la commande applyOffers, consultez la documentation dédiée.

Utilisation du SDK Web

Vous pouvez appliquer les activités Target à l’aide de la commande applyPropositions .

Exemple :

alloy("applyPropositions", {
    propositions: [...]
});

Pour en savoir plus sur la commande applyPropositions, consultez la documentation dédiée.

Comment effectuer le suivi des événements

Utilisation d’at.js

Vous pouvez effectuer le suivi des événements à l’aide de la fonction trackEvent ou de sendNotifications.

Cette fonction déclenche une requête pour signaler les actions de l’utilisateur, telles que les clics et les conversions. Elle ne fournit pas d’activités dans la réponse.

Exemple 1

adobe.target.trackEvent({
    "type": "click",
    "mbox": "some-mbox"
});

Exemple 2

adobe.target.sendNotifications({
    request: {
       notifications: [{
          ...,
          mbox: {
            name: "some-mbox"
          },
          type: "click",
          ...
       }]
    }
});

En savoir plus

Utilisation du SDK Web

Vous pouvez effectuer le suivi des événements et des actions de l’utilisateur en appelant la commande sendEvent, en renseignant le groupe de champs XDM _experience.decisioning.propositions et en définissant eventType sur l’une des 2 valeurs suivantes :

  • decisioning.propositionDisplay : Indique le rendu de l’activité Target.
  • decisioning.propositionInteract : indique une interaction de l’utilisateur avec l’activité, comme un clic de souris.

Le groupe de champs XDM _experience.decisioning.propositions est un tableau d’objets. Les propriétés de chaque objet sont dérivées de la result.propositions renvoyée dans la commande sendEvent : { id, scope, scopeDetails }

Exemple 1 : suivi d’un événement decisioning.propositionDisplay après le rendu d’une activité

alloy("sendEvent", {
  xdm: {},
  decisionScopes: ['discount']
}).then(function(result) {
  var propositions = result.propositions;

  var discountProposition;
  if (propositions) {
    // Find the discount proposition, if it exists.
    for (var i = 0; i < propositions.length; i++) {
      var proposition = propositions[i];
      if (proposition.scope === "discount") {
        discountProposition = proposition;
        break;
      }
    }
  }

  if (discountProposition) {
    // Find the item from proposition that should be rendered.
    // Rather than assuming there a single item that has HTML
    // content, find the first item whose schema indicates
    // it contains HTML content.
    for (var j = 0; j < discountProposition.items.length; j++) {
      var discountPropositionItem = discountProposition.items[i];
      if (discountPropositionItem.schema === "https://ns.adobe.com/personalization/html-content-item") {
        var discountHtml = discountPropositionItem.data.content;
        // Render the content
        var dailySpecialElement = document.getElementById("daily-special");
        dailySpecialElement.innerHTML = discountHtml;

        // For this example, we assume there is only a single place to update in the HTML.
        break;
      }
    }
      // Send a "decisioning.propositionDisplay" event signaling that the proposition has been rendered.
    alloy("sendEvent", {
      xdm: {
        eventType: "decisioning.propositionDisplay",
        _experience: {
          decisioning: {
            propositions: [
              {
                id: discountProposition.id,
                scope: discountProposition.scope,
                scopeDetails: discountProposition.scopeDetails
              }
            ]
          }
        }
      }
    });
  }
});

Exemple 2 : suivi d’un événement decisioning.propositionInteract après qu’une mesure de clic a lieu

alloy("sendEvent", {
  xdm: { ...},
  decisionScopes: ["hero-banner"]
}).then(function (result) {
  var propositions = result.propositions;

  if (propositions) {
    // Find the discount proposition, if it exists.
    for (var i = 0; i < propositions.length; i++) {
      var proposition = propositions[i];
      for (var j = 0; j < proposition.items.length; j++) {
        var item = proposition.items[j];

        if (item.schema === "https://ns.adobe.com/personalization/measurement") {
          // add metric to the DOM element
          const button = document.getElementById("form-based-click-metric");

          button.addEventListener("click", event => {
            const executedPropositions = [
              {
                id: proposition.id,
                scope: proposition.scope,
                scopeDetails: proposition.scopeDetails
              }
            ];
            // send the click track event
            alloy("sendEvent", {
              "xdm": {
                "eventType": "decisioning.propositionInteract",
                "_experience": {
                  "decisioning": {
                    "propositions": executedPropositions
                  }
                }
              }
            });
          });
        }
      }
    }
  }
});

En savoir plus

Exemple 3 : suivi d’un événement déclenché après l’exécution d’une action

Cet exemple effectue le suivi d’un événement déclenché après l’exécution d’une action spécifique, comme un clic sur un bouton.
Vous pouvez ajouter d’autres paramètres personnalisés par le biais de l’objet de données __adobe.target.

Vous pouvez également ajouter l’objet XDM commerce.

alloy("sendEvent", {
    "xdm": {
        "_experience": {
            "decisioning": {
                "propositions": [
                    {
                        "scope": "orderConfirm" //example scope name
                    }
                ],
                "propositionEventType": {
                    "display": 1
                }
            }
        },
        "eventType": "decisioning.propositionDisplay"
    },
    "commerce": {
        "order": {
            "purchaseID": "a8g784hjq1mnp3",
            "purchaseOrderNumber": "VAU3123",
            "currencyCode": "USD",
            "priceTotal": 999.98
        }
    },
    "data": {
        "__adobe": {
            "target": {
                "pageType": "Order Confirmation",
                "user.categoryId": "Insurance"
            }
        }
    }
})

Comment déclencher un changement d’affichage dans une application d’une seule page

Utilisation d’at.js

Utilisez la fonction adobe.target.triggerView . Cette fonction peut être appelée chaque fois qu’une nouvelle page est chargée ou qu’un composant d’une page est de nouveau rendu. La fonction adobe.target.triggerView() doit être implémentée pour les applications d’une seule page (SPA) afin d’utiliser le compositeur d’expérience visuelle (VEC) pour créer des activités de tests A/B et de ciblage d’expérience (XT). Si adobe.target.triggerView() n’est pas implémenté sur le site, le VEC ne peut pas être utilisé pour SPA.

Exemple

adobe.target.triggerView("homeView")

En savoir plus

Utilisation du SDK Web

Pour déclencher ou signaler un changement d’affichage d’application d’une seule page, définissez la propriété web.webPageDetails.viewName sous l’option xdm de la commande sendEvent. Le SDK Web vérifie le cache des vues. S’il existe des offres pour le viewName spécifié dans sendEvent, il les exécute et envoie un événement de notification d’affichage.

Exemple

alloy("sendEvent", {
  renderDecisions: true,
  xdm:{
    web:{
      webPageDetails:{
        viewName: "homeView"
      }
    }
  }
});

En savoir plus

Comment tirer parti des jetons de réponse

Le contenu Personalization renvoyé par Adobe Target comprend des jetons de réponse, qui sont des détails sur l’activité, l’offre, l’expérience, le profil utilisateur, des informations géographiques, etc. Ces détails peuvent être partagés avec des outils tiers ou utilisés pour le débogage. Les jetons de réponse peuvent être configurés dans l’interface utilisateur d’Adobe Target.

Utilisation d’at.js

Utilisez les événements personnalisés at.js pour écouter la réponse Target et lire les jetons de réponse.

Exemple

document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) {
  console.log("Request succeeded", e.detail);
});

En savoir plus

Utilisation du SDK Web

IMPORTANT
Assurez-vous que vous utilisez la version 2.6.0 ou ultérieure du SDK Web Platform.

Les jetons de réponse sont renvoyés dans le cadre des propositions exposés dans le résultat de la commande sendEvent. Chaque proposition contient un tableau de items et chaque élément aura un objet meta renseigné avec des jetons de réponse s’ils sont activés dans l’interface utilisateur d’administration de Target. En savoir plus

Exemple

alloy("sendEvent", {
    renderDecisions: true,
    xdm: {}
  }).then(function(result) {
    if (result.propositions) {
      // Format of result.propositions:
      /*
        [
            {
                "id": "",
                "scope": "",
                "items": [
                    {
                        "id": "",
                        "schema": "",
                        "data": {},
                        "meta": { // RESPONSE TOKENS
                            "activity.name": ...,
                            "offer.id": ...,
                            "profile.activeActivities": ...
                        }
                    }
                ],
                "scopeDetails": {}
                "renderAttempted": false
            }
        ]
      */
    }
  });

En savoir plus

Comment gérer le scintillement

Utilisation d’at.js

Avec at.js, vous pouvez gérer le scintillement en définissant bodyHidingEnabled: true de sorte qu’at.js soit celui qui s’occuperait de la
pré-masquer les conteneurs personnalisés avant de récupérer et d’appliquer les modifications DOM.
Les sections de page qui contiennent du contenu personnalisé peuvent être pré-masquées en remplaçant at.js bodyHiddenStyle.
Par défaut, bodyHiddenStyle masque l'HTML entier body.
Les deux paramètres peuvent être remplacés à l’aide de window.targetGlobalSettings. window.targetGlobalSettings doit être placé avant le chargement d’at.js.

Utilisation du SDK Web

Avec le SDK Web, le client peut configurer son style de prémasquage dans la commande de configuration, comme dans l’exemple ci-dessous :

alloy("configure", {
  datastreamId: "configurationId",
  orgId: "orgId@AdobeOrg",
  debugEnabled: true,
  prehidingStyle: "body { opacity: 0 !important }"
});

Lors du chargement du SDK Web asynchrone, il est recommandé d’injecter le fragment de code suivant dans la page avant d’injecter le SDK Web :

<script>
  !function(e,a,n,t){
  if (a) return;
  var i=e.head;if(i){
  var o=e.createElement("style");
  o.id="alloy-prehiding",o.innerText=n,i.appendChild(o),
  setTimeout(function(){o.parentNode&&o.parentNode.removeChild(o)},t)}}
  (document, document.location.href.indexOf("adobe_authoring_enabled") !== -1, "body { opacity: 0 !important }", 3000);
</script>

Comment A4T est-il géré ?

Utilisation d’at.js

Il existe deux types de journalisation A4T pris en charge à l’aide d’at.js :

  • Journalisation côté client Analytics
  • Journalisation côté serveur Analytics

Journalisation côté client Analytics

Exemple 1 : utilisation du paramètre global Target

La journalisation côté client Analytics peut être activée en définissant analyticsLogging: client_side dans les paramètres at.js ou en remplaçant l’objet window.targetglobalSettings.
Lorsque cette option est configurée, le format de la payload renvoyé ressemble à ce qui suit :

{
  "analytics": {
    "payload": {
      "pe": "tnt",
      "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
    }
  }
}

La payload peut ensuite être transmise à Analytics via l’API d’insertion de données.

Exemple 2 : le configurer dans chaque fonction getOffers :

adobe.target.getOffers({
      request: {
        experienceCloud: {
          analytics: {
            logging: "client_side"
          }
        },
        prefetch: {
          mboxes: [{
            index: 0,
            name: "a1-serverside-xt"
          }]
        }
      }
    })
    .then(console.log)

Voici à quoi ressemble la payload de réponse :

{
  "prefetch": {
    "mboxes": [{
      "index": 0,
      "name": "a1-serverside-xt",
      "options": [{
        "content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
        "type": "html",
        "eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
        "responseTokens": {
          "profile.memberlevel": "0",
          "geo.city": "bucharest",
          "activity.id": "167169",
          "experience.name": "USA Experience",
          "geo.country": "romania"
        }
      }],
      "analytics": {
        "payload": {
          "pe": "tnt",
          "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
        }
      }
    }]
  }
}

La charge utile Analytics (tnta) doit être incluse dans l’accès Analytics à l’aide de l’ API d’insertion de données.

Journalisation côté serveur Analytics

La journalisation côté serveur d’Analytics peut être activée en définissant analyticsLogging: server_side dans les paramètres at.js ou en remplaçant l’objet window.targetglobalSettings.
Ensuite, les données s’enchaînent comme suit :

Diagramme affichant le workflow de journalisation côté serveur Analytics

En savoir plus

Utilisation du SDK Web

Le SDK Web prend également en charge :

  • Journalisation côté client Analytics
  • Journalisation côté serveur Analytics

Journalisation côté client Analytics

La journalisation côté client d’Analytics est activée lorsqu’Adobe Analytics est désactivé pour cette configuration de DataStream.

Diagramme affichant le workflow de journalisation côté client Analytics

Le client a accès au jeton Analytics (tnta) qui doit être partagé avec Analytics à l’aide de l’ API d’insertion de données
en chaîne la commande sendEvent et en parcourant le tableau de propositions obtenu.

Exemple

alloy("sendEvent", {
    "renderDecisions": true,
    "xdm": {
      "web": {
        "webPageDetails": {
          "name": "Home Page"
        }
      }
    }
  }
).then(function (results) {
  var analyticsPayloads = new Set();
  for (var i = 0; i < results.propositions.length; i++) {
    var proposition = results.propositions[i];
    var renderAttempted = proposition.renderAttempted;

    if (renderAttempted === true) {
      var analyticsPayload = getAnalyticsPayload(proposition);
      if (analyticsPayload !== undefined) {
        analyticsPayloads.add(analyticsPayload);
      }
    }
  }
  var analyticsPayloadsToken = concatenateAnalyticsPayloads(analyticsPayloads);
  // send the page view Analytics hit with collected Analytics payload using Data Insertion API
});

Voici un diagramme qui montre comment les données circulent lorsque Analytics côté client est activé :

Diagramme de flux de données dans la journalisation côté client Analytics

Journalisation côté serveur Analytics

La journalisation côté serveur d’Analytics est activée lorsqu’Analytics est activé pour cette configuration de DataStream.

L’interface utilisateur des flux de données affiche les paramètres d’Analytics.

Lorsque la journalisation Analytics côté serveur est activée, la charge utile A4T qui doit être partagée avec Analytics afin que les rapports Analytics s’affichent.
les impressions et conversions correctes sont partagées au niveau de l’Edge Network, de sorte que le client n’ait pas à effectuer de traitement supplémentaire.

Voici comment les données s’enchaînent dans nos systèmes lorsque la journalisation Analytics côté serveur est activée :

Diagramme affichant le flux de données dans la journalisation Analytics côté serveur

Comment définir les paramètres globaux de Target

Utilisation d’at.js

Vous pouvez remplacer les paramètres de la bibliothèque at.js à l’aide de window.targetGlobalSettings, plutôt que de configurer les paramètres dans l’interface utilisateur de Target Standard/Premium ou d’utiliser des API REST.

Le remplacement doit être défini avant le chargement du fichier at.js ou dans Administration > Mise en oeuvre > Modifier les paramètres at.js > Paramètres du code > En-tête de bibliothèque.

Exemple :

window.targetGlobalSettings = {
   timeout: 200, // using custom timeout
   visitorApiTimeout: 500, // using custom API timeout
   enabled: document.location.href.indexOf('https://www.adobe.com') >= 0 // enabled ONLY on adobe.com
};

En savoir plus

Utilisation du SDK Web

Cette fonctionnalité n’est pas prise en charge dans le SDK Web.

Comment mettre à jour les attributs de profil Target

Utilisation d’at.js

Exemple 1

adobe.target.getOffer({
   mbox: "target-global-mbox",
   params: {
     "profile.name": "test",
     "profile.gender": "female"
   },
   success: console.log,
   error: console.error
});

Exemple 2

adobe.target.getOffers({
    request: {
      execute: {
        pageLoad: {
          profileParameters: {
            name: "test",
            gender: "female"
          }
        }
    }
  }
})
.then(console.log)
.catch(console.error);

Utilisation du SDK Web

Pour mettre à jour un profil Target, utilisez la commande sendEvent et définissez la propriété data.__adobe.target en ajoutant un préfixe aux noms des clés à l’aide de profile.

Exemple

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

Comment utiliser Target Recommendations

Utilisation d’at.js

Exemple 1

adobe.target.getOffer({
   mbox: "target-global-mbox",
   params: {
     "entity.name": "T-shirt",
     "entity.id": "1234"
   },
   success: console.log,
   error: console.error
});

Exemple 2

adobe.target.getOffers({
    request: {
      execute: {
        pageLoad: {
          parameters: {
            "entity.name": "T-shirt",
            "entity.id": "1234"
          }
        }
    }
  }
})
.then(console.log)
.catch(console.error);

En savoir plus

Utilisation du SDK Web

Pour envoyer des données de recommandation, utilisez la commande sendEvent et définissez la propriété data.__adobe.target en ajoutant un préfixe aux noms de clés à l’aide de entity.

Exemple

alloy("sendEvent", {
  renderDecisions: true,
  data: {
    __adobe: {
      target: {
        "entity.name": "T-shirt",
        "entity.id": "1234"
      }
    }
  }
});

Comment utiliser des identifiants tiers

Utilisation d’at.js

Avec at.js, il existe plusieurs façons d’envoyer mbox3rdPartyId, en utilisant getOffer ou getOffers :

Exemple 1

adobe.target.getOffer({
  mbox:"test",
  params:{
    "mbox3rdPartyId": "1234"
  },
  success: console.log,
  error: console.error
});

Exemple 2

adobe.target.getOffers({
    request: {
      id:{
        thirdPartyId: "1234"
      },
      execute: {
        pageLoad: {}
    }
  }
})
.then(console.log)
.catch(console.error);

Ou il existe un moyen de configurer le mbox3rdPartyId dans targetPageParams ou targetPageParamsAll.
Lors de sa définition dans targetPageParams, elle sera envoyée dans les demandes pour target-global-mbox également appelé pag-lLoad.
La recommandation doit être définie à l’aide de targetPageParamsAll, car elle sera envoyée dans chaque requête cible.
L’avantage de l’utilisation de targetPageParamsAll est que vous pouvez définir l’ mbox3rdPartyId sur la page une seule fois, ce qui garantit que toutes les requêtes cibles ont le droit mbox3rdPartyId.

window.targetPageParamsAll = function() {
      return {
        "mbox3rdPartyId": "1234"
      };
    };
window.targetPageParams = function() {
  return {
    "mbox3rdPartyId": "1234"
  };
};

En savoir plus

Utilisation du SDK Web

Le SDK Web prend en charge l’identifiant tiers Target. Toutefois, cela nécessite quelques étapes supplémentaires. Avant de nous plonger dans la solution, nous devrions parler un peu de identityMap.
La carte des identités permet aux clients d’envoyer plusieurs identités. Toutes les identités sont des espaces de noms. Chaque espace de noms peut avoir une ou plusieurs identités. Une identité particulière peut être marquée comme identité principale.
En gardant ces connaissances à l’esprit, nous pouvons voir quelles sont les étapes nécessaires pour configurer le sdk web afin d’utiliser l’identifiant tiers Target.

  1. Configurez l’espace de noms qui contiendra l’identifiant tiers Target dans la page de configuration du flux de données :

L’interface utilisateur des flux de données affiche le champ d’espace de noms d’identifiant tiers Target

  1. Envoyez cet espace de noms d’identité dans chaque commande sendEvent comme suit :
alloy("sendEvent", {
  "renderDecisions": true,
  "xdm": {
    "identityMap": {
      "TGT3PID": [
        {
          "id": "1234",
          "primary": true
        }
      ]
    }
  }
});

Comment définir les jetons de propriété

Utilisation d’at.js

L’utilisation d’at.js permet de configurer les jetons de propriété de deux manières différentes : en utilisant targetPageParams ou targetPageParamsAll. L’utilisation de targetPageParams ajoute le jeton de propriété à l’appel target-global-mbox, mais l’utilisation de targetPageParamsAll ajoute le jeton à tous les appels cible :

Exemple 1

   window.targetPageParamsAll = function() {
      return {
        "at_property": "1234"
      };
    };

Exemple 2

window.targetPageParams = function() {
      return {
        "at_property": "1234"
      };
    };

Utilisation du SDK Web

Grâce au SDK Web, les clients peuvent configurer la propriété à un niveau supérieur, lors de la configuration de la chaîne de données, sous l’espace de noms Adobe Target :
Interface utilisateur des flux de données affichant les paramètres Adobe Target.
Cela signifie que chaque appel Target pour cette configuration de flux de données spécifique va contenir ce jeton de propriété.

Comment prérécupérer les mbox

Utilisation d’at.js

Cette fonctionnalité est disponible uniquement dans at.js 2.x. at.js 2.x a une nouvelle fonction nommée getOffers. getOffers permet aux clients de prérécupérer du contenu pour une ou plusieurs mbox. Voici un exemple :

adobe.target.getOffers({
    request: {
      prefetch: {
        mboxes: [{
          index: 0,
          name: "test-mbox",
          parameters: {
            ...
          },
          profileParameters: {
            ...
          }
        }]
    }
  }
})
.then(console.log)
.catch(console.error);

REMARQUE : Il est vivement conseillé de s’assurer que chaque mbox du tableau mboxes possède son propre index. En règle générale, la première mbox contient index=0, le suivant index=1, etc.

Utilisation du SDK Web

Cette fonctionnalité n’est actuellement pas prise en charge dans le SDK Web.

Comment déboguer ma mise en oeuvre Target

Utilisation d’at.js

at.js expose les fonctionnalités de débogage suivantes :

  • Mbox Disable : désactivez Target pour vérifier si la page est rompue sans interactions Target.
  • Débogage de mbox : at.js consigne chaque action.
  • Target Trace : avec un jeton de suivi de mbox généré dans Bullseye, un objet trace avec les détails ayant participé au processus de prise de décision est disponible sous l’objet window.___target_trace.

Remarque : Toutes ces fonctions de débogage sont disponibles avec des fonctionnalités améliorées dans Adobe Experience Platform Debugger

Utilisation du SDK Web

Vous disposez de plusieurs fonctionnalités de débogage lors de l’utilisation du SDK Web :

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