Einrichten von Adobe Target mit Platform Web SDK
Erfahren Sie, wie Sie Adobe Target mit Adobe Experience Platform Web SDK implementieren. Erfahren Sie, wie Sie Erlebnisse bereitstellen und zusätzliche Parameter an Target übergeben.
Adobe Target ist die Adobe Experience Cloud-Anwendung, die Ihnen alle Tools bereitstellt, die Sie benötigen, um das Kundenerlebnis anzupassen und zu personalisieren, damit Sie Umsätze auf Ihren Websites, mobilen Sites, Apps und anderen digitalen Kanälen maximieren können.
Lernziele
Am Ende dieser Lektion können Sie mit einer Web SDK-Implementierung von Target Folgendes durchführen:
- Fügen Sie das vorab ausgeblendete Snippet hinzu, um ein Flackern zu verhindern.
- Konfigurieren eines Datenstroms zur Aktivierung der Target-Funktion
- Rendern von Visual Experience Composer-Aktivitäten
- Rendern von Formular-Composer-Aktivitäten
- Übergeben von XDM-Daten an Target und Verstehen der Zuordnung zu Target-Parametern
- Übergeben benutzerdefinierter Daten an Target, z. B. Profil- und Entitätsparameter
- eine Target-Implementierung überprüfen
- Trennen von Personalisierungsanfragen von Analytics-Anfragen
Voraussetzungen
Um die Lektionen in diesem Abschnitt abzuschließen, müssen Sie zunächst:
-
Schließen Sie alle Lektionen für die Erstkonfiguration von Platform Web SDK ab, einschließlich der Einrichtung von Datenelementen und Regeln.
-
Adobe Target Stellen Sie sicher, dass Sie in über eine- oder Genehmigerrolle verfügen.
-
Installieren Sie die Visual Experience Composer Helper-Erweiterung, wenn Sie den Google Chrome-Browser verwenden.
-
Wissen, wie Sie Aktivitäten in Target einrichten. Wenn Sie eine Auffrischung benötigen, sind die folgenden Tutorials und Handbücher für diese Lektion hilfreich:
Flackerhandhabung hinzufügen
Stellen Sie vor dem Start fest, ob eine zusätzliche Lösung für den Umgang mit Flackern erforderlich ist, je nachdem, wie die Tag-Bibliothek geladen wird.
Asynchrone Implementierung
Wenn eine Tag-Bibliothek asynchron geladen wird, kann das Rendern der Seite abgeschlossen sein, bevor Target den Standardinhalt durch personalisierten Inhalt ersetzt hat. Dieses Verhalten kann zu einem so genannten „Flackern“ führen, bei dem Standardinhalte kurz angezeigt werden, bevor sie durch personalisierte Inhalte ersetzt werden. Wenn Sie dieses Flackern vermeiden möchten, empfiehlt Adobe, unmittelbar vor dem asynchronen Tag-Einbettungs-Code ein spezielles pre-hiding-Snippet hinzuzufügen.
Dieses Snippet ist bereits auf der Luma-Site vorhanden. Sehen wir uns jedoch genauer an, um zu verstehen, was dieser Code tut:
<script>
!function(e,a,n,t){var i=e.head;if(i){
if (a) return;
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, ".personalization-container { opacity: 0 !important }", 3000);
</script>
Durch das pre-hiding-Snippet wird ein Stil-Tag im Kopf der Seite mit der gewünschten CSS-Definition erstellt. Dieses Stil-Tag wird entfernt, wenn eine Antwort von Target empfangen wird oder die Zeitüberschreitung erreicht wird.
Das Pre-hiding-Verhalten wird durch zwei Konfigurationen am Ende des Snippets gesteuert.
body { opacity: 0 !important }
gibt die CSS-Definition an, die für das Vorab-Ausblenden bis zum Laden von Target verwendet werden soll. Standardmäßig ist die gesamte Seite ausgeblendet. Sie können diese Definition aktualisieren, damit die Selektoren, die Sie vorab ausblenden möchten, sowie die Art und Weise, wie Sie sie ausblenden möchten, angezeigt werden. Sie können mehrere Definitionen aufnehmen, da dieser Wert einfach in das Stil-Tag vor dem Ausblenden eingefügt wird. Wenn Sie ein leicht identifizierbares Container-Element haben, das den Inhalt unter Ihrer Navigation umschließt, können Sie diese Einstellung verwenden, um das Vorab-Ausblenden auf dieses Container-Element zu beschränken.3000
Gibt den Timeout-Wert in Millisekunden für das Vorab-Ausblenden an. Wenn vor Ablauf der maximalen Wartezeit keine Antwort von Target eingeht, wird das vorab ausgeblendete Stil-Tag entfernt. Das Erreichen dieser maximalen Wartezeit sollte selten sein.
alloy-prehiding
verwendet. Wenn das pre-hiding-Snippet für at.js verwendet wird, funktioniert es möglicherweise nicht richtig.Das pre-hiding-Snippet ist auch in Tags verfügbar:
-
Navigieren Sie zum Abschnitt Erweiterungen der Tags
-
Wählen Sie Konfigurieren für die Adobe Experience Platform Web SDK-Erweiterung aus.
-
Wählen Sie die Schaltfläche Code-Ausschnitt in Zwischenablage kopieren
note note NOTE Das standardmäßige pre-hiding-Snippet, das aus der Platform Web SDK-Erweiterung kopiert wurde, kann eine CSS-Definition enthalten, die nicht auf Ihrer Site vorhanden ist, z. B. .personalization-container { opacity: 0 !important }
. Prüfen Sie, ob das pre-hiding-Snippet für Ihre Site geeignet ist.
Synchrone Implementierung
Adobe empfiehlt, Tags asynchron zu implementieren, wie auf der Luma-Site gezeigt. Wenn die Tag-Bibliothek jedoch synchron geladen wird, ist das pre-hiding-Snippet nicht erforderlich. Stattdessen wird der Stil zum Vorab-Ausblenden in den Erweiterungsparametern der Platform Web SDK festgelegt.
Der Stil zum Vorab-Ausblenden für synchrone Implementierungen kann wie folgt konfiguriert werden:
-
Navigieren Sie zum Abschnitt Erweiterungen der Tags
-
Klicken Sie auf Schaltfläche „Konfigurieren für die Platform Web SDK-Erweiterung
-
Klicken Sie auf Schaltfläche (Stil zum Vorab-Ausblenden bearbeiten.
-
Ändern Sie das CSS, um die Selektoren und Ausblendmethoden einzuschließen, die Sie verwenden möchten, z. B.
body { opacity: 0 !important }
, wenn Sie den gesamten Seitentext vorab ausblenden möchten. -
Speichern Sie Ihre Änderungen und erstellen Sie sie in einer Bibliothek
Weitere Informationen zur Verwaltung von Flackern in Platform Web SDK finden Sie im Abschnitt Handbuch: von Flackern für personalisierte Erlebnisse.
Konfigurieren des Datenstroms
Target muss in der Datenstromkonfiguration aktiviert sein, bevor Target-Aktivitäten von Platform Web SDK bereitgestellt werden können.
So konfigurieren Sie Target im Datenstrom:
-
Wechseln Sie zur Datenerfassung.
-
Wählen Sie in der linken Navigation Datenströme
-
Wählen Sie den zuvor erstellten
Luma Web SDK: Development Environment
aus -
Wählen Sie Service hinzufügen
-
Wählen Sie Adobe Target als Service
-
Geben Sie bei Bedarf die optionalen Details zu Ihrer Target-Implementierung ein. Befolgen Sie dazu die folgenden Anweisungen.
-
Wählen Sie Speichern
Eigenschafts-Token
Target Premium-Kunden haben die Möglichkeit, Benutzerberechtigungen mit Eigenschaften zu verwalten. Mit den Target-Eigenschaften können Sie Grenzen für Benutzerinnen und Benutzer festlegen, an denen Target-Aktivitäten ausgeführt werden können. Weitere Informationen finden Sie AbschnittEnterprise-Berechtigungen“ in der Target-Dokumentation.
Um Eigenschafts-Token einzurichten oder zu finden, navigieren Sie zu Adobe Target > Administration > Eigenschaften. Das Symbol </>
zeigt den Implementierungs-Code an. Der at_property
Wert ist das Eigenschafts-Token, das Sie in Ihrem Datenstrom verwenden würden.
Pro Datenstrom kann nur ein Eigenschafts-Token angegeben werden, aber mit Eigenschafts-Token-Überschreibungen können Sie alternative Eigenschafts-Token angeben, die das im Datenstrom definierte primäre Eigenschafts-Token ersetzen. Außerdem ist eine Aktualisierung der sendEvent
Aktion erforderlich, um den Datenstrom zu überschreiben.
Zielumgebungs-ID
Umgebungen in Target helfen Ihnen in allen Entwicklungsphasen bei der Implementierung. Diese optionale Einstellung gibt an, welche Zielumgebung für jeden Datenstrom verwendet werden soll.
Adobe empfiehlt, die Zielumgebungs-ID für jeden Entwicklungs-, Staging- und Produktionsdatenstrom unterschiedlich festzulegen, um die Dinge einfach zu halten. Alternativ können Sie Ihre Umgebungen in der Benutzeroberfläche von Target mithilfe der Funktion hosts organisieren.
Um Umgebungs-IDs einzurichten oder zu finden, navigieren Sie zu Adobe Target > Administration > Umgebungen.
Namespace der Target-Drittanbieter-ID
Mit dieser optionalen Einstellung können Sie angeben, welches Identitätssymbol für die Target-Drittanbieter-ID verwendet werden soll. Target unterstützt nur die Profilsynchronisierung für ein einzelnes Identitätssymbol oder einen Namespace. Weitere Informationen finden Sie im Abschnitt Echtzeit-Profilsynchronisierung für mbox3rdPartyId des Target-Handbuchs.
Die Identitätssymbole befinden sich in der Identitätsliste unter Datenerfassung > Kunde > Identitäten.
Für dieses Tutorial zur Verwendung der Luma-Site verwenden Sie das Identitätssymbol, lumaCrmId
während der Lektion über (Identitäten eingerichtet.
Rendern von visuellen Personalisierungsentscheidungen
Visuelle Personalisierungsentscheidungen beziehen sich auf die in Visual Experience Composer von Adobe Target erstellten Erlebnisse. Zunächst sollten Sie die in den Schnittstellen von Target und Tags verwendete Terminologie verstehen:
- Aktivität: Eine Reihe von Erlebnissen, die auf eine oder mehrere Zielgruppen ausgerichtet sind. Ein einfacher A/B-Test könnte beispielsweise eine Aktivität mit zwei Erlebnissen sein.
- Erlebnis: Eine Reihe von Aktionen, die auf einen oder mehrere Standorte oder Entscheidungsumfänge ausgerichtet sind.
- Entscheidungsumfang: Ein Ort, an dem ein Target-Erlebnis bereitgestellt wird. Entscheidungsumfänge entsprechen „mboxes“, wenn Sie mit der Verwendung älterer Versionen von Target vertraut sind.
- Personalization-Entscheidung: Eine Aktion, deren Anwendung nach Serverfestlegung erforderlich ist. Diese Entscheidungen können auf Zielgruppenkriterien und Target-Aktivitätsprioritäten basieren.
- Vorschlag: Das Ergebnis von Entscheidungen, die vom Server getroffen und in der Antwort von Platform Web SDK bereitgestellt werden. Es kann sich beispielsweise als Vorschlag erweisen, ein Bannerbild zu ersetzen.
Aktualisieren der Aktion Ereignis senden
Visuelle Personalisierungsentscheidungen aus Target werden von Platform Web SDK bereitgestellt, wenn Target im Datenstrom aktiviert ist. Sie jedoch nicht automatisch gerendert. Sie müssen die Aktion Ereignis senden aktualisieren, um das automatische Rendering zu aktivieren.
-
Öffnen Sie in der Datenerfassung die Tag-Eigenschaft, die Sie für dieses Tutorial verwenden
-
all pages - library loaded - send event - 50
öffnen -
Adobe Experience Platform Web SDK - Send event
auswählen -
Aktivieren Sie Visuelle Personalisierungsentscheidungen rendern mit dem Kontrollkästchen
-
Speichern Sie die Änderungen und erstellen Sie dann eine Bibliothek
Mit der Einstellung Visuelle Personalisierungsentscheidungen rendern wendet Platform Web SDK automatisch alle Änderungen an, die mit dem Visual Experience Composer oder der globalen Mbox von Target angegeben wurden.
Wenn Sie es vorziehen, diese Entscheidungen selbst mit benutzerdefiniertem Code zu rendern oder zu bearbeiten, können Sie die Einstellung Visuelle Personalisierungsentscheidungen rendern deaktiviert lassen. Platform Web SDK ist flexibel und bietet diese Funktion, um Ihnen vollständige Kontrolle zu geben. Weitere Informationen zum manuellen Rendern personalisierter Inhalte Sie im Handbuch.
Einrichten einer Target-Aktivität mit dem Visual Experience Composer
Nachdem die grundlegende Implementierung abgeschlossen ist, erstellen Sie eine Experience Targeting (XT)-Aktivität in Target, um zu überprüfen, ob alles ordnungsgemäß funktioniert. Weitere Informationen finden Sie im Target-Tutorial zum Erstellen Experience TargetingAktivitäten .
-
Navigieren Sie zur Adobe Target-Benutzeroberfläche
-
Erstellen Sie eine Experience Targeting-(XT)-Aktivität unter Verwendung der Luma-Homepage für die Aktivitäts-URL.
-
Ändern Sie die Seite, z. B. ändern Sie den Text im Hero-Banner der Startseite. Wenn Sie fertig sind, wählen Speichern und dann Weiter.
-
Aktualisieren Sie den Ereignisnamen und klicken Sie dann auf Weiter.
-
Wählen Sie Adobe Analytics als Berichtsquelle mit der entsprechenden Report Suite und der Metrik Bestellungen als Ziel
note note NOTE Wenn Sie Adobe Analytics nicht verwenden, wählen Sie Target als Berichtsquelle und wählen Sie stattdessen eine andere Metrik wie Interaktion > Seitenansichten. Zum Speichern und Anzeigen einer Vorschau der Aktivität ist eine Zielmetrik erforderlich. -
Speichern der Aktivität
-
Wenn Sie mit Ihren Änderungen vertraut sind, können Sie Ihre Aktivität aktivieren. Wenn Sie das Erlebnis ohne Aktivierung in der Vorschau anzeigen möchten, können Sie andernfalls die QA-Vorschau-URL kopieren.
-
Laden Sie die Luma-Homepage. Ihre Änderungen sollten angewendet werden
-
Nach einigen Stunden sollten Sie in Adobe Analytics die Target-Aktivitätsdaten und -konversionen sehen können. Ausführliche Informationen zur Berichterstellung von Analytics for Target (A4T)) finden Sie im TargetHandbuch .
Validieren mit dem Debugger
Wenn Sie eine Aktivität einrichten, sollte der Inhalt auf der Seite gerendert werden. Selbst wenn keine Aktivitäten aktiv sind, können Sie sich jedoch auch den Netzwerkaufruf „Ereignis senden“ ansehen, um zu bestätigen, dass Target ordnungsgemäß konfiguriert ist.
-
Öffnen Sie die Adobe Experience Platform Debugger-Browser-Erweiterung
-
Wechseln Sie zur Demo-Site von Luma und verwenden Sie den Debugger, die Tag-Eigenschaft auf der Site in Ihre eigene Entwicklungseigenschaft zu wechseln
-
Seite neu laden
-
Wählen Sie das Netzwerk-Tool im Debugger aus
-
Nach Experience Platform Web SDK filtern
-
Wählen Sie den Wert in der Ereigniszeile für den ersten Aufruf aus
-
Beachten Sie, dass unter
query
>personalization
Schlüssel vorhanden sind unddecisionScopes
den Wert__view__
hat. Dieser Umfang entspricht demtarget-global-mbox
. Dieser Platform Web SDK-Aufruf fordert Entscheidungen von Target an. -
Schließen Sie die Überlagerung und wählen Sie die Ereignisdetails für den zweiten Netzwerkaufruf aus. Dieser Aufruf ist nur vorhanden, wenn Target eine Aktivität zurückgegeben hat.
-
Beachten Sie, dass es Details zur Aktivität und zum Erlebnis gibt, die von Target zurückgegeben werden. Dieser Platform Web SDK-Aufruf sendet eine Benachrichtigung, dass eine Target-Aktivität für den Benutzer gerendert wurde, und inkrementiert eine Impression.
Einrichten und Rendern eines benutzerdefinierten Entscheidungsumfangs
Benutzerdefinierte Entscheidungsumfänge (ehemals als „Mboxes“ bezeichnet) können verwendet werden, um HTML- oder JSON-Inhalte mithilfe des formularbasierten Experience Composers von Target strukturiert bereitzustellen. Inhalte, die für einen dieser benutzerdefinierten Bereiche bereitgestellt werden, werden von Platform Web SDK nicht automatisch gerendert. Sie kann mithilfe einer Aktion in Tags gerendert werden.
Fügen Sie der Aktion „Ereignis senden“ einen Bereich
Ändern Sie Ihre Seitenladeregel, um einen benutzerdefinierten Entscheidungsumfang hinzuzufügen:
-
all pages - library loaded - send event - 50
öffnen -
Adobe Experience Platform Web SDK - Send Event
auswählen -
Fügen Sie einen oder mehrere Bereiche hinzu, die Sie verwenden möchten. Verwenden Sie für dieses Beispiel
homepage-hero
. -
Speichern Sie Ihre Änderungen und erstellen Sie sie in Ihrer Bibliothek
Verarbeiten der Target-Antwort
Nachdem Sie nun Platform Web SDK so konfiguriert haben, dass Inhalte für den homepage-hero
angefordert werden, müssen Sie etwas mit der Antwort tun. Die Tag-Erweiterung von Platform Web SDK bietet ein send event complete-Ereignis, mit dem sofort eine neue Regel Trigger werden kann, wenn eine Antwort von einer „send event–Aktion eingeht.
-
Erstellen Sie eine Regel mit dem Namen
homepage - send event complete - render homepage-hero
. -
Fügen Sie der Regel ein Ereignis hinzu. Verwenden Sie die Erweiterung Adobe Experience Platform Web SDK und den Ereignistyp send event complete.
-
Fügen Sie eine Bedingung hinzu, um die Regel auf die Luma-Homepage zu beschränken (Pfad ohne Abfragezeichenfolge entspricht
/content/luma/us/en.html
). -
Fügen Sie der Regel eine Aktion hinzu. Verwenden Sie die Erweiterung Adobe Experience Platform Web SDK und den Aktionstyp Vorschläge anwenden“.
note tip TIP Geben Sie Ihren Regelereignissen, Bedingungen und Aktionen beschreibende Namen, anstatt die Standardnamen zu verwenden. Robuste Namen von Regelkomponenten machen die Suchergebnisse viel nützlicher. -
Geben Sie
%event.propositions%
in das Feld Vorschläge ein, da wir das Ereignis „Versandereignis abgeschlossen“ als Trigger für diese Regel verwenden. -
Wählen Sie im Abschnitt „Vorschlagsmetadaten“ die Option Formular verwenden
-
Für die
homepage-hero
Umfang des Felds -
Für die Selektor-
div.heroimage
-
Wählen Sie Aktionstyp die Option HTML festlegen
-
Wählen Änderungen beibehalten
Zusätzlich zum Rendern der Aktivität müssen Sie einen zusätzlichen Aufruf an Target ausführen, um anzugeben, dass die formularbasierte Aktivität gerendert wurde:
-
Fügen Sie der Regel eine weitere Aktion hinzu. Verwenden Sie die Core-Erweiterung und den Aktionstyp Benutzerdefinierter Code:
-
Fügen Sie den folgenden JavaScript-Code ein:
code language-javascript var propositions = event.propositions; var heroProposition; if (propositions) { // Find the hero proposition, if it exists. for (var i = 0; i < propositions.length; i++) { var proposition = propositions[i]; if (proposition.scope === "homepage-hero") { heroProposition = proposition; break; }xw } } // Send a "display" event if (heroProposition !== undefined){ alloy("sendEvent", { xdm: { eventType: "display", _experience: { decisioning: { propositions: [{ id: heroProposition.id, scope: heroProposition.scope, scopeDetails: heroProposition.scopeDetails }] } } } }); }
-
Wählen Änderungen beibehalten
-
Speichern Sie Ihre Änderungen und erstellen Sie sie in Ihrer Bibliothek
-
Laden Sie die Luma-Homepage einige Male. Dies sollte ausreichen, um den neuen
homepage-hero
Entscheidungsumfang in der Target-Oberfläche zu registrieren.
Einrichten einer Target-Aktivität mit dem formularbasierten Experience Composer
Nachdem Sie nun über eine Regel zum manuellen Rendern eines benutzerdefinierten Entscheidungsumfangs verfügen, können Sie in Target eine weitere Experience Targeting-(XT)-Aktivität erstellen. Verwenden Sie dieses Mal den formularbasierten Experience Composer.
-
Deaktivieren der in der vorherigen Lektion verwendeten Aktivität
-
Erstellen einer Experience Targeting-(XT)-Aktivität mit der Option „Form-Based Experience Composer“
-
Wählen Sie den
homepage-hero
Speicherort aus dem Dropdown-Menü Speicherort und HTML-Angebot erstellen aus dem Dropdown-Menü Inhalt aus. Wenn der Speicherort nicht verfügbar ist, können Sie ihn eingeben. Target füllt regelmäßig neue Standortnamen, nachdem es Anfragen für diesen Standort oder Bereich erhält. -
Fügen Sie den folgenden Code in das Feld Inhalt ein. Dieser Code ist ein einfaches Hero-Banner mit einem anderen Hintergrundbild:
code language-html <div class="we-HeroImage jumbotron" style="background-image: url('/content/luma/us/en/women/_jcr_content/root/hero_image.coreimg.jpeg');"> <div class="container cq-dd-image"> <div class="we-HeroImage-wrapper"> <p class="h3">New Luma Yoga Collection</p> <strong class="we-HeroImage-title h1">Be active with style </strong> <p> <a class="btn btn-primary btn-action" href="/content/luma/us/en/products.html" role="button">Shop Now</a> </p> </div> </div> </div>
-
Wählen Sie im Schritt Ziele und Einstellungen die Berichtsquelle Adobe Target und Interaktion > Seitenansichten aus
-
Speichern der Aktivität
-
Wenn Sie mit Ihren Änderungen vertraut sind, können Sie Ihre Aktivität aktivieren. Wenn Sie das Erlebnis ohne Aktivierung in der Vorschau anzeigen möchten, können Sie andernfalls die QA-Vorschau-URL kopieren.
-
Laden Sie die Luma-Homepage. Ihre Änderungen sollten angewendet werden
sendEvent
-Aktion Ihr eigenes Klick-Tracking für jeden Bereich mit dem eventType
„Klick“ mit den entsprechenden _experience
erstellen.Validieren mit dem Debugger
Wenn Sie Ihre Aktivität aktiviert haben, sollte der gerenderte Inhalt auf der Seite angezeigt werden. Selbst wenn keine Aktivitäten live sind, können Sie sich jedoch auch den Netzwerkaufruf Ereignis senden ansehen, um zu bestätigen, dass Target Inhalte für Ihre benutzerdefinierten Bereiche anfordert.
-
Öffnen Sie die Browser-Erweiterung Adobe Experience Platform Debugger .
-
Wechseln Sie zur Demo-Site von Luma und verwenden Sie den Debugger, die Tag-Eigenschaft auf der Site in Ihre eigene Entwicklungseigenschaft zu wechseln
-
Seite neu laden
-
Wählen Sie im Debugger Tool Netzwerk“ aus.
-
Filtern nach Adobe Experience Platform Web SDK
-
Wählen Sie den Wert in der Ereigniszeile für den ersten Aufruf aus
-
Beachten Sie, dass unter
query
>personalization
Schlüssel vorhanden sind unddecisionScopes
wie zuvor einen Wert von__view__
hat, aber jetzt ist auch einhomepage-hero
enthalten. Dieser Platform Web SDK-Aufruf ruft Target auf, Entscheidungen für Änderungen zu treffen, die mithilfe des VEC und des spezifischenhomepage-hero
-Speicherorts vorgenommen wurden. -
Schließen Sie die Überlagerung und wählen Sie die Ereignisdetails für den zweiten Netzwerkaufruf aus. Dieser Aufruf ist nur vorhanden, wenn Target eine Aktivität zurückgegeben hat.
-
Beachten Sie, dass es Details zur Aktivität und zum Erlebnis gibt, die von Target zurückgegeben werden. Dieser Platform Web SDK-Aufruf sendet eine Benachrichtigung, dass eine Target-Aktivität für den Benutzer gerendert wurde, und inkrementiert eine Impression. Sie wurde durch die zuvor hinzugefügte Aktion mit benutzerdefiniertem Code initiiert.
Parameter an Target senden
In diesem Abschnitt übergeben Sie Target-spezifische Daten und sehen sich genauer an, wie XDM-Daten den Target-Parametern zugeordnet werden.
Seitenparameter (Mbox) und XDM
Alle XDM-Felder werden automatisch als Seitenparameter oder Mbox-Parameter an Target übergeben.
Einige dieser XDM-Felder werden speziellen Objekten im Backend von Target zugeordnet. Beispielsweise stehen web.webPageDetails.URL
beim Erstellen von Profilskripten automatisch zum Erstellen URL-basierter Zielgruppenbestimmungsbedingungen oder als page.url
zur Verfügung.
Sie können Seitenparameter auch mithilfe des Datenobjekts hinzufügen.
Spezielle Parameter und das Datenobjekt
Es gibt einige Datenpunkte, die für Target nützlich sein können und nicht vom XDM-Objekt zugeordnet sind. Zu diesen speziellen Zielgruppen-Parametern gehören:
Diese Parameter müssen im data
-Objekt gesendet werden, anstatt im xdm
-Objekt. Darüber hinaus können auch Seiten- (oder Mbox-)Parameter in das data
-Objekt aufgenommen werden.
Um das Datenobjekt auszufüllen, erstellen Sie das folgende Datenelement und verwenden Sie Datenelemente wieder, die in der Lektion Datenelemente erstellen erstellt wurden:
-
data.content
mit dem folgenden benutzerdefinierten Code:code language-javascript var data = { __adobe: { target: { "entity.id": _satellite.getVar("product.productInfo.sku"), "entity.name": _satellite.getVar("product.productInfo.title"), "profile.loggedIn": _satellite.getVar("user.profile.attributes.loggedIn"), "user.categoryId": _satellite.getVar("product.category") } } } return data;
Aktualisieren der Seitenladeregel
Wenn Sie zusätzliche Daten für Target außerhalb des XDM-Objekts übergeben möchten, müssen alle anwendbaren Regeln aktualisiert werden. In diesem Beispiel müssen Sie nur das neue Datenelement data.content in die allgemeine Seitenladeregel und die Produktseitenansichtsregel einbeziehen.
-
all pages - library loaded - send event - 50
öffnen -
Adobe Experience Platform Web SDK - Send event
auswählen -
Hinzufügen des
data.content
Datenelements zum Datenfeld -
Speichern Sie Ihre Änderungen und erstellen Sie sie in Ihrer Bibliothek
data
verwendet, das nicht bei allen Seitentypen vollständig aufgefüllt ist. Tags handhabt diese Situation angemessen und lässt Schlüssel mit einem undefinierten Wert aus. Beispielsweise würden entity.id
und entity.name
auf keiner Seite außer den Produktdetails weitergegeben.Aufteilen von Personalization- und Analytics-Anfragen
Die Datenschicht auf der Luma-Site wird vollständig definiert, bevor der Tag-Einbettungs-Code verwendet wird. Auf diese Weise können wir mit einem einzigen Aufruf personalisierte Inhalte abrufen (z. B. aus Adobe Target) und Analysedaten senden (z. B. an Adobe Analytics).
Auf vielen Websites kann die Datenschicht jedoch nicht früh genug oder schnell genug geladen werden, um für beide Anwendungen einen einzigen Aufruf zu verwenden. In diesen Situationen können Sie zwei Aktionen vom Typ Ereignis senden auf einer einzelnen Seite verwenden und die erste für die Personalisierung und die zweite für die Analyse verwenden. Wenn Sie die Ereignisse auf diese Weise aufteilen, kann das Personalisierungsereignis so früh wie möglich ausgelöst werden, während Sie warten, bis die Datenschicht vollständig geladen ist, bevor Sie das Analytics-Ereignis senden. Dies ist ähnlich wie bei vielen SDK-Implementierungen vor dem Web, bei denen Adobe Target den target-global-mbox
oben auf der Seite und Adobe Analytics den s.t()
-Aufruf unten auf der Seite auslöste
So erstellen Sie die „Personalization-on-top“-Anfrage:
-
all pages - library loaded - send event - 50
öffnen -
Öffnen der Aktion Ereignis senden
-
Wählen Sie Geführte Ereignisse verwenden und dann Personalisierung anfordern
-
Dadurch wird der Typ als Entscheidungsvorschlag abrufen
So erstellen Sie die Analytics-On-Bottom-Anfrage:
- Erstellen Sie eine neue Regel mit dem Namen
all pages - page bottom - send event - 50
- Fügen Sie der Regel ein Ereignis hinzu. Verwenden der Core-Erweiterung und des Ereignistyps Seitenende
- Fügen Sie der Regel eine Aktion hinzu. Verwenden der Erweiterung Adobe Experience Platform Web SDK und des Aktionstyps Ereignis senden“
- Wählen Sie Geführte Ereignisse verwenden und dann Analytics erfassen aus
- Dadurch wird das Kontrollkästchen Ausstehende Anzeigebenachrichtigungen einschließen aktiviert, damit die Anzeigebenachrichtigung aus der Entscheidungsanfrage in der Warteschlange gesendet wird.
Validieren mit dem Debugger
Nachdem die Regeln aktualisiert wurden, können Sie mithilfe des Adobe Debuggers überprüfen, ob die Daten korrekt weitergeleitet werden.
-
Navigieren Sie zur Demo-Site von Luma und melden Sie sich mit der E-Mail-
test@adobe.com
und demtest
an -
Navigieren zu einer Produktdetailseite
-
Öffnen Sie die Browser-Erweiterung Adobe Experience Platform Debugger und Sie die Tag-Eigenschaft in Ihre eigene Entwicklungseigenschaft
-
Seite neu laden
-
Wählen Sie das Netzwerk-Tool im Debugger aus und filtern Sie nach Adobe Experience Platform Web SDK
-
Wählen Sie den Wert in der Ereigniszeile für den ersten Aufruf aus
-
Beachten Sie, dass unter
data
>__adobe
>target
Schlüssel vorhanden sind und diese mit Informationen über das Produkt, die Kategorie und den Anmeldestatus gefüllt sind.
Validieren in der Target-Oberfläche
Überprüfen Sie anschließend in der Target-Oberfläche, ob Daten empfangen wurden und für die Verwendung in Zielgruppen und Aktivitäten verfügbar sind. XDM-Daten werden automatisch benutzerdefinierten Target-Parametern zugeordnet. Sie können überprüfen, ob XDM-Daten von Target empfangen wurden und verfügbar sind, indem Sie eine Zielgruppe erstellen.
-
Navigieren Sie zum Abschnitt Zielgruppen
-
Erstellen Sie eine Zielgruppe und wählen Sie Attributtyp Benutzerdefiniert“ aus
-
Suchen Sie im Parameter nach
web
. Das Dropdown-Menü sollte mit allen XDM-Feldern gefüllt werden, die sich auf die Web-Seitendetails beziehen.
Überprüfen Sie als Nächstes, ob das Profilattribut für den Anmeldestatus erfolgreich übergeben wurde.
-
Wählen Sie Attributtyp Besucherprofil“
-
Suchen Sie nach
loggedIn
. Wenn das Attribut im Dropdown-Menü verfügbar ist, wurde das Attribut korrekt an Target übergeben. Es kann mehrere Minuten dauern, bis neue Attribute in der Target-Benutzeroberfläche verfügbar werden.
Wenn Sie über Target Premium verfügen, können Sie auch überprüfen, ob die Entitätsdaten korrekt übergeben und die Produktdaten in den Recommendations-Produktkatalog geschrieben wurden.
-
Navigieren Sie zum Abschnitt Recommendations
-
Wählen Katalogsuche in der linken Navigationsleiste aus.
-
Suchen Sie nach der Produkt-SKU oder dem Produktnamen, die Sie zuvor auf der Luma-Site besucht haben. Das Produkt sollte im Produktkatalog angezeigt werden. Es kann mehrere Minuten dauern, bis neue Produkte im Recommendations-Produktkatalog durchsucht werden können.
Mit Assurance validieren
Darüber hinaus können Sie bei Bedarf Assurance verwenden, um zu bestätigen, dass Target-Entscheidungsanfragen die richtigen Daten erhalten und dass alle Server-seitigen Transformationen korrekt ausgeführt werden. Sie können auch bestätigen, dass die Kampagnen- und Erlebnisinformationen in den Adobe Analytics-Aufrufen enthalten sind, selbst wenn die Target-Entscheidungsaufrufe und die Adobe Analytics-Aufrufe separat gesendet werden.
-
Starten Sie eine neue Assurance-Sitzung, geben Sie Sitzungsnamen und die Basis-URL für Ihre Site oder eine andere Seite ein, die Sie testen
-
Klicken Sie auf Weiter
-
Wählen Sie Ihre Verbindungsmethode aus. In diesem Fall verwenden wir Link kopieren
-
Kopieren Sie den Link und fügen Sie ihn in eine neue Browser-Registerkarte ein.
-
Klicken Sie auf Fertig
-
Sobald Ihre Assurance-Sitzung gestartet wurde, werden auf der Registerkarte „Ereignisse“ die Ereignisse angezeigt
-
Filtern nach „tnta“
-
Wählen Sie den letzten Aufruf aus und erweitern Sie die Nachrichten, um sicherzustellen, dass er korrekt ausgefüllt wird, und beachten Sie die „tnta“-Werte
-
Behalten Sie als Nächstes den Filter „tnta“ bei und wählen Sie das Ereignis analytics.mapping aus, das nach dem soeben betrachteten Zielereignis auftritt.
-
Überprüfen Sie „context.mappedQueryParams“.<yourSchemaName>" Wert, um zu bestätigen, dass er ein „tnta“-Attribut mit einer verketteten Zeichenfolge enthält, die mit den „tnta“-Werten übereinstimmt, die im vorangehenden Zielereignis gefunden wurden.
Dadurch wird bestätigt, dass die A4T-Informationen, die zur späteren Übermittlung in die Warteschlange gestellt wurden, als der Target Decisioning-Aufruf durchgeführt wurde, ordnungsgemäß gesendet wurden, als der Analytics-Tracking-Aufruf später auf der Seite ausgelöst wurde.
Nachdem Sie nun diese Lektion abgeschlossen haben, sollten Sie über eine funktionierende Implementierung von Adobe Target mit der Platform Web SDK verfügen.