After you create a Property Group and assign properties to that group, you can begin creating messages. One of the greatest values of a Property Group message is the ability to modify aspects of a message for each individual property connected to a Property Group. To do this, use our Message Variables section in Dialogue's Message Builder in a message in your Property Group. Note: variables are not available in message builder in individual properties.
Creating a Message Variable:
Open an existing message or create a new message in your Property Group. This opens the Sourcepoint Message Builder.
Open message builder and click on "Add Message Variables" located in the bottom right corner of the message builder (see red circle below). This will open an iframe (shown below) for you to create and edit variables.
Note: Sourcepoint variable macro setup uses $$ before and after the variable (i.e. $$VariableName$$).
Now you can create a new variable. First edit the text between the $$ and $$ (highlighted below).
Next you can add a value for that variable as the default. You can use any string as a variable value. Most common are url links, CSS styling, or an image source. Finally, click the "+Add Variable" button (circled in red below) to create your newly defined variable and default value.
Once you have created your new variable you will see it listed in the Master Variable List (see image below). This Master Variable List is labeled at the top of the section, under where you create a new variable, as well on the top of the list on the left side of the iframe. The fact that the Master Variable List below is what you are currently editing is denoted by a green line to the left of the title in the left column.
Note: After you have created and saved your first variable(s), you will notice the "Add Message Variable" label changes to "Edit Message Variables" at the bottom right of your message builder.
To edit (aka override) the default values for an individual property, use the list on the left (sample property highlighted in red below). This list includes all properties assigned to the Property Group when this message was created. You will also see a green line to the left of the property name to denote which property you are currently editing. Simply enter a new value in the box for your "Sample_Variable" shown in dark gray below.
Click Save Changes to save your variables and edits and exit the message variable iframe.
Click the "Save" button at the top right of the message builder to save all your variables and any edits you've made.
Note: Only saving message variables in the iframe will not save your variables in your message. You have to save in both the variable iframe as well as the message builder itself.
Using Message Variables:
There are two ways to a add variable to your message after creating:
- Type out full variable name anywhere in Custom CSS, Body, Title or in the Choice Options as button text.
- Use the + sign in the Title, Body or Custom CSS sections to open your list of created variable names. Click on the variable name to copy to your clipboard and then you paste the variable name to your desired location within the message builder.
Once you have clicked on your variable from the dropdown list either in the body, title or custom CSS area, you will see "variable $$Sample_Variable$$ is copied" message at the top of your message builder.
Previewing your Message with Variables:
There are two ways to preview a message, and the same works for previewing variables in a message that are in the body or title sections and sometimes the custom CSS styling variables.
- In the message builder as you edit your message either at the Property Group level with the variable placeholder and default value or the individual message with only the variable input.
- Property Group master message where you can see both the default text value in the message and the variable placeholder in the body section (see image below)
- Individual message builder where you can only see the value that has been set for that property whether it is the default or a property specific value (see image below)
2. Using the message preview icon on either the Property Group level or the individual message level where you will only see the value for the variable (default or otherwise)
- Property Group level
- Individual property level
Reminder: You may or may not see all your variable values reflected here. Variable values that are links for example won't be visible here. CSS styling changes, image or logo variable values or Choice Option button text should been seen here.