About the Flow Canvas

Marketing Automation Flow Canvas

The Flow Canvas is where you will place, connect and organise the nodes of your marketing automation flow.

Continue reading below to find out more about everything you can do in the Canvas, or click an item on the left navigation to jump to a specific section of this article.

ma9.jpg

 


 

Activity History

All Marketing Automation activities contain an Activity History log to make it easier for you to stay up to date with any changes made to your Marketing Automation flow.

Click an item below to expand.

View Activity History

How to view the Activity History log

To expand the Activity History, click on the Last saved timestamp under your flow's name.

actHist1.jpg

 

Activity History Contents

Activity History Contents

The Activity History contains a simplified version of all changes that make it easy to see which nodes or parts of the activity have been modified.

It also contains advanced, technical information useful for advanced APSIS One users and APSIS Support when troubleshooting your Marketing Automation activities whenever necessary. Expand Action Details below to learn more.

Here's a quick overview of the columns and their contents:

Date: The date the change was made.

Object: What was changed in your activity, whether it was a node, node connection or part of your Flow Settings.

Action: Whether the object was changed, updated, deleted, paused or activated.

actHist2.jpg

 

Action Details

About Action Details

When an object has been updated, you'll see a green arrow on the right. Click the arrow to expand.

These details are useful whenever troubleshooting your Marketing Automation flows, and are only intended for advanced users and APSIS Support agents. 

actHist3.jpg

 

Filters

About Filters

Filter the items in the Activity History log to make it easier to locate specific changes. Click on the Filters icon on the left to see all available filters.

You can filter by:

Object: What was changed in your activity, whether it was a node, node connection or part of your Flow Settings.

Action: Whether the object was changed, updated, deleted, paused or activated.

Date: The date the change was made.

actHist4.jpg

 

 


 

Listen Node

The listen node is the most important node in your marketing automation flow.

It will listen for the Profiles in order to bring them into the flow. As Profiles join your Audience, perform any actions, enter a segment, etc., they may come into your flow depending on your settings. Take a look at this article for more information about Profile data.

Expand an item below to learn more about what you can do with the listen node:

Attributes

With the Listen node, you can bring Profiles into the flow by listening for their Attributes.

The node will bring Profiles into the flow whenever they match the Attribute you selected, but you may choose an exact timing for them to enter the flow. Read more about Attributes...

Listen1.jpg

 

To allow Profiles to enter the flow according to an Attribute, first choose an Attribute from the drop-down menu. The Listen node supports both default and custom Attributes.

listen2.jpg

 

Depending on the type of Attribute, the configuration will vary. First name, last name, email address, country, etc. are good examples of text Attributes. Mobile and postcode are number Attributes, while date of birth is a date Attribute. If you would like to read more about Attributes, head over to this article.

Choose a type of Attribute below to read more:

Text

1. Choose a text Attribute from the drop-down menu.

listen2.jpg

 

2. Choose a match type from the drop-down menu.

Equals: The value equals that which you input in the value field. For example, First Name equals "Johanna".

Not Equals: The value does not equal that which you input in the value field. For example, First Name ≠ Johanna.

Contains: The value contains that which you input in the value field. For example: Birthdate contains "1993".

Starts with: The value starts with that which you input in the value field. For example, Last Name starts with "J".

Ends with: The value ends with that which you input in the value field. For example, Last Name ends with "N".

Regex: This is used for regular expressions, which is a sequence of characters used to define a search pattern. However, using regular expressions is an advanced skill that requires background knowledge. Please refer to your development team, or consult a reference guide of your choice.

match-type.jpg

 

3. Enter a value that the Attribute must match in order for Profiles to enter the flow.

value.jpg

 

4. Under At, select a specific time to bring Profiles into the flow from the drop-down menu.

at.jpg

 

5. Click Save.

save_02.jpg

 

Number

1. Choose a number Attribute from the drop-down menu.

listen2.jpg

 

2. Choose a match type from the drop-down menu.

Equals: The value equals that which you input in the value field. For example, First Name equals "Johanna".

Not Equals: The value does not equal that which you input in the value field. For example, First Name ≠ Johanna.

Contains: The value contains that which you input in the value field. For example: Birthdate contains "1993".

Starts with: The value starts with that which you input in the value field. For example, Last Name starts with "J".

Ends with: The value ends with that which you input in the value field. For example, Last Name ends with "N".

Regex: This is used for regular expressions, which is a sequence of characters used to define a search pattern. However, using regular expressions is an advanced skill that requires background knowledge. Please refer to your development team, or consult a reference guide of your choice.

match-type.jpg

 

3. Enter a value that the Attribute must match in order for Profiles to enter the flow.

value.jpg

 

3. Under At, select a specific time to bring Profiles into the flow from the drop-down menu.

at.jpg

 

4. Click Save.

save_02.jpg

 

Number with decimals

1. Choose a number with decimals Attribute from the drop-down menu.

listen2.jpg

  

2. Choose a match type from the drop-down menu.

Equals: The value equals that which you input in the value field. For example, First Name equals "Johanna".

Not Equals: The value does not equal that which you input in the value field. For example, First Name ≠ Johanna.

Contains: The value contains that which you input in the value field. For example: Birthdate contains "1993".

Starts with: The value starts with that which you input in the value field. For example, Last Name starts with "J".

Ends with: The value ends with that which you input in the value field. For example, Last Name ends with "N".

Regex: This is used for regular expressions, which is a sequence of characters used to define a search pattern. However, using regular expressions is an advanced skill that requires background knowledge. Please refer to your development team, or consult a reference guide of your choice.

match-type.jpg

 

3. Enter a value that the Attribute must match in order for Profiles to enter the flow.

value.jpg

 

4. Under At, select a specific time to bring Profiles into the flow from the drop-down menu.

at.jpg

 

5. Click Save.

save_02.jpg

 

Date

1. Choose a date Attribute from the drop-down menu.

listen2.jpg

 

2. Choose when to bring Profiles into the flow.

Select a number of days, weeks, months of years before or after the date Attribute for Profiles to enter the flow.

To bring Profiles into the flow the exact date in the Attribute, choose Today.

dateofbirth.jpg

 

3. Under At, select a specific time to bring Profiles into the flow from the drop-down menu.

at.jpg

 

4. You now have two options:

Repeat every year: If you would like Profiles to enter this flow every year, select the Repeat every year button. This is a useful feature for birthdays, anniversaries, etc.

Only on Milestone birthdays (e.g. 40th, 50th): A Milestone birthday is a commonly celebrated decade. This is a good feature for flows that target Profiles on an important birthday, like turning 50 years old. If you would like Profiles to enter the flow once the date of this Attribute reaches a new decade (every 10 years from the date in the Attribute value), select the Only on Milestone birthdays button.

date1.jpg

 

5. Click Save.

save_02.jpg

 

True/False

1. Choose a True/False Attribute from the drop-down menu.

listen2.jpg

 

2. Choose Equals as Match type from the drop-down menu, then expand Value and choose one of the following:

True: the Profile's Attribute value is True. Profiles with True as a value will enter the flow. Those with False will not enter.

False: the Profile's Attribute value is False. Profiles with False as a value will enter the flow. Those with True will not enter.

boolean1.jpg

 

3. Under At, select a specific time to bring Profiles into the flow from the drop-down menu.

at.jpg

 

5. Click Save.

save_02.jpg

 

 

Tags

With the Listen node, you can bring Profiles into the flow by listening for Tags.

The node will bring Profiles into the flow according to a Tag, but you may choose an exact timing for them to enter the flow.

listen4.jpg

 

To allow Profiles to enter the flow according to a Tag, you must first decide whether you want to bring Profiles into the flow based on whether they do or do not have a Tag.

The procedure for listening for Profiles Tagged and not Tagged is the same.

To bring the Profiles that contain a Tag into this flow, add a Tag under Profiles Tagged.

To bring the Profiles that do not contain a Tag into this flow, add a Tag under Profiles not Tagged.

 

1. Depending on whether you want the Profiles to match all or any of the following Tags, select an option from the drop-down menu. You may do this at any point while you edit the Listen node.

allanyTagged.jpg

 

2. Click on the drop-down menu to select a Tag previously created.

tsgged.jpg

 

3. To add multiple Tags, repeat the process above.

 

4. To create a new Tag, click Create new Tag on the drop-down menu.

createnew.jpg

 

5. Enter the new Tag name.

To save the Tag, click Save. Otherwise, Cancel.

Tagname.jpg

 

6. To remove a Tag, click on the "x" icon on the Tag.

removeTag_02.jpg

 

Events

With the Listen node, you can bring Profiles into the flow by listening for Events.

The node will bring Profiles into the flow whenever they perform an action that matches the Event you selected, in real time. If you need a hand getting to know all the available Events and their corresponding Event data, take a look at this article.

Choose between the following Events to get started:

Sign-up bar: Select a Sign-up bar activity from the Website tool to listen for Profiles who provide their Email or SMS Consent.

SMS: Listen for Profiles as they interact with your SMS tool activity.

Email: Listen for Profiles as they interact with your Email tool activity.

Cookie banner: Listen for Profiles as they interact with one of your Cookie bar activities from the Website tool.

Auto-Collect: Make use of your Auto-Collect activity data from the Website tool, and listen for Profiles as they perform site searches, downloads, and more!

Achievements: Listen for those Profiles who gain an Achievement Event, from another Marketing Automation flow for example.

Product Views: After setting up your Product Views activity in the Website tool, listen for Profiles as they browse your website and view different products and product categories.

Conversion Events: Did you set up Manual Data Tracking in your website? The Conversion snippet allows you to manually define a custom Conversion Event. Use this Event to listen for those Profiles who matched your settings and gained this Event!

Ecom Events: All Ecommerce-related Events are available here, like those associated with the Ecom Add-on, APSIS One integrations Profile data, and Manual Data Tracking.

Listen19.jpg

 

Listen for Events

1. Click on the Activity name drop-down and select an activity from the list.

ListenNode5_02.jpg

 

2. Expand the Listen for drop-down menu and choose an Event.

ListenNode6_02.jpg

 

3. Expand the Match drop-down menu to select a specific data point from the Event, like a specific URL or link title. Read more about Event data...

Listen7.jpg

 

If you pick a match, you must select a Match type as well (whether the Event data equals or contains a specific value, for example).

All URLs from links inserted into emails or SMS messages contain a unique link ID at the end. When specifying Profiles that clicked a link in your email, make sure to set up your condition to contain the original URL. For example: "Email - Click: url contains https://heartland.com/accessories/sunglasses".

Listen8.jpg

 

Enter a value for the Event data to match.

Listen9.jpg

 

4. Under Times, select how many times the Profile must have performed the Event in order to qualify.

listen6.jpg

 

Tick the Within a time frame box to determine a time frame for the Event.

Enter a number under Amount, or click and drag the icon next to the input field, and select between minutes, hours, days, weeks, months or years.

listen1.jpg

 

5. Click Save.

ListenNode7_02.jpg

 

Segments

With the Listen node, you can bring Profiles into the flow by listening for segments.

The node will bring Profiles into the flow whenever they match the segment you selected, but you may choose an exact timing for them to enter the flow.

Note that, once you select a segment for your Listen node and save it, the Listen node will save the segment as it is in that moment. If you later edit the segment, the segment in the Listen node will not be updated. You would have to return to the flow and choose the segment again.

This, of course, requires that you have previously created segments in Audience. Read more about segmentation...

listen3.jpg

 

To allow Profiles to enter the flow according to a segment, you must first decide whether you want to bring Profiles into the flow based on whether they do or do not match a segment.

The procedure for both including and excluding segments is the same.

To bring the Profiles that match a segment into this flow, add an included segment under Segment match.

To bring the Profiles that do not match a segment into this flow, add an excluded segment under Not a segment match.

If you would like to learn more about how including and excluding segments affects your activities, head over to Working with Segments.

 

1. Depending on whether you want the Profiles to match all or any of the following segments, select an option from the drop-down menu. You may do this at any point while you edit the Listen node.

allany.jpg

 

2. Click Add included segment to listen for Profiles who match, or Add excluded segment to listen for Profiles who don't.

addincluded_02.jpg . AddEx_02.jpg

 

3. Click on the segment container and select a segment from the list.

segments.jpg

 

4. To add another segment, click Add included segment or Add excluded segment and repeat the steps described above.

addincluded_02.jpg

 

5. To remove a segment, click on the "x" icon at the right end of the segment container.

segx.jpg

 

6. Under At, select a specific time to bring Profiles into the flow from the drop-down menu.

at.jpg

 

7. Click Save.

save_02.jpg

 

 


 

Nodes in the Flow Canvas

Here's some practical information about working with Marketing Automation nodes in the Flow Canvas.

click an item below to expand:

Adding a Node

How to Add a Node

The listen node is always present in every Marketing Automation flow and it cannot be removed. So, if you want to add your first node, you will be adding it from the Listen node. The process is the same for all nodes.

adding_02.jpg

 

To add a new node, click the plus sign (+) on the bottom of any of the nodes, or on the connection between two nodes.

Choose between Channels, Actions or Integrations and select a node from the list.

AddNode.jpg

 

Editing a Node

How to Edit a Node

To edit a node, simply locate the node you wish to edit and click the Edit button.

Don't forget to save your changes!

ma9.jpg

 

Deleting a Node

If you delete a node in a paused Marketing Automation flow, all Profiles currently present in the node will be removed from the flow. This will be reflected as an Event on those Profiles under Response Data. This cannot be undone.

Removed Profiles will still be shown as a part of the statistics in the Marketing Automation Report.

 

How to Delete a Node

To delete a node, you must locate the Delete button.

For most nodes, you will have to first click Edit.

finish1.jpg

 

Then click Delete.

finish2.jpg

 

But in the Email node, the Delete button is always on display.

email.jpg

 

Connecting a Node

How to Connect a Node

To connect a node, click on the plus sign (+) of the first node and draw a line to the node you want to connect it with.

connect.jpg

 

Disconnecting a Node

How to Disconnect a Node

To disconnect a node, click the minus sign (-) on the line that connects the two nodes.

disconnected.jpg

 

Disconnected Nodes

About Disconnected Nodes

Make sure that all nodes are connected. If nodes are disconnected, Profiles will not move from one node to the other. Some nodes don't need to be connected to another, though, like the Email or Achievement node whenever placed at the end of the flow. Disconnected nodes count as incomplete nodes. See Incomplete Nodes below.

disconnected.jpg

 

To connect a node, click on the plus sign (+) of the first node and draw a line to the node you want to connect it with.

connect.jpg

 

Incomplete Nodes

About Incomplete Nodes in a Marketing Automation Flow

It's not possible to activate a flow that contains incomplete nodes. Disconnected nodes count as incomplete. Whenever you try to activate an incomplete flow, you will see the following warning:

incomplete_02.jpg

 

You may either complete or delete the incomplete nodes. To see the incomplete nodes, click Show nodes.

incomplete2_02.jpg

 

By clicking on the arrows, you may toggle between all incomplete nodes, which will be highlighted in red.

complete.jpg

 

You may also delete the nodes you don't think are necessary in order to activate your flow. To learn more about how to delete a node, expand Deleting a Node above.

 

 


 

 

Was this article helpful?