DokumentationAnalyticsImplementierungshandbuch

prop

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Admin
  • Entwickler

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.

TIP
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. 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, die das Web SDK verwenden

Props werden den folgenden Variablen zugeordnet:

  • XDM-Objekt: xdm._experience.analytics.customDimensions.props.prop1 - xdm._experience.analytics.customDimensions.props.prop75 - Listen-Props werden in einem separaten Satz von Feldern angegeben.
  • Datenobjekt: data.__adobe.analytics.prop1 - data.__adobe.analytics.prop75; oder data.__adobe.analytics.c1 - data.__adobe.analytics.c75 - Listen-Props sind in diesen Feldern enthalten.

Props, die die Adobe Analytics-Erweiterung verwenden

Sie können Props entweder beim Konfigurieren der Analytics-Erweiterung (globale Variablen) oder unter Regeln festlegen.

  1. Melden Sie sich bei der Adobe Experience Platform-Datenerfassung mit Ihren Adobe ID-Anmeldeinformationen an.
  2. Klicken Sie auf die gewünschte Tag-Eigenschaft.
  3. Gehen Sie zur Registerkarte „Regeln“ und klicken Sie dann auf die gewünschte Regel (oder erstellen Sie eine Regel).
  4. Klicken Sie unter Aktionen auf eine bestehende Aktion Adobe Analytics – Variablen festlegen oder klicken Sie auf das Pluszeichen.
  5. Setzen Sie die Dropdownliste Erweiterung auf Adobe Analytics und den Aktionstyp 3} auf Variablen festlegen.
  6. Suchen Sie den Abschnitt Props.

Sie können eine Prop auf einen Wert oder ein Datenelement festlegen. Sie können den Wert auch aus einer anderen Analytics-Variablen kopieren.

s.prop1 – s.prop75 in AppMeasurement und im benutzerdefinierten Code-Editor der Analytics-Erweiterung

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

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.

Konfigurieren von Listen-Props

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.

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

Festlegen von Listen-Props mit dem Web SDK list-props-web-sdk

Bei Verwendung des XDM-Objekts werden Listen-Props xdm._experience.analytics.customDimensions.listProps.prop1.values[] - xdm._experience.analytics.customDimensions.listProps.prop75.values[] zugeordnet. 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. xdm._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.

Bei Verwendung des Datenobjekts verwenden Listen-Props dieselben Felder wie Standard-Props und befolgen die AppMeasurement-Syntax.

Festlegen von Listen-Props mit der Adobe Analytics-Erweiterung und AppMeasurement

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";
IMPORTANT
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.

recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690