Auf dieser Hilfeseite wird die Implementierung von Props beschrieben. Informationen dazu, wie Props als Dimension funktionieren, finden Sie unter Props im Komponenten-Benutzerhandbuch.
Props sind benutzerdefinierte Variablen, die Sie beliebig verwenden können. Sie bleiben nicht über den von ihnen festgelegten Treffer hinaus bestehen.
Adobe empfiehlt in den meisten Fällen die Verwendung von eVars. In früheren Versionen von Adobe Analytics hatten Props und eVars Vorteile und Nachteile. Die Adobe hat eVars jedoch insofern verbessert, als sie nun fast alle Anwendungsfälle für Props erfüllen.
Wenn Sie über ein Lösungs-Design-Dokument verfügen, können Sie diese benutzerspezifischen Dimensionen den unternehmensspezifischen Werten zuordnen. Die Anzahl der verfügbaren Props hängt von Ihrem Vertrag mit Adobe ab. Es sind bis zu 75 Props verfügbar, wenn Ihr Vertrag mit Adobe dies unterstützt.
Props sind für Adobe Analytics unter den XDM-Feldern _experience.analytics.customDimensions.props.prop1
bis _experience.analytics.customDimensions.props.prop75
zugeordnet. Listen-Props werden in einem separaten Satz von Feldern spezifiziert.
Sie können Props entweder beim Konfigurieren der Analytics-Erweiterung (globale Variablen) oder unter Regeln festlegen.
Sie können eine Prop auf einen Wert oder ein Datenelement festlegen. Sie können den Wert auch aus einer anderen Analytics-Variablen kopieren.
Jede Prop-Variable ist eine Zeichenfolge, die für Ihr Unternehmen spezifische benutzerdefinierte Werte enthält. Die maximale Länge beträgt 100 Byte. Werte, die länger als 100 Byte sind, werden beim Senden an Adobe automatisch abgeschnitten.
s.prop1 = "Example custom value";
Listen-Props sind eine Einstellung, die auf Props angewendet wird, mit denen die Variable mehrere Werte im selben Treffer enthalten kann. Wenn diese Einstellung nicht aktiviert ist oder das falsche Trennzeichen verwendet wird, wird die Variable als einzelner Wert behandelt.
Aktivieren Sie Listen-Props in Traffic-Variablen unter den Report Suite-Einstellungen. Vergewissern Sie sich, dass das gewünschte Trennzeichen richtig konfiguriert ist. Adobe stellt kein Standardtrennzeichen bereit.
Bei Implementierungen werden häufig Trennzeichen wie Komma (,
), Doppelpunkt (:
), Semikolon (;
) oder der senkrechte Strich (|
) verwendet. Sie können jedes beliebige nicht-erweiterte ASCII-Trennzeichen verwenden, das am besten zu Ihrer Implementierung passt.
Nachdem Sie Listen-Props in den Report Suite-Einstellungen mit dem gewünschten Trennzeichen konfiguriert haben, werden Listen-Props für Adobe Analytics unter _experience.analytics.customDimensions.listProps.prop1.values[]
bis _experience.analytics.customDimensions.listProps.prop75.values[]
zugewiesen. Das Web SDK verwendet automatisch das richtige Trennzeichen, das unter den Report Suite-Einstellungen aufgeführt ist. Wenn Sie das Trennzeichen im XDM-Feld festlegen (z. B. _experience.analytics.customDimensions.props.prop1.delimiter
), wird das Trennzeichen überschrieben, das automatisch aus den Report Suite-Einstellungen abgerufen wird, was zu einer falschen Analyse der Listen-Prop-Zeichenfolge führen kann.
Sobald Sie Listen-Props in den Report Suite-Einstellungen mit dem gewünschten Trennzeichen konfigurieren, gibt es außer der Verwendung des Trennzeichens keine weiteren Implementierungsunterschiede.
// List prop delimited with a comma
s.prop1 = "value1,value2,value3";
Listen-Props unterliegen weiterhin der maximalen Länge von 100 Byte. Listen-Props können diese Grenze leichter erreichen und abgeschnitten werden, da sie mehrere Werte enthalten können. Erwägen Sie die Verwendung von Abkürzungen oder die Verkürzung von Werten, wenn Sie diesen Grenzwert von 100 Byte erreichen.
Wenn Sie denselben Wert mehr als einmal in einer Listen-Prop festlegen, werden diese Werte in Berichten dedupliziert. Analysis Workspace zählt die Anzahl der Treffer, bei denen ein Wert angezeigt wird, und nicht, wie oft ein Wert in Daten vorhanden ist.