Profilattribute

Profilattribute sind Parameter, die speziell für einen Besucher gelten. Diese Attribute werden im Besucherprofil gespeichert, um Informationen über den Besucher bereitzustellen, die in den Aktivitäten verwendet werden können.

Ein Profil eines Benutzers enthält demografische und verhaltensbezogene Informationen über einen Besucher einer Webseite, z. B. Alter, Geschlecht, erworbene Produkte, letzte Besuchszeit usw. Diese Zielgruppe verwendet diese Informationen, um die Inhalte, die dem Besucher zur Verfügung stehen, zu personalisieren.

Wenn ein Besucher auf Ihrer Website surft oder der Besucher zu einer anderen Sitzung zurückkehrt, können die im Profil gespeicherten Profil-Attribute zur Zielgruppe von Inhalten oder Protokollinformationen für die Segmentfilterung verwendet werden.

So richten Sie Profil-Attribute ein:

1. Klicken Sie auf Audiencen > Profil-Skripte.

   

2. Klicken Sie auf Skript erstellen.

   

   Die folgenden Typen von Profilattributen sind verfügbar:

   Parametertyp	Beschreibung
   mbox	Direkt über den Seiten-Code beim Erstellen der Mbox weitergegeben Siehe Übergeben von Parametern an eine globale Mbox. Hinweis: Target erlaubt pro Mbox-Aufruf maximal 50 eindeutige Profilattribute. Wenn Sie mehr als 50 Profilattribute an Target übergeben müssen, können Sie hierzu die API-Methode Profilupdate nutzen. Weitere Informationen finden Sie unter Profilupdate in der Dokumentation zur Adobe Target-API.
   Profil	Direkt mit einem JavaScript-Codebeispiel definiert. Mit diesen können laufende Gesamtsummen wie das insgesamt vom Kunden ausgegebene Geld gespeichert werden. Die Skripte können bei jeder Mbox-Anfrage ausgeführt werden. Siehe Profilskriptattribute unten.

Profilskriptattribute

Definieren Sie ein Profilskriptattribut mit dem zu diesem gehörigen JavaScript-Code-Snippet.

Mithilfe von Profilskripten können Sie Besucherattribute über mehrere Besuche hinweg erfassen. Profilskripte sind Code-Snippets, die in Target festgelegt werden und eine Form serverseitigen JavaScript verwenden. Beispielsweise könnten Sie ein Profilskript verwenden, um aufzuzeichnen, wie oft ein Besucher auf Ihre Seite kommt und wann er sie zuletzt aufgerufen hat.

Profilskripte sind nicht das Gleiche wie Profilparameter. Profilparameter zeichnen mit der Implementierung des Mbox-Codes von Target Benutzerdaten auf.

Profilskripte erstellen

Profilskripte sind in der Registerkarte Zielgruppen in der Oberfläche von Target zu finden.

Um ein neues Profilskript hinzuzufügen, klicken Sie auf die Registerkarte Profilskripte, Skript erstellen und schreiben Sie dann das Skript.

Oder

Um ein vorhandenes Skript zu kopieren, halten Sie den Mauszeiger in der Liste Profil-Skripte über das gewünschte Profil und klicken Sie dann auf das Symbol Kopieren:

Sie können die Zielgruppe anschließend bearbeiten, um eine ähnliche Zielgruppe zu erstellen.

Profilskripte führen Profilattribut-„Fänger“ bei jeder Ortsanforderung aus. Beim Empfang einer Ortsanforderung bestimmt Target, welche Aktivität ausgeführt werden soll, und zeigt den für diese Aktivität und das Erlebnis geeigneten Inhalt an. Das Programm verfolgt den Erfolg der Aktivität und führt relevante Profilskripte aus. Auf diese Weise können Sie Informationen zum Besuch nachverfolgen, z. B. Ort, Tageszeit, Anzahl der Besuche auf der Site durch den Besucher, ggf. frühere Einkäufe usw. Diese Informationen werden dann zum Benutzerprofil hinzugefügt, sodass Sie die Besucheraktivitäten auf Ihrer Site besser verfolgen können.

Profilskriptattribute haben das user.-Tag vor dem Attributnamen eingefügt. Beispiel:

if (mbox.name == 'Track_Interest') { 
    if (profile.get('model') == "A5" &&; profile.get('subcat') == "KS6") { 
        return (user.get('A5KS6') || 0) + 1; 
    } 
}

Beachten Sie die folgenden Informationen:

• Siehe Profilskriptattribute (auch das im Code enthaltene) im Code mit user.get('parameterName').
• Speichern Sie Variablen, die beim nächsten Ausführen des Skripts (bei der nächsten mbox-Anfrage) aufgerufen werden könnten, mit user.setLocal('variable_name', 'value'). Verweisen Sie auf die Variable mit user.getLocal('variable_name'). Dies ist hilfreich in Situationen, in denen Sie einen Verweis für Datum und Uhrzeit der letzten Anfrage setzen möchten.
• Bei Parametern und Werten wird zwischen Groß- und Kleinschreibung unterschieden. Achten Sie auf die Groß- und Kleinschreibung der Parameter und Werte, die Sie während der Aktivität oder dem Test empfangen.
• Weitere JavaScript-Syntax finden Sie im Abschnitt „JavaScript-Referenz für Skript-Profilparameter“.
• Der Parameter bleibt nach dem Deaktivieren des Profils im Skript. Benutzer, deren Profil bereits einen Parameter enthalten, der in der Audience einer Aktivität verwendet wird, können sich für diese Aktivität qualifizieren.
• Profil-Skripten können nicht gelöscht werden, während sie in einer Aktivität verwendet werden.
• Es wird nicht empfohlen, Skripte mit abhängigen Profilen zu erstellen, die das Ergebnis eines Profil-Skripts in einem anderen Profil-Skript verwenden. Die Reihenfolge der Ausführung von Profil-Skripten ist nicht garantiert.

Anzeigen der Karten mit Profilskriptinformationen

Sie können Popupkarten mit Profilskriptinformationen (ähnlich den Karten mit Angebotsinformationen) anzeigen. Auf diesen Karten mit Profilskriptinformationen können Sie die Liste der Aktivitäten, die auf das ausgewählte Profilskript verweisen, sowie weitere nützliche Metadaten anzeigen.

Sie können beispielsweise auf folgende Karte mit Profilskriptinformationen zugreifen, indem Sie in der Liste mit Profilskripten (Zielgruppen > Profilskripte) mit dem Mauszeiger über ein Profilskript fahren und auf das Informationssymbol klicken.

Die Registerkarte Skriptinformationen enthält folgende Informationen: Name, Status, Token-Typ, Skript-ID, Änderungsprotokoll und Beschreibung.

Die Registerkarte Nutzung von Skripten enthält die Aktivitäten (und ihre Arbeitsbereiche), die auf das ausgewählte Profilskript verweisen.

Target deaktiviert in bestimmten Situationen Profilskripte

Target deaktiviert Profil-Skripten in bestimmten Situationen automatisch, z. B. wenn die Ausführung zu lange dauert oder zu viele Anweisungen vorliegen.

Wird ein Profilskript deaktiviert, erscheint in der Target-Benutzeroberfläche neben dem betroffenen Skript ein gelbes Warnsymbol, wie unten dargestellt:

Halten Sie den Mauszeiger darüber, werden Fehlerdetails angezeigt, wie unten dargestellt:

Typische Gründe für die Deaktivierung von Profilskripten durch das System sind unter anderem folgende:

• Es wird eine nicht definierte Variable referenziert.
• Ein ungültiger Wert wird referenziert. Dies geschieht häufig aufgrund des Bezugs auf URL-Werte und andere vom Benutzer eingegebene Daten, die nicht ordnungsgemäß validiert wurden.
• Zu viele JavaScript-Anweisungen wurden verwendet. Target verfügt über einen Maximalwert von 2.000 JavaScript-Anweisungen pro Skript, die Anzahl kann jedoch nicht einfach durch manuelles Lesen des JavaScript bestimmt werden. Rhino beispielsweise behandelt alle Funktionsaufrufe und „neuen“ Aufrufe als 100 Anweisungen. Das bedeutet, dass jeder Aufruf einer Funktion 100 Anweisungen erfordert. Außerdem kann sich die Größe der eingegebenen Daten (beispielsweise der URL-Werte) auf die Anzahl der Anweisungen auswirken.
• Nichtbefolgen der unten beschriebenen Best Practices.

Best Practices.

Die folgenden Richtlinien helfen Ihnen dabei, vereinfachte Profilskripte zu verfassen, die möglichst fehlerfrei sind. Sie können Code schreiben, der so fehlschlägt, dass die Skripts ohne erzwungenes Beenden des Skripts durch das System verarbeitet werden. Diese Leitlinien sind das Ergebnis der Best Practices, die für eine effiziente Funktionsweise nachgewiesen wurden. Diese Richtlinien gelten neben den Grundsätzen und Empfehlungen der Rhino-Entwicklungsgemeinde.

• Stellen Sie den aktuellen Skriptwert auf eine lokale Variable im Benutzerskript ein, und legen Sie einen Failover auf eine leere Zeichenfolge fest.

• Validieren Sie die lokale Variable, indem Sie sicherstellen, dass sie kein leerer String ist.

• Verwenden Sie stringbasierte Manipulationsfunktionen im Vergleich zu regulären Ausdrücken.

• Verwenden Sie limited for- bzw. open ended for-Schleifen oder while-Schleifen.

• Halten Sie die Vorgabe von maximal 1.300 Zeichen bzw. 50 Schleifeniterationen ein.

• Überschreiten Sie nicht die Maximalzahl von 2.000 JavaScript-Anweisungen. Target verfügt über einen Maximalwert von 2.000 JavaScript-Anweisungen pro Skript, die Anzahl kann jedoch nicht einfach durch manuelles Lesen des JavaScript bestimmt werden. Rhino beispielsweise behandelt alle Funktionsaufrufe und „neuen“ Aufrufe als 100 Anweisungen. Außerdem kann sich die Größe der eingegebenen Daten (beispielsweise der URL-Werte) auf die Anzahl der Anweisungen auswirken.

• Berücksichtigen Sie nicht nur die individuelle Skriptperformance, sondern auch die Performance aller Skripte. Als Best Practice empfehlen wir insgesamt weniger als 5.000 Anweisungen. Die Zählung der Anzahl der Anweisungen ist nicht offensichtlich, aber es ist wichtig zu beachten, dass Skripte mit mehr als 2.000 Anweisungen automatisch deaktiviert werden. Die Anzahl der aktiven Profil-Skripten darf 300 nicht überschreiten. Jedes Skript wird mit jedem einzelnen Mbox-Aufruf ausgeführt. Führen Sie also nur so viele Skripte aus wie nötig.

• Bei einem Regex ist fast nie Punkt-Stern am Beginn (z. B.: /.*match/, /a|.*b/) erforderlich. Die Regex-Suche beginnt auf allen Positionen in einer Zeichenfolge (außer wenn durch ^ begrenzt), sodass Punkt-Stern bereits vorausgesetzt wird. Die Skriptausführung kann unterbrochen werden, wenn ein solcher Regex mit langen Eingabedaten abgeglichen wird (kann auch mehrere hundert Zeichen lang sein).

• Schlägt alles fehl, verpacken Sie das Skript in einer try/catch-Anweisung.

• Die folgenden Empfehlungen helfen Ihnen, die Komplexität von Profil-Skripten zu begrenzen. Profil-Skripten können eine begrenzte Anzahl von Anweisungen ausführen.

  Als Best Practice:

  • Halten Sie Profil-Skripten klein und so einfach wie möglich.
  • Vermeiden Sie reguläre Ausdrücke oder verwenden Sie nur sehr einfache reguläre Ausdrücke. Sogar einfache Ausdruck können viele Anleitungen zur Bewertung verwenden.
  • Rekursion vermeiden.
  • Profil-Skripten sollten vor dem Hinzufügen zur Zielgruppe einem Leistungstest unterzogen werden. Alle Profil-Skripten werden bei jeder mbox-Anfrage ausgeführt. Wenn Profil-Skripten nicht korrekt ausgeführt werden, dauert die Ausführung von Mbox-Anfragen länger. Dies könnte sich auf Traffic und Umrechnung auswirken.
  • Wenn Profil-Skripten zu komplex werden, sollten Sie stattdessen Antwort-Token verwenden.

• Weitere Informationen finden Sie in der Dokumentation zur JS Rhino-Engine: https://www.mozilla.org/rhino/doc.html.

Profilskripte debuggen

Folgende Methoden können Sie zum Debugging von Profilskripten verwenden:

• Profilskripte als Antworttoken hinzufügen, um Profilskripte zu debuggen:

  Klicken Sie in der Zielgruppe auf Administration, klicken Sie auf Antworttoken und aktivieren Sie dann das Profil-Skript, das Sie debuggen möchten.

  Jedes Mal, wenn Sie eine Seite Ihrer Site laden, die Target enthält, enthält die Antwort von Target wie unten gezeigt Ihren Wert für das entsprechende Profilskript:

  

• mboxTrace-Debugging-Tool verwenden, um Profilskripte zu debuggen:

  Für diese Methode ist ein Autorisierungstoken erforderlich, das Sie durch Klicken auf Zielgruppe > Administration > Implementierung > Autorisierungstoken generieren im Abschnitt Debugger-Tools erstellen können.

  Fügen Sie anschließend diese beiden Parameter Ihrer Seiten-URL nach dem „?“ hinzu: mboxTrace=window&authorization=YOURTOKEN.

  Dieses Token enthält etwas mehr Informationen als das Antworttoken, da Sie hiermit einen Snapshot Ihres Profils vor und nach der Ausführung erhalten. Darüber hinaus enthält es all Ihre verfügbaren Profile.

  

Häufig gestellte Fragen zu Profilskripten

Kann ich mit Profilskripten Informationen von einer Seite erfassen, die sich im Daten-Layer befindet?

Profilskripte können die Seite nicht direkt lesen, da sie serverseitig ausgeführt werden. Die Daten müssen über eine Mbox-Anfrage oder andere Verfahren für die Datenübernahme in Target übergeben werden. Sobald die Daten in Target verfügbar sind, können sie von Profilskripten als Mbox- oder Profil-Parameter ausgelesen werden.

JavaScript-Referenz für Skript-Profilparameter

Einfaches Javascript-Wissen erforderlich, um Skript-Profil effektiv zu verwenden
Parameter. Dieser Abschnitt dient als kurze Referenz, um Sie in wenigen Minuten mit dieser Funktionalität vertraut zu machen.

Skript-Profilparameter befinden sich auf der Registerkarte „mboxes/profile“. Sie können Javascript-Programme schreiben, die einen beliebigen Javascript-Typ (Zeichenfolge, Ganzzahl, Array usw.) zurückgeben.

Beispiele für Skript-Profilparameter

**Name:**user.recency

var dayInMillis = 3600 * 24 * 1000;
if (mbox.name == 'orderThankyouPage') {
    user.setLocal('lastPurchaseTime', new Date().getTime());
}
var lastPurchaseTime = user.getLocal('lastPurchaseTime');
if (lastPurchaseTime) {
    return ((new Date()).getTime() - lastPurchaseTime) / dayInMillis;
}

Erstellt eine Variable für den Tag in Millisekunden. Wenn der mbox-Name orderThankyouPage lautet, legen Sie ein lokales (unsichtbares) Benutzerprofilattribut mit dem Namen lastPurchaseTime des aktuellen Datums und der aktuellen Uhrzeit fest. Der Wert der letzten Kaufzeit wird gelesen. Wenn definiert, geben wir die Zeit zurück, die seit der letzten Kaufzeit vergangen ist, dividiert durch die Anzahl der Millisekunden an einem Tag (was zu der Anzahl der Tage seit dem letzten Kauf führt).

Name: user.frequency

var frequency = user.get('frequency') || 0;
if (mbox.name == 'orderThankyouPage') {
    return frequency + 1;
}

Erstellt eine Variable mit dem Namen frequency und initialisiert sie entweder auf den vorherigen Wert oder auf 0, wenn kein vorheriger Wert vorhanden ist. Wenn der mbox-Name orderThankyouPage lautet, wird der inkrementierte Wert zurückgegeben.

**Name:**user.monetaryvalue

var monetaryValue = user.get('monetaryValue') || 0;
if (mbox.name == 'orderThankyouPage') {
    return monetaryValue + parseInt(mbox.param('orderTotal'));
}

Erstellt eine Variable namens monetaryValue, die den aktuellen Wert für einen bestimmten Besucher ermittelt (oder auf 0 setzt, wenn kein vorheriger Wert vorhanden war). Wenn der mbox-Name orderThankyouPage lautet, wird der neue Geldwert zurückgegeben, indem der vorherige und der Wert des an die Mbox übergebenen orderTotal Parameters hinzugefügt werden.

Name: adobeQA

if (page.param("adobeQA"))
     return page.param("adobeQA");
else if (page.param("adobeqa"))
     return page.param("adobeqa");
else if (mbox.param("adobeQA"))
     return mbox.param("adobeQA");

Erstellt eine Variable mit dem Namen adobeQA zur Benutzerverfolgung für Aktivität QA.

Objekte und Methoden

Die folgenden Eigenschaften und Methoden können durch Skript-Profilparameter referenziert werden:

Allgemeine Operatoren

Alle standardmäßigen JavaScript-Operatoren sind vorhanden und können verwendet werden. JavaScript-Operatoren können für Zeichenfolgen und Zahlen (sowie andere Datentypen) verwendet werden. Ein schnelles Briefing:

Schulungsvideo: Profil-Skripten

In diesem Video erfahren Sie, wie Profilskripte erstellt und verwendet werden.

• Erläuterung von Profilskripten
• Erläuterung der Unterschiede zwischen Profilskripten und Profilparametern
• Erstellen eines einfachen Profilskripts
• Verwenden des Menüs „Verfügbare Token“ für den Zugriff auf verfügbare Optionen
• Aktivieren und Deaktivieren von Profilskripten