Test_recipients

The <test_recipients> section is a container where you can choose to:

  • Add test recipients directly to the XML instructions file

  • Specify a CSV file that contains the appropriate test recipients

    We recommend using a CSV file instead of adding the test recipients directly, to separate test recipient addresses from the campaign data.

The <test_recipients> section is:

  • A child of the Recipients section

    You can add test recipients using either <test_recipients> or the Filter section. See the Recipients section for more details.

  • Positioned:

    • After new_recipients if used, within the <recipients> section of the XML instructions file

    • Otherwise after the <retry /> tag

    If no <retry /> tag or <new_recipients> are used, the <test_recipients> section is the first entry within the <recipients> section.

The <test_recipients> section includes the following children:

Child Type Description Use
test_recipient element Add test recipients directly to the XML. Choose <test_recipient> or <csv_file>
test_csv_file element Upload a CSV file containing the test recipients. Choose <test_recipient> or <csv_file>

Use

  • You cannot use both <test_recipient> and <csv_file> for the same delivery
  • You should use a <test_recipient> tag for only one recipient. For more recipients you have to use multiple <test_recipient> tags
  • You cannot exceed the maximum number of 30 test recipients
    • Excess test recipients are ignored

Regardless of whether you add test recipients directly, or upload a CSV file, XMLDelivery adds the relevant data to your Contactsend user database and automatically creates the relevant filter. See Filtering and added recipients for more about how the user database is filtered to match new recipients.

Examples:

Send a test delivery to bob@hisemail.com and henry@hisemail.com

    <test_recipients>
        <test_recipient>
            <email>bob@hisemail.com</email>
            <first_name>bob</first_name>
        </test_recipient>
        <test_recipient>
            <email>henry@hisemail.com</email>
           <first_name>henry</first_name>
        </test_recipient>
    </test_recipients>

Send a test delivery to the recipients in file.csv

    <test_recipients>
        <test_csv_file>file.csv</test_csv_file>
    </test_recipients>

Next page:

Test_recipient


Also see: