This help page describes how to implement props. For information on how props work as a dimension, see prop in the Components user guide.
Props are custom variables that you can use however you'd like. They do not persist beyond the hit that they are set.
Adobe recommends using eVars in most cases. In previous versions of Adobe Analytics, props and eVars had advantages and disadvantages to each other. However, Adobe has improved eVars to where they fulfill almost all use cases for props.
If you have a solution design document , you can allocate these custom dimensions to values specific to your organization. The number of available props depends on your contract with Adobe. Up to 75 props are available if your contract with Adobe supports it.
Props in Adobe Experience Platform Launch
You can set props either while configuring the Analytics extension (global variables) or under rules.
- Log in to launch.adobe.com using your AdobeID credentials.
- Click the desired property.
- Go to the Rules tab, then click the desired rule (or create a rule).
- Under Actions, click an existing Adobe Analytics - Set Variables action or click the '+' icon.
- Set the Extension dropdown to Adobe Analytics, and the Action Type to Set Variables.
- Locate the Props section.
You can set a prop to a value or a data element. You can also copy the value from another Analytics variable.
s.prop1 - s.prop75 in AppMeasurement and Launch custom code editor
Each prop variable is a string that contains custom values specific to your organization. Their max length is 100 bytes; values longer than 100 bytes are automatically truncated when sent to Adobe.
s.prop1 = "Example custom value";
List props are a setting applied to props that allow the variable to hold multiple values in the same hit. If this setting is not enabled, or if the wrong delimiter is used, the variable is treated as a single value.
Configure list props
Enable list props in report suite settings. See Traffic variables in the Admin user guide. Make sure that the desired delimiter is configured correctly. Adobe does not provide a default delimiter.
Common delimiters used in implementations are a comma ( , ), colon ( : ), semicolon ( ; ), or pipe ( | ). You can use any delimiter that best fits your implementation.
Set list props
Once you configure list props in report suite settings with the desired delimiter, there are no implementation differences other than using the delimiter.
// List prop delimited with a comma s.prop1 = "value1,value2,value3";
List props are still subject to the 100-byte maximum length. List props are easier to hit this limit and be truncated, since they can contain multiple values. Consider using abbreviations or shortening values if you might hit this 100-byte limit.
If you set the same value more than once in a list prop, they are de-duplicated in reporting. Analysis Workspace counts the number of hits where a value is seen, and not the number of times a value exists in data.