Einrichten von Adobe Target mit dem 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 all das bietet, was Sie benötigen, um das Kundenerlebnis anzupassen und zu personalisieren, sodass Sie Umsätze auf Ihren Web- und mobilen Sites, in Apps und anderen digitalen Kanälen maximieren können.

Lernziele

Am Ende dieser Lektion können Sie Folgendes mit einer Web SDK-Implementierung von Target tun:

Voraussetzungen

Um die Lektionen in diesem Abschnitt abzuschließen, müssen Sie zunächst:

Flackernde Behandlung hinzufügen

Stellen Sie vor dem Start fest, ob je nachdem, wie die Tag-Bibliothek geladen wird, eine zusätzliche Lösung zur Flackerverarbeitung erforderlich ist.

Asynchrone Implementierung

Wenn eine Tag-Bibliothek asynchron geladen wird, kann das Rendern der Seite abgeschlossen sein, bevor Target Standardinhalte durch personalisierte Inhalte ersetzt hat. Dieses Verhalten kann zum so genannten "Flackern"führen, bei dem kurz Standardinhalte angezeigt werden, bevor sie durch den personalisierten Inhalt ersetzt werden. Wenn Sie dieses Flimmern vermeiden möchten, empfiehlt Adobe, unmittelbar vor dem asynchronen Tag-Einbettungscode einen speziellen Codeausschnitt zur Vorab-Ausblendung hinzuzufügen.

Dieses Snippet ist bereits auf der Site "Luma"vorhanden, aber schauen wir uns genauer an, um zu verstehen, was dieser Code bewirkt:

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

Der vorab ausgeblendete Ausschnitt erstellt ein Stil-Tag im Seitenkopf mit der CSS-Definition Ihrer Wahl. Dieses Stil-Tag wird entfernt, wenn eine Antwort von Target empfangen wird oder die Zeitüberschreitung erreicht wird.

Das Verhalten der Vorab-Ausblendung wird durch zwei Konfigurationen am Ende des Ausschnitts gesteuert.

Der vorab ausgeblendete Ausschnitt ist auch innerhalb von Tags verfügbar:

Synchrone Implementierung

Adobe empfiehlt die asynchrone Implementierung von Tags, wie auf der Site "Luma"gezeigt. Wenn die Tag-Bibliothek jedoch synchron geladen wird, ist das vorab ausgeblendete Snippet nicht erforderlich. Stattdessen wird der Vorab-Ausblendestil in den Einstellungen der Platform Web SDK-Erweiterung angegeben.

Der Vorab-Ausblendestil für synchrone Implementierungen kann wie folgt konfiguriert werden:

Weiterführende Informationen zur Verwaltung von Flackern mit dem Platform Web SDK finden Sie im Abschnitt "Handbuch": Beheben von Flackern für personalisierte Erlebnisse.

Konfigurieren des Datenspeichers

Target muss in der Datastream-Konfiguration aktiviert sein, bevor Target-Aktivitäten vom Platform Web SDK bereitgestellt werden können.

So konfigurieren Sie Target im Datastream:

Eigenschafts-Token

Target Premium-Kunden haben die Möglichkeit, Benutzerberechtigungen mit Eigenschaften zu verwalten. Mit Target-Eigenschaften können Sie Grenzen festlegen, um die Benutzer Target-Aktivitäten ausführen können. Weitere Informationen finden Sie im Abschnitt Unternehmensberechtigungen der Target-Dokumentation.

Um Eigenschafts-Token einzurichten oder zu finden, navigieren Sie zu "Adobe Target"> "Administration"> "Eigenschaften". Das Symbol </> zeigt den Implementierungscode an. Der Wert at_property ist das Eigenschafts-Token, das Sie in Ihrem Datastream verwenden würden.

Pro Datastream kann nur ein Eigenschafts-Token angegeben werden, aber Eigenschafts-Token-Überschreibungen ermöglichen es Ihnen, alternative Eigenschafts-Token anzugeben, um das im Datastream definierte primäre Eigenschafts-Token zu ersetzen. Eine Aktualisierung der Aktion sendEvent ist auch erforderlich, um den Datastream zu überschreiben.

Target-Umgebungs-ID

Umgebungen in Target helfen Ihnen bei der Verwaltung Ihrer Implementierung in allen Phasen der Entwicklung. Diese optionale Einstellung gibt an, welche Target-Umgebung Sie für jeden Datastream verwenden werden.

Adobe empfiehlt, die Target-Umgebungs-ID für jeden Ihrer Entwicklungs-, Staging- und Produktionsdatastreams unterschiedlich festzulegen, um die Dinge einfach zu halten. Alternativ können Sie Ihre Umgebungen in der Target-Oberfläche mithilfe der Funktion hosts organisieren.

Um Umgebungs-IDs einzurichten oder zu finden, navigieren Sie zu "Adobe Target"> "Administration"> "Umgebungen".

Target-Drittanbieter-ID-Namespace

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 Namespace. Weitere Informationen finden Sie im Abschnitt Echtzeit-Profilsynchronisation für mbox3rdPartyId des Target-Handbuchs.

Die Identitätssymbole befinden sich in der Identitätsliste unter Datenerfassung > Kunde > Identitäten.

Verwenden Sie für die Zwecke dieses Tutorials mit der Site "Luma"das Identitätssymbol lumaCrmId , das während der Lektion über Identitäten eingerichtet wurde.

visuelle Personalisierungsentscheidungen rendern

Entscheidungen zur visuellen Personalisierung beziehen sich auf Erlebnisse, die im Visual Experience Composer von Adobe Target erstellt wurden. Zunächst sollten Sie die in den Target- und Tag-Schnittstellen verwendete Terminologie verstehen:

Aktualisieren der Aktion Ereignis senden

Entscheidungen zur visuellen Personalisierung von Target werden vom Platform Web SDK bereitgestellt, wenn Target im Datastream aktiviert ist. sie werden jedoch nicht automatisch gerendert. Sie müssen die Aktion Ereignis senden aktualisieren, um das automatische Rendering zu aktivieren.

Durch die Einstellung der visuellen Personalisierungsentscheidungen beim Rendern wendet das Platform Web SDK automatisch alle Änderungen an, die mit dem Target Visual Experience Composer oder der "globalen Mbox"angegeben wurden.

Wenn Sie diese Entscheidungen mithilfe von benutzerdefiniertem Code lieber selbst rendern oder bearbeiten möchten, können Sie die Einstellung visuelle Personalisierungsentscheidungen rendern deaktivieren. Das Platform Web SDK ist flexibel und bietet diese Möglichkeit, Ihnen vollständige Kontrolle zu geben. Weitere Informationen zum manuellen Rendern personalisierter Inhalte finden Sie im Handbuch .

Target-Aktivität mit dem Visual Experience Composer einrichten

Nachdem der grundlegende Implementierungsabschnitt abgeschlossen ist, erstellen Sie eine Erlebnis-Targeting-Aktivität (XT) in Target, um zu überprüfen, ob alles ordnungsgemäß funktioniert. Wenn Sie Hilfe benötigen, lesen Sie das Target-Tutorial zum Erstellen von Erlebnis-Targeting-Aktivitäten🔗.

Validieren mit dem Debugger

Wenn Sie eine Aktivität einrichten, sollten Ihre Inhalte auf der Seite wiedergegeben werden. Selbst wenn keine Aktivitäten live sind, können Sie sich auch den Netzwerkaufruf "Ereignis senden"ansehen, um zu bestätigen, dass Target ordnungsgemäß konfiguriert ist.

Einrichten und Rendern eines benutzerdefinierten Entscheidungsbereichs

Benutzerdefinierte Entscheidungsbereiche (ehemals "Mboxes") können verwendet werden, um HTML- oder JSON-Inhalte mit dem formularbasierten Experience Composer von Target strukturiert bereitzustellen. Inhalte, die an einen dieser benutzerdefinierten Bereiche gesendet werden, werden nicht automatisch vom Platform Web SDK gerendert. Sie kann mithilfe einer Aktion in Tags gerendert werden.

Fügen Sie der Aktion Ereignis senden einen Bereich hinzu.

Ändern Sie Ihre Seitenladeregel, um einen benutzerdefinierten Entscheidungsbereich hinzuzufügen:

Antwort von Target verarbeiten

Nachdem Sie das Platform Web SDK so konfiguriert haben, dass Inhalte für den Bereich homepage-hero angefordert werden, müssen Sie etwas mit der Antwort tun. Die Platform Web SDK-Tag-Erweiterung stellt ein Ereignis senden abgeschlossen -Ereignis bereit, mit dem sofort eine neue Regel Trigger werden kann, wenn eine Antwort von einer Ereignis senden -Aktion empfangen wird.

Target-Aktivität mit dem formularbasierten Experience Composer einrichten

Nachdem Sie jetzt über eine Regel verfügen, um einen benutzerdefinierten Entscheidungsbereich manuell zu rendern, können Sie eine weitere Erlebnis-Targeting-Aktivität (XT) in Target erstellen. Verwenden Sie diesmal den formularbasierten Experience Composer.

Validieren mit dem Debugger

Wenn Sie Ihre Aktivität aktiviert haben, sollte Ihr Inhalt auf der Seite gerendert werden. Selbst wenn keine Aktivitäten live sind, können Sie sich auch den Netzwerkaufruf Ereignis senden ansehen, um zu bestätigen, dass Target Inhalte für Ihre benutzerdefinierten Bereiche anfordert.

Parameter an Target senden

In diesem Abschnitt übergeben Sie Target-spezifische Daten und sehen sich genauer an, wie XDM-Daten Target-Parametern zugeordnet werden.

Seiten- (Mbox-)Parameter und XDM

Alle XDM-Felder werden automatisch als Seitenparameter oder Mbox-Parameter an Target übergeben.

Einige dieser XDM-Felder werden bestimmten Objekten im Target-Backend zugeordnet. Beispielsweise ist web.webPageDetails.URL automatisch verfügbar, um URL-basierte Targeting-Bedingungen zu erstellen, oder als page.url -Objekt, wenn Profilskripte erstellt werden.

Sie können Seitenparameter auch über das Datenobjekt 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 Target-Parametern gehören:

Diese Parameter müssen im Objekt data statt im Objekt xdm gesendet werden. Darüber hinaus können Seitenparameter (oder Mbox-Parameter) auch in das data -Objekt aufgenommen werden.

Um das Datenobjekt zu füllen, erstellen Sie das folgende Datenelement und verwenden Sie dabei die Datenelemente, die Sie in der Lektion Datenelemente erstellen erstellt haben:

Seitenladeregel aktualisieren

Das Übergeben zusätzlicher Daten für Target außerhalb des XDM-Objekts erfordert die Aktualisierung der entsprechenden Regeln. Für dieses Beispiel müssen Sie nur das neue Datenelement data.content in die generische Seitenladeregel und Produktseitenansichtsregel aufnehmen.

Aufteilen von Personalization- und Analytics-Anforderungen

Die Datenschicht auf der Site "Luma"ist vor dem Einbettungscode der Tags vollständig definiert. Auf diese Weise können wir einen einzigen Aufruf verwenden, um sowohl personalisierte Inhalte (z. B. aus Adobe Target) abzurufen als auch Analysedaten (z. B. an Adobe Analytics) zu senden.

Auf vielen Websites kann die Datenschicht jedoch nicht früh genug oder schnell genug geladen werden, um einen einzelnen Aufruf für beide Anwendungen zu verwenden. In diesen Situationen können Sie zwei Aktionen vom Typ Ereignis senden beim Laden 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 aufschlüsseln, kann das Personalisierungsereignis so früh wie möglich ausgelöst werden, während darauf gewartet wird, dass die Datenschicht vollständig geladen wird, bevor das Analytics-Ereignis gesendet wird. Dies ähnelt vielen Implementierungen des Pre-Web-SDK, bei denen Adobe Target den target-global-mbox oben auf der Seite auslöst und Adobe Analytics den s.t() -Aufruf am unteren Seitenrand auslöst.

So erstellen Sie die Personalisierungsanforderung:

So erstellen Sie die Analytics-on-bottom-Anforderung:

Validieren mit dem Debugger

Nachdem die Regeln aktualisiert wurden, können Sie überprüfen, ob die Daten mithilfe des Adobe Debuggers korrekt übergeben wurden.

Validierung in der Target-Oberfläche

Überprüfen Sie dann in der Target-Oberfläche, ob Daten empfangen wurden und für 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 durch Erstellen einer Zielgruppe verfügbar sind.

Überprüfen Sie anschließend, ob das Profilattribut für den Anmeldestatus erfolgreich übergeben wurde.

Wenn Sie über Target Premium verfügen, können Sie auch überprüfen, ob die Entitätsdaten korrekt übergeben wurden und die Produktdaten in den Recommendations-Produktkatalog geschrieben wurden.

Mit Assurance validieren

Darüber hinaus können Sie gegebenenfalls mithilfe von Assurance überprüfen, ob Target-Entscheidungsanfragen die richtigen Daten erhalten und ob serverseitige Umwandlungen korrekt durchgeführt werden. Sie können auch überprüfen, ob die Kampagnen- und Erlebnisinformationen in den Adobe Analytics-Aufrufen enthalten sind, selbst wenn die Target-Entscheidungsfindungs- und Adobe Analytics-Aufrufe separat gesendet werden.

Dadurch wird bestätigt, dass die A4T-Informationen, die bei der Zielbestimmungsaufruf zur späteren Übertragung in die Warteschlange gestellt wurden, ordnungsgemäß gesendet wurden, wenn der Analytics-Tracking-Aufruf später auf der Seite ausgelöst wurde.

Nachdem Sie diese Lektion abgeschlossen haben, sollten Sie über eine funktionierende Implementierung von Adobe Target mit dem Platform Web SDK verfügen.

Weiter: