Proofing Groups

Overview

Engage+ can generate "test" versions of an Email, SMS message, or Push Notification message, prior to actually launching the campaign. These test versions, called "proofs," are used to check for accuracy in grammar, content, format, and appearance, and to verify that Personalization fields are correctly populated. In order to streamline this process, Messaging allows you to define and save a designated set of recipients called a Proofing Group.

The Proofing Groups screen allows you to enter the contact information (email address and / or mobile phone number) for each member of the Group. Once the Proofing Group is defined, it can then be assigned in the Campaign.

Proofing Groups are similar in concept to a Seed List. The key difference between the two groups is that messages are sent to the Proofing Group during the Audit step, prior to the Campaign launch. Conversely, messages are sent to the Seed List as part of the Campaign launch.

Proofing Methods

Messaging supports two types of Proofing Groups:

Messaging Proofing Groups

Messaging Proofing Groups support a few options, which will vary the message content and quantity.

The default configuration will send one proof message to the Proofing Group members, and populate that message based on a recipient randomly selected from the Campaign's main audience.

The Specific Records feature (enabled at the Proofing Group level) will use the Proofing Group members themselves to populate the message content, instead of a randomly selected recipient. The group members must exist in the sending table to use this feature.

The Dynamic Content Proofing feature (enabled at the Proofing Group level) will send a proofing message for every recipient in the main Campaign audience, up to a maximum of 250 randomly selected messages.

The Alternate Audience Dataset feature (enabled at the Campaign level), allows you to use a Filter to define a different audience, instead of using the main Campaign audience, from which to populate proofs.   

For Campaigns that use a Messaging table as the data source, the platform also supports the concept of Quick Proofs. The Quick Proof function provides a more flexible proofing method than Proofing Groups. Quick Proofing offers the following advantages:

EDP Proofing Groups

EDP Proofing Groups don't support many of the features described above for Messaging Proofing Groups. When sending proofs to a Campaign that uses EDP as its data source, you can:

Access

The Proofing Group screen is accessible by the following method:

Features

 Create a New Messaging Proofing Group

Click hereClick here

To create a new Proofing Group:

  1. Above the list of existing Proofing Groups, click + New button.

  2. A "New Proofing Group" pop-up window is displayed. In the "Name" field, enter a name for the new Proofing Group.

  3. Select the Messaging toggle.

  4. From the "Channel" drop-down menu, select the marketing channel. Proofing Groups are available for the Email, SMS, and Push Notification channels.

  5. From the "Type" drop-down menu select one of the following options:

  • Use Random Records: The platform randomly selects records from the Campaign's audience to build and populate the proof message content.

  • Use Specific Records: The platform uses the Proofing Group recipients to build and populate the proof message content. If using this option, the Proofing Group recipient must exist as a record in the Proofing Group's source table, with the necessary contact information (email address, mobile phone number, etc.) and other fields needed for Dynamic Content and / or Personalization.

Note: The "Specific Records" option is usually not recommended, as these records are often not an accurate reflection of what a real recipient would see. The records for Proofing Group recipients might not have all of the necessary fields needed for Dynamic Content and Personalization.

  1. Click Create. The Workspace is refreshed to show the Proofing Group detail screen.

  2. If necessary, expand the "Data Options" section. This section contains the following options:

  • Type: Toggle the Group type between "Random Records" and "Specific Records."

  • Dynamic Content Proofing: Place a check mark in this check box if you wish to send each record in the Campaign audience to each recipient in the Group.

Note: Use caution when enabling the "Dynamic Content Proofing" option, especially if your Campaign has a large audience, as it can generate a high volume of proofing messages.

  1. If necessary, expand the "Group Members" section. By default, the system adds you as a member of the Group, and includes your contact information. To add another member, enter the member's contact information (email address or mobile phone number, depending on the Group's selected channel) in the "Add new list member" text field.

Note: If the selected Type for this Group is "Specific Records," then the recipient contact information must be the Unique Identifier for the source table.

  1. Select a formatting option -- either "Plain Text" or "Multipart." 

  2. Click the Add button (plus-sign icon).

  3. Repeat the above steps as needed to add more members to the Group. To remove a member, click the Delete icon next to the member.

  4. Optionally, you can assign one or more tags to your Proofing Group. To assign a tag, click on the "Add tag" field in the Edit > tab of the Tool Ribbon. The system displays a pop-up menu of all the existing tags. You can select one of these tags, or type in a new one and press Enter. You can repeat this process to add more tags. To remove a tag, click the "X" icon next to the tag label.  

  5. When finished, click Save in the Tool Ribbon.

 

 Create a New EDP Proofing Group

Click hereClick here

To create a new Proofing Group for use in EDP-driven Campaigns:

  1. Above the list of existing Proofing Groups, click the New Item button.

  2. A "New Proofing Group" pop-up window is displayed. In the "Name" field, enter a name for the new Proofing Group.

  3. Select the EDP toggle.

  4. From the "Channel" drop-down menu, select the marketing channel. 

Note: EDP Proofing Groups are available only for the Email and SMS Text Channels.

  1. From the "Type" drop-down menu select one of the following options:

Note: Once an EDP Proofing Group is created, switching type from Specific Records to Random Records or vice versa is prevented.  

  • Use Random Records: The platform randomly selects records from the Campaign's audience to build and populate the proof message content.

  • Use Specific Records: The platform uses the Proofing Group recipients to build and populate the proof message content. If using this option, the Proofing Group recipient must exist as a record in the Proofing Group's source table, with the necessary contact information (email address, mobile phone number, etc.) and other fields needed for Dynamic Content and / or Personalization.

Note1: Specific records and alternate data sets are usually small audiences. To reduce the time for proofing (time for the system to generate proofs), we encourage users to use specific records or an alternate data set instead of random records in Dynamic Proofing (beta).   

Note2: The option "Use Specific Records" is available only in EDP Dynamic Proofing (Beta) and it supports Regular, Date-Triggered, and Event-triggered EDP Email Campaigns with and without cells and splits. EDP SMS Campaign is NOT supported. When a Specific Records Proofing Group is used for EDP Proofing (other than Dynamic Proofing, in the non–beta mode), the platform will disregard the Specific Records Proofing Group Type and will randomly select records from the Campaign's audience to build and populate the proof message content.  

 

  1. Click Create. The Workspace is refreshed to show the Proofing Group detail screen.

  2. By default, the system adds you as a member of the Group, and includes your contact information. To add another member, enter the member's contact information in the "Add new list member" text field. The only available formatting option in an EDP Proofing Group is Multipart

  3. Click the Add button (plus-sign icon).

  4. Repeat the above steps as needed to add more members to the Group. To remove a member, click the "X" icon next to the member.

  5. Optionally, you can assign one or more tags to your Proofing Group. To assign a tag, click on the "Add tag" field in the Tool Ribbon. The system displays a pop-up menu of all the existing tags. You can select one of these tags, or type in a new one and press Enter. You can repeat this process to add more tags. To remove a tag, click the "X" icon next to the tag label.  

  6. When finished, click Save in the Tool Ribbon.

 

 Copy a Proofing Group

Click hereClick here

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).

  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 Actions > Save As. A "Save as" dialog box is displayed.

  4. Enter a name for the new item.

  5. By default, the new item will be saved in the same folder location as the base item. Optionally, click the magnifying glass icon to browse to and select a different folder location.

  6. Click save a copy. The system creates a copy of the selected item.

 

 View or Edit a Proofing Group

Click hereClick here

To view or edit an existing Proofing Group:

  1. When the screen is displayed, a list of all the current Proofing Groups is displayed in the left-hand side of the Workspace. Optionally, you can filter this list by typing in all or part of an Proofing Group name in the "Search by Name" field.

  2. Click on the Proofing Group that you want to view. The Workspace is refreshed to show the details of the selected Proofing Group.

  3. Optionally, to view detailed information about the Proofing Group, click the Proofing Group tab in the Tool Ribbon. The Item Details screen is displayed, showing who created the item, who modified it last, and what the last actions taken on the item were. On this screen, click "Related Items" in the Function Menu to see other items in the system that reference or utilize this Proofing Group. When finished, click the Edit tab in the Tool Ribbon to return to the main edit screen.

  4. Make any necessary changes to the Proofing Group properties or recipients. 

  5. Optionally, to rename the Proofing Group, click Edit > Rename. A "Rename Item" dialog box is displayed. Enter a new name for the Proofing Group, then click save new name.

  6. Optionally, you can assign one or more tags to your Proofing Group. To assign a tag, click on the "Add tag" field in the Edit  tab of the Tool Ribbon. The system displays a pop-up menu of all the existing tags. You can select one of these tags, or type in a new one and press Enter. You can repeat this process to add more tags. To remove a tag, click the "X" icon next to the tag label.  

  7. To save your changes, click Edit > Save in the Tool Ribbon.

 

 Delete a Proofing Group

Click hereClick here

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.

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

 

 Proofing Best Practices

Click hereClick here

The time it takes to generate and deploy Proofs depends on a number of variables -- the types of assets utilized within the message content, the use of  Dynamic Content and Filters, the current processing load on the system, and so forth. This topic provides some useful tips and best practices for how to make sure that your Proofs deploy as quickly as possible.

Proofing Filter (Alternate Campaign Audience)

By default, the platform will use the main Campaign Audience to select and populate records for Proofs. Filters used to create a Campaign Audience are often large and complex, and run against a large pool of records. One of the best ways to improve the performance of your Proofs is to utilize a separate Filter that's designed specifically for Proofs, rather than using the primary Campaign Audience Filter.

In the "Proofing" section of the Campaign screen, you have the option of selecting an "Alternate Campaign Audience." This feature allows you to utilize a different Filter than the primary Campaign Audience Filter for the purposes of selecting records for Proofs. This "Proofing Filter" can be designed to select from a much smaller pool of records, which will speed up the Proofing message deployment process.

Message Content

The different assets that you use within the Campaign content have an important impact on how long it takes your Proofs to deploy. The following recommendations will help streamline the content calculation process, and make your Proofs run faster:

  • Optimize the number of Content Blocks by combining them whenever possible.

  • If you reuse Content Blocks (or Dynamic Blocks or Looping Blocks) across Campaigns, ensure that all the blocks associated to the current Campaign contain only content and logic that will be used by this Campaign.

  • Don't nest Content Blocks that are using the same logic.

  • Don't use the same Dynamic Blocks multiple times within a single Campaign. Instead, consider setting up a Looping Block, so that the logic can be handled by XSLT. In certain cases (such as population of URLs by language), Dynamic Content can be replaced with Looping Block personalization, which will run faster.

  • Sample  Looping Block CodeSample  Looping Block Code

    This sample XSLT code is used for a Looping Block that will select the appropriate language Dynamic Block used in every link.

     

    <?xml version="1.0" encoding="utf-8"?>

    <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

    <xsl:output method="html" encoding="UTF-8" indent="yes" omit-xml-declaration="yes" />

    <xsl:template match="/">

     

    <xsl:variable name="pl"><xsl:value-of select="/Msg/Props/Prop[@prop_name = 'per_language']/@val" /></xsl:variable>

     

    <xsl:choose>

    <xsl:when test="$pl = 'PORTUGUESE'">portuguese</xsl:when>

    <xsl:when test="$pl = 'TRADITIONAL CHINESE' or $pl = 'SIMPLIFIED CHINESE' or $pl = 'TAIWANESE'">chinese</xsl:when>

    <xsl:otherwise><xsl:value-of select="$pl"/></xsl:otherwise>

    </xsl:choose>

     

    </xsl:template>

    </xsl:stylesheet>

  •  

Dynamic Content

If you use Dynamic Content, the Filters used to generate this Dynamic Content should conform to Cheetah Digital's best practices regarding Filters. See Filter Best Practices for more details.

There is no simple rule of thumb as to how much Dynamic Content can be used before you begin to impact the timing of your Proofs. Generally speaking, the greater the number of rules / level of complexity, the longer the Proofs will take to run. The following recommendations will help optimize your Dynamic Content:

  • The IF > IF logic structure takes longer to run, as it doesn't stop the query at the first match. Whenever possible, use the IF > ELSE IF structure.

  • If the Dynamic Content utilizes a simple 1:1 rule (i.e. if the value for one field = x), then use the "Match Rule" query type rather than the "Match Filter" query type, as it will run faster if you don't use a Filter. If certain commonly run queries can be turned into Calculated Fields, the Dynamic Content rules can then be updated to match the values on these Calculated Fields rather than use Filters.

Calculated Fields

Consider using Calculated Fields wherever possible for Filter queries that have to pull data across multiple tables. If you're using large, slow queries in your Filters that don't require up-to-the-minute real-time data, you can schedule your Calculated Fields to run at night, thereby greatly reducing query time. You can also speed up these queries by simplifying the values in the field. For example, you could set up a Calculated Field to perform a complex query that results in a simple score or ranking  value. Then, you can reference that score value in your Filter. Please note that you should schedule your Calculated Fields to run prior to needing those fields for Proofing purposes.

System Contention

If you're running multiple Campaigns, considering stagging your Proofs. Sending Proofs simultaneously within one system, or across multiple Child systems, can slow down performance. Or, if possible, try to run your Proofs during off-peak hours when the processing load on the system is lower.

 

Troubleshooting

 Troubleshooting a Proofing Group

Click hereClick here

If you aren't receiving proofs as expected, check the following:

  • Are the records in the Proofing Group random or specific? If they are specific, they need to exist as records in the database. 

  • Check if the content type for the proofing recipient's email address is multipart or plain text only; ensure it's set to multipart

  • Verify that the Campaign content includes an Opt-Out Message. 

  • Verify that there are records being selected by the Campaign's audience Filter. If it's a Split Cell Campaign, ensure that all the records in the child cells are included in the parent cell. 

  • Check the content of the Campaign and verify that all Content Blocks and Dynamic Blocks use the same source table as the Campaign. 

  • Check for invalid Merge Symbols within the Campaign content. 

  • If a proofing Filter is used, verify that the Filter is selecting records. 

  • If proofs show as sent within the platform, but they are not received, check your spam folder.  

 If the problem persists, please contact Global Support for further assistance.