Dynamic Blocks

A Dynamic Block is a special type of asset in Cheetah Digital that allows you to customize the content of a Campaign based on some logical rule, or condition. Instead of having to create separate Campaigns for each content variation, you can create a single Campaign, and use a Dynamic Block to determine the appropriate Content Block (or External Content Block) to send to each recipient. Dynamic Blocks can be used to control many different components of a Campaign, such as text, images, HTML code, an email subject line, or an email friendly-from name.

Like Content Blocks, a Dynamic Block is created independently of a Campaign, and is reusable across Campaigns and across channels.

The platform supports two different data sources for building Dynamic Blocks -- the Cheetah Digital database, and the Engagement Data Platform (EDP). The Engagement Data Platform is the data layer that powers and unifies Marigold's Cheetah Digital, Loyalty, Experience, and Personalization applications. The EDP empowers marketers to load and transform data from any source, at high volumes, and then to leverage that data to create lasting customer relationships across all engagement channels.

Building dynamic content

A Dynamic Block consists of one or more logical criteria. These criteria are referred to as Rule / Block Pairs because they consist of both a condition to be met (the Rule) and a resulting action (the Block to be used when the condition is met). A Dynamic Block can consist of one to many different Rule / Block Pairs which drive specific, personalized content to the correct audience. Dynamic Blocks also support the use of default content, which will be sent to Campaign recipients who don't meet any of the defined rules.

Query types

Cheetah Digital provides two different methods (called query types) for establishing how you want to identify which recipients get which content variant:

  • By Filter: Use if you want to define multiple Filters that will break the Campaign audience into smaller unique groups, each of whom should receive unique content. Please note that this query type is not supported for Dynamic Blocks that use EDP as their data source. 

  • By a Value in a Field: Use if you want to look for a specific value in a database field. A Dynamic Block is limited to using only one field, and that field must be contained on the Dynamic Block's source table (you can't join to another table).

You must choose only one of these two query types for your Dynamic Block; you can't use both types within the same Dynamic Block.

Note: For the match by Filter query type, you have the option of entering the Rule / Block Pairs into the user interface, or of uploading a spreadsheet containing the Rule / Block Pairs. Please see the Dynamic Content Upload section below for details on how to upload Rule / Block Pairs. This feature is not available for the match value in a field query type.

Conditional statements

The platform supports two conditional statements that define the business logic for the Rule / Block Pairs: IF > ELSE IF and IF > IF.

The IF > ELSE IF conditional statement is useful if you know you want a recipient to fall into only one rule, and to receive only one Content Block. The system works from the top down, evaluating candidates against the first rule. Only the non-matching recipients drop down to the second rule. Once a recipient matches a rule, they are removed from any further evaluations. Therefore, the sequence of the rules is important, because even if a recipient qualifies for more than one rule, they would receive only the Content Block from the FIRST rule to which they matched.

As an example, let's say that your company has three different tiers of premium customers based on their purchase history -- Silver, Gold, and Platinum. You want to send an email Campaign with unique offers to each tier. Instead of creating three different Campaigns, you could create a single Campaign, and use a Dynamic Block to control which Campaign recipient gets which offer. Your Dynamic Block would consist of three different rules, followed by a default catch-all rule for all recipients who aren't a member of any tier. This logical statement would look like this:

  1. IF Recipient is a Platinum Member, then send Platinum offer,

  2. ELSE IF Recipient is a Gold Member, then send Gold offer,

  3. ELSE IF Recipient is a Silver Member, then send Silver offer,

  4. ELSE send Default offer.

Each of the different offers listed above must reside within a different Content Block (or External Content Block). The determination of a recipient's membership in a particular tier could be defined either through a Filter, or through a value in a database field.

The IF > IF conditional statement allows a recipient to potentially match to multiple rules, and therefore to receive multiple Content Blocks. For example, let's say you want to send coupon offers to customers based on their purchase history. If a customer made multiple purchases, they should receive coupons for each purchase. This logical statement would look like this:

  1. IF Recipient purchased shoes, then send shoes coupon,

  2. IF Recipient purchased a shirt, then send shirt coupon,

  3. IF Recipient purchased socks, then send sock coupon,

  4. ELSE send Default coupon.

In this example, a customer who made multiple qualifying purchases would receive multiple Content Blocks. The sequence of the rules doesn't matter, as the system evaluates every customer against every rule. So, even if a customer met the first rule (purchased shoes), they would still get evaluated against the second and third rules as well.

Access

The Dynamic Blocks screen is accessible via the Main menu; select Assets > Blocks > Dynamic Blocks

Create a new Dynamic Block

This section describes how to create a new Dynamic Block through the Dynamic Block screen. In addition, Dynamic Blocks can be created through the New Item screen (see Create a New Item: Dynamic Block), or defined though an API request (see Dynamic Block API for more details).  

Define default content

In most situations, a Dynamic Block should have Default content defined for it. The Default content will be sent to all of the Campaign recipients who otherwise don't meet any of the defined Dynamic Block criteria.

Default content is optional. However, please note that you can't actually delete the Default row from the screen. If you don't want Default content in your Dynamic Block, then simply leave it blank, and don't define or select a Content Block (or External Content Block) for it.

Define a rule/block pair - by filter

A Dynamic Block consists of one or more Rule / Block Pairs which drive specific, dynamic content to the correct audience.

Define a rule / block pair -- by value in a field

A Dynamic Block consists of one or more Rule / Block Pairs which drive specific, dynamic content to the correct audience.

 Dynamic content uploader

This section describes how to upload a spreadsheet containing the Rule / Block Pairs for a Dynamic Block.  If you have a large, complex set of rules, it can be easier to upload the logic via a spreadsheet, rather than entering all of the rules into the user interface.

Copy a Dynamic Block

To copy an existing item to use as the basis for a new item:

1. Search for the desired item (see Search for an Item for more details).

View or edit a Dynamic Block

Note: While editing a Dynamic Block, if another user has this same Dynamic Block open at the same time, and he or she modifies and saves the Dynamic Block, the system will alert you with a Changes Detected pop-up window. This window tells you that changes have been made, and by whom. If you want to discard your local changes and reload the screen to show the other user's version of the Dynamic Block, click reload dynamic block. Or, if you want to overwrite the other person's changes, click ignore changes.

Delete a Dynamic Block

To delete an item:

  1. Search for the desired item (see Search for an Item for more details).

  2. Click on the item name. The main item screen is displayed and populated with the details of the selected item.

  3. In the Tool Ribbon, click Edit > Actions > Delete. A confirmation dialog box is displayed.

  4. Click delete item to confirm the deletion.

  5. Foldered items are moved to the Recycle Bin. Non-foldered items are permanently deleted.

Assign a Dynamic Block to a campaign

Once you create your Dynamic Block, you can use it within one or more Campaigns. Cheetah Digital has two methods for assigning a Dynamic Block to a Campaign: either 1) define the Dynamic Block as the primary Content Source for the Campaign, or 2) insert the Dynamic Block into the Campaign message.

Troubleshooting

If your Dynamic Block isn't rendering as expected, trying the following steps: