The BulkUpload request supports a list of Interests that can be attached with an incoming subscriber. Interests are included on a per-subscriber basis. These Interests can vary from record to record in the API message.

Delimiters for Interests

In this request, Interests must be distinguished from one another ("delimited") by a comma (i.e., "comma-delimited").

• The comma is the only valid character for delimiting Interests AND you must use a different character to delimit other fields.
• This is critical because the API will parse any comma-delimited information request as Interests.
• The comma delimiter must identified in the XML itself (see example below).

Uploading Interests

Every Interest that you attach in a comma-delimited string must exist in Higher Logic Thrive Marketing Professional (Thrive Marketing Professional).

• If you upload an Interest name that does not exist in Thrive Marketing Professional, the upload will ignore it and continue.

Summary rules

Here are the summary rules for BulkUpload XML:

• Commas are the Interest delimiters used.
• Other characters, such as a tilde ( ~ ), must be used for other delimiters.
• There can be only one FieldDefinition called Interest.
• Interests must exist in Thrive Marketing Professional; otherwise, they will be ignored.

NOTE: Commas can be used as the standard delimiter only if Interests are not incorporated within the XML.

XML message example

Below is an example XML message.

Note that the Interests are provided in a comma-delimited string.

<ActionRequest xmlns="http://partner.informz.net/aapi/2009/08/">
    <Password>apasswordgoeshere</Password>
    <Brand id="9999">Brand Name</Brand>
    <User>testuser</User>
    <Actions>
        <BulkUpload>
            <UploadDetails>
                <InterestDetails>
                    <InterestAction>AddOrUpdateSubscribers</InterestAction>
                </InterestDetails>
                <StatusEmailRecipients>
                    <Email>johndoe@informz.com</Email>
                </StatusEmailRecipients>
                <ColumnDelimiter>~</ColumnDelimiter>
                <HasFieldsEnclosedInQuotes>0</HasFieldsEnclosedInQuotes>
            </UploadDetails>
            <FieldDefinitions>
                <FieldDefinition>
                    <Name>Email</Name>
                    <DataType>string</DataType>
                    <ColumnIndex>1</ColumnIndex>
                    <FieldType>Email</FieldType>
                </FieldDefinition>
                <FieldDefinition>
                    <Name>Interest</Name>
                    <DataType>string</DataType>
                    <ColumnIndex>2</ColumnIndex>
                    <FieldType>Interest</FieldType>
                </FieldDefinition>
            </FieldDefinitions>
            <Data>
                <![CDATA[johndoe@informz.com~Test Interest,Opt-Ins interested@informz.com~Test Interest,My New Interest]]>
            </Data>
        </BulkUpload>
    </Actions>
</ActionRequest>