SDKs initialisieren
Führen Sie die Schritte im Initialisieren von SDK aus, um sicherzustellen, dass alle erforderlichen Aufgaben zum Laden der Adobe Target JavaScript-Bibliothek „at.js“ in der richtigen Reihenfolge ausgeführt werden.
SDK-Initialisierungsdiagramm diagram
Bei mehrseitigen Anwendungen erfolgt dieser Fluss jedes Mal, wenn die Seite neu geladen wird oder der Besucher zu einer neuen Seite auf der Website navigiert.
Klicken Sie auf die folgenden Links, um zu den gewünschten Abschnitten zu navigieren:
- 1.1: Laden der Besucher-API SDK
- 1.2: Kunden-ID festlegen
- 1.3: Konfigurieren der automatischen Seitenladeanfrage
- 1.4: Konfigurieren der Flackerhandhabung
- 1.5: Konfigurieren der Datenzuordnung
- 1.6: Absatzförderung
- 1.7: Warenkorb-basierte Kriterien
- 1.8: Beliebtheitsbasierte Kriterien
- 1.9: Auf Artikeln basierende Kriterien
- 1.10: Benutzerbasierte Kriterien
- 1.11: Benutzerdefinierte Kriterien
- 1.12: Angabe der in Einschlussregeln verwendeten Attribute
- 1.13: ExcludeIds angeben
- 1.14: Übergeben Sie den Parameter entity.event.detailsOnly=true
- 1.15: Konfigurieren der Remote-Datenzuordnung
- 1.16: at.js laden
1.1: Laden der Besucher-API SDK load
Mit diesem Schritt können Sie sicherstellen, dass die VisitorAPI.js
Bibliothek ordnungsgemäß geladen, konfiguriert und initialisiert wird.
Voraussetzungen
- Um den Besucher-ID-/API-Service verwenden zu können, muss Ihr Unternehmen für die Adobe Experience Cloud aktiviert sein und über eine Organization ID verfügen. Weitere Informationen finden Sie unter Experience Cloud-Anforderungen: OrganisationsID im Identity Service-).
- Sie benötigen die
VisitorAPI.js
. Sie sollten diese Datei bereits haben, falls Sie sie implementiert Adobe Analytics. Diese Datei kann auch über die Adobe Experience Platform Tags-Erweiterung hinzugefügt oder aus dem Adobe Analytics Code Manager heruntergeladen.
Konfigurieren und Verweisen auf VisitorAPI.js
Weitere Informationen finden Sie unter Implementieren des Experience Cloud-Service für Target.
Messwerte
- Übersicht über den Experience Cloud Identity Service
- Über den ID-Service
- Cookies und der Experience Cloud Identity Service
- Anfordern und Festlegen von IDs durch den Experience Cloud Identity Service
- Grundlegendes zu ID-Synchronisierung und Übereinstimmungsraten
Aktionen
- Einbetten der
VisitorAPI.js
-Datei auf Ihren Web-Seiten. - Lesen Sie mehr über die verfügbaren Konfigurationen für den Besucher-ID-/API-Service.
- Nachdem die
VisitorAPI.js
geladen wurde, verwenden Sie dieVisitor.getInstance
Methode , um mit den erforderlichen Konfigurationen zu initialisieren. - Machen Sie sich mit den verfügbaren Methoden vertraut.
1.2: Kunden-ID festlegen set
Dieser Schritt stellt sicher, dass die bekannten IDs Ihrer Besucher (CRM-ID, Benutzer-ID usw.) zur geräteübergreifenden Personalisierung mit der anonymen ID von Adobe verknüpft sind.
Voraussetzungen
- Die bekannte ID der Besucher sollte in der Datenschicht verfügbar sein.
Kunden-ID festlegen
Weitere Informationen finden Sie unter setCustomerIDs.
Messwerte
Aktionen
- Verwenden Sie
visitor.setCustomerIDs
, um die bekannte Besucher-ID festzulegen.
Kehren Sie zum Diagramm oben auf dieser Seite zurück.
1.3: Konfigurieren der automatischen Seitenladeanfrage automatic
Dieser Schritt ermöglicht at.js das Abrufen aller Erlebnisse, die auf der Seite gerendert werden müssen, während die at.js-JavaScript-Bibliotheksdatei geladen wird.
Voraussetzungen
- Nicht alle Daten in der Datenschicht müssen an Target gesendet werden. Beraten Sie sich mit Ihrem Business-Team (Digital-Marketing-Team), um festzustellen, welche Daten für Experimente, Optimierungen und Personalisierungen nützlich sind. Nur diese Daten sollten an Target gesendet werden.
- Stellen Sie sicher, dass Sie keine personenbezogenen Daten (PII) an Target senden.
Konfigurieren der automatischen Seitenladeanfrage
Weitere Informationen finden Sie unter targetGlobalSettings().
Messwerte
Erfahren Sie mehr über die pageLoadEnabled
in targetGlobalSettings().
Aktionen
- Ändern Sie das
window.targetGlobalSettings
-Objekt, um automatische Seitenladeanfragen zu aktivieren.
1.4: Konfigurieren der Flackerhandhabung flicker
Mit diesem Schritt wird sichergestellt, dass beim Bereitstellen von Erlebnissen kein Seitenflackern auftritt.
Voraussetzungen
- Führen Sie mit dem für die Leistung der Web-Seite zuständigen Team eine Diskussion über die Vor- und Nachteile der Flimmerkontrolle mithilfe der von at.js verwendeten Standardmethode. Sie können nach Designmustern suchen, die Ihnen die Verwendung benutzerdefinierter Flimmerhandhabungslösungen ermöglichen, z. B. Loader-Animationen. Wenn Sie ein Muster nicht finden, können Sie ein neues Muster anfordern.
Konfigurieren der Flackerhandhabung
Weitere Informationen finden Sie unter targetGlobalSettings().
Wenn Sie bodyHidingEnabled
auf true
setzen, wird der gesamte Seitentext ausgeblendet, während die Seitenladeanforderung ausgeführt wird. Wenn Sie die automatische Seitenladeanforderung aus irgendeinem Grund nicht aktiviert haben (z. B. weil die Daten später nicht bereit sind), ist es am besten, diese Einstellung auf false
festzulegen.
Wenn Sie bodyHidingEnabled
deaktiviert haben, weil Sie APLR nicht auslösen möchten und die Seitenanforderung später auslösen möchten, oder keine Flackerbehandlung benötigen, müssen Sie Ihre eigene Flackerbehandlung implementieren. Flackern lässt sich auf zwei Arten handhaben: durch Ausblenden der zu testenden Abschnitte oder durch Anzeigen eines Thrombers auf den zu testenden Abschnitten.
Messwerte
- Verwaltung von Flackern mit „at.js“
- Erfahren Sie mehr über die Objekte bodyHiddenStyle und bodyHidingEnabled in targetGlobalSettings().
Aktionen
- Ändern Sie das
window.targetGlobalSettings
-Objekt, umbodyHiddenStyle
undbodyHidingEnabled
festzulegen.
1.5: Konfigurieren der Datenzuordnung data-mapping
Mit diesem Schritt stellen Sie sicher, dass alle Daten, die an Target gesendet werden müssen, festgelegt sind.
Voraussetzungen
-
Die Datenschicht sollte mit allen Daten bereit sein, die an Target gesendet werden müssen.
-
Recommendations: Profil anreichern.
- Übergeben Sie
entity.id
, um Daten für kürzlich angezeigte Kriterien und Elemente basierend auf Kriterien zu erfassen, die auf dem zuletzt angezeigten Produkt basieren. - Übergeben Sie
entity.id
, um Daten für Beliebtheitskriterien basierend auf der bevorzugten Kategorie zu erfassen. - Übergeben Sie das Profilattribut, wenn benutzerdefinierte Kriterien darauf basieren oder bei der Filterung von Einschlussregeln in beliebigen Kriterien verwendet werden.
- Übergeben Sie
-
Recommendations: Nehmen Sie Produktdaten auf.
- Andere Entitätsparameter (reserviert und benutzerdefiniert) können übergeben werden, um den Produktkatalog in Recommendations aufzunehmen oder zu aktualisieren.
- Der Produktkatalog kann auch mithilfe von Entitäts-Feeds aktualisiert werden, indem die Target-Benutzeroberfläche oder -API verwendet wird.
DatenTarget zuordnen
Weitere Informationen finden Sie unter targetPageParams().
Messwerte
Aktionen
- Verwenden Sie die Funktion
targetPageParams()
, um alle erforderlichen Daten festzulegen, die an Target gesendet werden müssen.
1.6: Absatzförderung promotion
Fügen Sie hochgestufte Elemente hinzu und steuern Sie deren Platzierung in Ihren Target Recommendations Designs.
Verfügbare Optionen
- Nach IDs hochstufen
- Nach Sammlung bewerben
- Hochstufen nach Attribut
Entitätsparameter erforderlich
- Das Elementattribut in der Promotion muss bei Verwendung der Option „Nach Attribut bewerben“ übergeben werden.
Kehren Sie zum Diagramm oben auf dieser Seite zurück.
1.7: Warenkorb-basierte Kriterien cart
Empfehlungen auf der Grundlage des Warenkorbinhalts des Benutzers aussprechen.
Verfügbare Kriterien
- People Who Viewed These, Viewed Those
- People Who Viewed These, Bought Those
- People Who Bought These, Bought Those
Entitätsparameter erforderlich
- cartIds
Messwerte
Kehren Sie zum Diagramm oben auf dieser Seite zurück.
1.8: Beliebtheitsbasierte Kriterien popularity
Empfehlungen auf der Grundlage der allgemeinen Popularität eines Elements auf Ihrer Website oder auf der Grundlage der Popularität von Elementen innerhalb der Lieblings- oder am häufigsten angezeigten Kategorie, Marke, Genre usw.
Verfügbare Kriterien
- Most Viewed Across the Site
- Most Viewed by Category
- Most Viewed by Item Attribute
- Top Sellers Across the Site
- Top Sellers by Category
- Top Sellers by Item Attribute
- Top by Analytics Metric
Entitätsparameter erforderlich
entity.categoryId
oder das Elementattribut für Beliebtheit, wenn das Kriterium auf dem aktuellen Element oder dem Elementattribut basiert.- Nichts darf für Am häufigsten angezeigt/Am häufigsten verkauft auf der Website weitergegeben werden.
Messwerte
1.9: Auf Artikeln basierende Kriterien item
Empfehlungen aussprechen, die darauf basieren, ähnliche Elemente zu finden wie ein Element, das der Benutzer gerade anzeigt oder kürzlich angeschaut hat.
Verfügbare Kriterien
- People Who Viewed This, Viewed That
- People Who Viewed This, Bought That
- People Who Bought This, Bought That
- Items with Similar Attributes
Entitätsparameter erforderlich
entity.id
oder ein als Schlüssel verwendetes Profilattribut
Messwerte
Kehren Sie zum Diagramm oben auf dieser Seite zurück.
1.10: Benutzerbasierte Kriterien user
Empfehlungen auf der Grundlage des Benutzerverhaltens aussprechen.
Verfügbare Kriterien
- Recently Viewed Items
- Recommended for You
Entitätsparameter erforderlich
entity.id
Messwerte
Kehren Sie zum Diagramm oben auf dieser Seite zurück.
1.11: Benutzerdefinierte Kriterien custom
Empfehlungen basierend auf einer benutzerdefinierten Datei geben, die Sie hochladen.
Verfügbare Kriterien
- Custom algorithm
Entitätsparameter erforderlich
entity.id
oder das als Schlüssel für den benutzerdefinierten Algorithmus verwendete Attribut
Messwerte
1.12: Angabe der in Einschlussregeln verwendeten Attribute inclusion
Kehren Sie zum Diagramm oben auf dieser Seite zurück.
1.13: ExcludeIds angeben exclude
Übergeben Sie Entitäts-IDs für Entitäten, die Sie aus Ihren Empfehlungen ausschließen möchten. Beispielsweise können Sie Artikel ausschließen, die sich bereits im Warenkorb befinden.
Kehren Sie zum Diagramm oben auf dieser Seite zurück.
1.14: Übergeben Sie den entity.event.detailsOnly=true
true
Verwenden Sie Entitätsattribute, um Produkt- oder Inhaltsinformationen an Target Recommendations zu übergeben.
Messwerte
Kehren Sie zum Diagramm oben auf dieser Seite zurück.
1.15: Konfigurieren der Remote-Datenzuordnung (remote)
Dieser Schritt stellt sicher, dass alle Daten, die an Target gesendet werden müssen, festgelegt sind.
Voraussetzungen
- Die Datenschicht sollte mit allen Daten bereit sein, die an Target gesendet werden müssen.
Einrichten von Datenanbietern
Weitere Informationen finden Sie unter Datenanbieter.
Messwerte
Aktionen
Verwenden Sie die Funktion targetPageParams()
, um alle erforderlichen Daten festzulegen, die an Target gesendet werden müssen.
1.16: at.js laden web
Dieser Schritt stellt sicher, dass die at.js-JavaScript-Bibliothek geladen und initialisiert wird.
Voraussetzungen
- Laden Sie die Bibliotheksdatei für
at.js 2.*x*
JavaScript herunter oder fragen Sie Ihr Digital-Marketing-Team.
Messwerte
- Funktionsweise von Target
- Funktionsweise von „at.js“
- Implementieren von Target ohne einen Tag-Manager
Aktionen
Betten Sie die Datei „at.js“ in alle Web-Seiten ein, auf denen Experimente, Optimierungen, Personalisierungen und Datenerfassungen durchgeführt werden müssen.
Kehren Sie zum Diagramm oben auf dieser Seite zurück.
Fahren Sie mit Schritt 2: Konfigurieren der Datenerfassung fort.