String Attribute

[#1]

• Overview
• Create a String
• Add anEnrichment
• Applya Rule
• Usage Example

Overview

A String Attribute stores a text value about a Visitor, Visit, or Event. Examples include: Gender, Last Name, Favorite Product, and Membership Type.

Create a String

• Enter a descriptive Title for the Attribute.
• In the Notes field, enter any comments or annotations.
• Set the Scope to either Visitor' or 'Current Visit'. Scope specifies how long the data describing the visitor or the visitor's current session/visit persists.
  • Visitor: Select this if the Attribute describes the visitor or if this data has to persist longer than the visit. Attributes scoped to Visitor persist after the current visit ends.
  • Current Visit: Select this if the Attribute describes the current visit. Attribute values scoped to Current Visit do not persist longer than the visit.
• Click the checkbox for "Personal Information" if the visitor trait contains sensitive information like a credit card number. Note that a String Attribute marked as Personal Info will not be available for Data Layer Enrichment.

Add an Enrichment

Setting up an Enrichment is how you change or update a String to make certain you receive the most recent data. There are two Enrichments for a String Attribute: Set String and Split String.

1. Click the 'Create an Enrichment' button. Select Set String.

2. Set a value for this instance of String. There are two ways to do this:

• Enter a numeric/alphanumeric value in the "Custom Value" text box.
• Or make a selection from the drop-down list.

NOTE: The drop-down provides only String Attributes and Tealium iQ Data Sources. Didn't find the String in the dropdown? Click the "Add String" button and create a new instance.

3. Select a trigger from the WHEN dropdown. This tells AudienceStream when to listen for changes that require enriching an Attribute.

• New Visitor: Enrichment will occur when the visitor is new to your site.
• New Visit: Enrichment will occur on a new visit by a visitor.
• Any page event: Enrichment will occur on any page where your rule conditions are met. If you're not certain which selection to make, choose this one.
• Visit ended: Enrichment will occur when a visit ends.

4. Repeat steps 1 to 3 if you wish to create additional Enrichments.

Apply a Rule

Rules define the precise conditions that determine when to Enrich an Attribute. When configuring a new Attribute, you have the option to apply a predefined Rule or create a new Rule.

• To apply a predefined Rule, make a selection from the drop-down list and click the 'Attach This Rule' button.
• To apply a new Rule, click the 'Create a New Rule' button. For more information on how to create a new Rule, click here.

NOTE: Adding a new Rule via the Enrichments dialog box automatically applies it to the Enrichment.

Finally, click the Save/Publish at the top-right corner to save and publish the changes to your profile. This completes the String Attribute configuration.

Usage Example

An email address is unique and expressed as a string value, making it a good fit for the String Attribute. Prior to setting the String, you must capture the visitor's email address with a UDO Variable, like "customer_email", in your Data Layer ( how to add Data Sources in Tealium iQ?).

Step 1. Add a new String Attribute.

Title: Customer Email
Scope: Visitor

Step 2. Create the Set String Enrichment and set it to the customer's email address. Then specify the triggering event and Rule conditions.

Set String to: customer_email (Tealium iQ Data Source)
WHEN: Any page event 
Attach/Create Rule: customer_email Is Assigned AND customer_email Contains "@"