[Intégration]{class="badge positive"}

Charger et déclencher un appel Target load-fire-target

[AEM Sites as a Cloud Service, AEM Sites 6.5]{class="badge informative"}

Découvrez comment charger, transférer des paramètres à une requête de page et déclencher un appel Target à partir de la page de votre site à l’aide d’une règle de balises. Les informations de page web sont récupérées et transmises en tant que paramètres à l’aide de la couche de données de la clientèle Adobe qui vous permet de collecter et de stocker des données sur l’expérience des visiteurs et des visiteuses sur une page web, puis d’accéder facilement à ces données.

Règle de chargement de page

La couche de données de la clientèle Adobe est une couche de données pilotée par les événements. Lorsque la couche de données de page AEM est chargée, elle déclenche un événement cmp:show. Dans la vidéo, la règle tags Library Loaded est appelée à l’aide d’un événement personnalisé. Vous trouverez ci-dessous les fragments de code utilisés dans la vidéo pour l’événement personnalisé ainsi que pour les éléments de données.

Événement d’affichage de page personnalisé page-event

Dans la propriété de balises, ajoutez un nouvel Événement à la Règle.

Appuyez sur le bouton Ouvrir l’éditeur et collez l’extrait de code suivant. Ce code doit être ajouté à la Configuration d’événement et à une Action ultérieure.

// Define the event handler function
var pageShownEventHandler = function(coreComponentEvent) {

    // Check to ensure event trigger via AEM Core Components is shaped correctly
    if (coreComponentEvent.hasOwnProperty("eventInfo") &&
        coreComponentEvent.eventInfo.hasOwnProperty("path")) {

        // Debug the AEM Component path the show event is associated with
        console.debug("cmp:show event: " + coreComponentEvent.eventInfo.path);

        // Create the tags Event object
        var launchEvent = {
            // Include the ID of the AEM Component that triggered the event
            id: coreComponentEvent.eventInfo.path,
            // Get the state of the AEM Component that triggered the event
            component: window.adobeDataLayer.getState(coreComponentEvent.eventInfo.path)
        };

        // Trigger the tags Rule, passing in the new `event` object
        // the `event` obj can now be referenced by the reserved name `event` by other tags data elements
        // i.e `event.component['someKey']`
        trigger(launchEvent);
   }
}

// With the AEM Core Component event handler, that proxies the event and relevant information to Data Collection, defined above...

// Initialize the adobeDataLayer global object in a safe way
window.adobeDataLayer = window.adobeDataLayer || [];

// Push the event custom listener onto the Adobe Data Layer
window.adobeDataLayer.push(function (dataLayer) {
   // Add event listener for the `cmp:show` event, and the custom `pageShownEventHandler` function as the callback
   dataLayer.addEventListener("cmp:show", pageShownEventHandler);
});

Une fonction personnalisée définit le pageShownEventHandler et écoute les événements émis par les composants principaux d’AEM, déduit les informations pertinentes des composants principaux, les regroupe dans un objet d’événement et déclenche l’événement de balises avec les informations déduites de l’événement dans sa payload.

La règle de balises est déclenchée à l’aide de la fonction trigger(...) des balises qui est uniquement disponible à partir de la définition de l’extrait de code du code personnalisé d’un événement de règle.

La fonction trigger(...) prend un objet d’événement comme paramètre qui, à son tour, est exposé dans les éléments de données de balises par un autre nom réservé dans des balises nommé event. Les éléments de données dans des balises peuvent désormais faire référence à des données à partir de cet objet d’événement à partir de l’objet event utilisant une syntaxe telle que event.component['someKey'].

Si la fonction trigger(...) est utilisée en dehors du contexte du type d’événement Code personnalisé d’un événement (par exemple, dans une action), l’erreur JavaScript trigger is undefined est générée sur le site web intégré à la propriété de balises.

Éléments de données

Les éléments de données Balises font correspondre les données de l’objet d’événement déclenché dans l’événement Affichage de page personnalisé aux variables disponibles dans Adobe Target, via le type d’élément de données Code personnalisé de l’extension principale.

Élément de données ID de page

if (event && event.id) {
    return event.id;
}

Ce code renvoie l’ID unique généré par le composant principal.

Élément de données Chemin d’accès de page

if (event && event.component && event.component.hasOwnProperty('repo:path')) {
    return event.component['repo:path'];
}

Ce code renvoie le chemin d’accès de la page AEM.

Élément de données Titre de page

if (event && event.component && event.component.hasOwnProperty('dc:title')) {
    return event.component['dc:title'];
}

Ce code renvoie le titre de la page AEM.

Résolution des problèmes

Pourquoi mes mBox ne se déclenchent pas sur mes pages web ?

Message d’erreur lorsque le cookie mboxDisable n’est pas défini

> AT: [page-init] Adobe Target content delivery is disabled. Ensure that you can save cookies to your current domain, there is no "mboxDisable" cookie and there is no "mboxDisable" parameter in the query string.

Solution

Les clientes et clients Target utilisent parfois des instances basées sur le cloud avec Target à des fins de test ou de preuve de concept. Ces domaines, et bien d’autres, font partie de la liste des suffixes publics.
Les navigateurs modernes n’enregistrent pas les cookies si vous utilisez ces domaines, sauf si vous personnalisez le paramètre cookieDomain à l’aide de targetGlobalSettings().

window.targetGlobalSettings = {
   cookieDomain: 'your-domain' //set the cookie directly on this subdomain, for example: 'publish-p1234-e5678.adobeaemcloud.com'
};

Étapes suivantes

Liens connexes