[Integration]{class="badge positive"}

Laden und Auslösen eines Target-Aufrufs load-fire-target

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

Erfahren Sie, wie Sie mit einer Tags-Regel Parameter laden, an eine Seitenanfrage übergeben und einen Target-Aufruf von Ihrer Site-Seite aus auslösen. Informationen zu Web-Seiten werden mithilfe der Adobe Client-Datenschicht abgerufen und als Parameter übergeben, über die Sie Daten zum Besuchererlebnis auf einer Web-Seite erfassen und speichern und dann den Zugriff auf diese Daten erleichtern können.

Seitenladeregel

Die Adobe Client-Datenschicht ist eine ereignisgesteuerte Datenschicht. Wenn die Datenschicht der AEM-Seite geladen wird, löst das ein cmp:show-Ereignis aus. Im Video wird die Regel tags Library Loaded mit einem benutzerspezifischen Ereignis aufgerufen. Unten finden Sie die Code-Snippets, die im Video für das benutzerspezifische Ereignis sowie für die Datenelemente verwendet werden.

Benutzerspezifisches Ereignis „Seite angezeigt“ page-event

Fügen Sie in der Tags-Eigenschaft ein neues Ereignis zur Regel hinzu

Tippen Sie auf Editor öffnen und fügen Sie folgendes Code-Snippet ein. Dieser Code muss zur Ereigniskonfiguration und zu einer sich anschließenden Aktion hinzugefügt werden.

// 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);
});

Eine benutzerdefinierte Funktion definiert den pageShownEventHandler, überwacht die von den AEM-Kernkomponenten ausgegebenen Ereignisse, leitet die relevanten Informationen von der Kernkomponente ab, packt sie in ein Ereignisobjekt und löst das Tags-Ereignis entsprechend der Payload mit den abgeleiteten Ereignisinformationen aus.

Die Tags-Regel wird mithilfe der Tags-Funktion trigger(...) ausgelöst, die nur in der Code-Snippet-Definition eines Ereignisses mit benutzerdefiniertem Code einer Regel verfügbar ist.

Die Funktion trigger(...) nimmt ein Ereignisobjekt als Parameter an, der wiederum in Tags-Datenelementen durch einen anderen reservierten Namen event in Tags verfügbar gemacht wird. Datenelemente in Tags können nun auf Daten aus diesem Ereignisobjekt aus dem event-Objekt mit einer Syntax wie event.component['someKey'] verweisen.

Wenn trigger(...) außerhalb des Kontexts des Ereignistyps „Benutzerdefinierter Code“ eines Ereignisses (z. B. in einer Aktion) verwendet wird, wird der JavaScript-Fehler trigger is undefined auf der Website ausgelöst, in die die Tags-Eigenschaft integriert ist.

Datenelemente

Tags-Datenelemente ordnen die Daten aus dem Ereignisobjekt, das im benutzerdefinierten Ereignis „Seite angezeigt“ ausgelöst wurde, Variablen zu, die in Adobe Target über den Datenelementtyp „Benutzerdefinierter Code“ der Core-Erweiterung verfügbar sind.

Seiten-ID-Datenelement

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

Dieser Code gibt die eindeutige ID der Kernkomponente zurück.

Datenelement „Seitenpfad“

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

Dieser Code gibt den Pfad der AEM-Seite zurück.

Datenelement „Seitentitel“

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

Dieser Code gibt den Titel der AEM-Seite zurück.

Fehlerbehebung

Warum werden meine Mboxes auf meinen Web-Seiten nicht ausgelöst?

Fehlermeldung, wenn kein mboxDisable-Cookie gesetzt ist

> 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.

Lösung

Target-Kundinnen und -Kunden verwenden mitunter Cloud-basierte Instanzen mit Target zum Testen oder für einfache Machbarkeitsprüfungen. Diese Domains sind wie viele andere Teil der öffentlichen Suffix-Liste.
Modere Browser speichern keine Cookies, wenn Sie diese Domains verwenden, es sei denn, Sie passen die cookieDomain-Einstellung mit targetGlobalSettings() an.

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

Nächste Schritte

Unterstützende Links