NOTE: The information in this article is specific to Higher Logic Thrive Marketing Professional (Thrive Marketing Professional).
The following outline provides the basic steps necessary to integrate with Thrive Marketing Professional.
1 - Push data to Thrive Marketing Professional
To push list data and personalization data to Thrive Marketing Professional:
- Use the BulkUpload ActionRequest.
- Supply the list of Interest name(s) you want the list of subscribers to be included in.
- Specify whether you want to add, remove, or replace the current list of subscribers in the Interest:
- AddOrUpdateSubscribers
- ReplaceAllSubscribers
- RemoveSubscribers
- In your subscriber list include:
- Email address (first in the list)
- Remote ID (primary key from your database)
- Any personalizations you want associated with this record (e.g., FirstName, Status)
- You will receive a successful response with an UploadID that indicates that we have received your request.
- To tell when the upload is completed, use these criteria:
- If you have used (<StatusEmailRecipients><Email>notify_address@test.com</Email></StatusEmailRecipients>) in your call, an email is sent to that address when the upload completes.
- You can use the UploadID to make a GridRequest using the upload_history context, which tells you when the upload has been processed:
i. Supply the upload_id
ii. Return the status
2 - Retrieve a list of mailings
To retrieve a list of mailings that were sent on a specific day or a range of days:
- Use the mailing_instance context.
- Supply the date value(s) as conditions using the mailing_date field.
- Return the list of mailing_instance_id(s) for usage below.
3 - Retrieve a list of mailing activities
To retrieve a list of email-based activities from specific mailings:
- Use the values from Step 2 above.
- Query the mailing_activity_subscriber_actions context or subscriber_mailing_history context. This gives you:
- Clicked (Y/N)
- Delivered (Y/N)
- Opened (Y/N)
4 - Retrieve a list of recipient unsubscribes
To retrieve a list of recipients who unsubscribed from a specific mailing:
- Use the values from Step 2 above.
- Query the subscriber context with:
- cancellation_mailing_instance_id
- cancellation_date for desired range
- is_unsubscriber
5 - Retrieve a list of recipient opt outs
To retrieve a list of subscribers who opted out of Thrive Marketing Professional Interests managed from a subscription form:
NOTE: This does not require a mailing_instance_id.
- Use the Subscriber Removed From Interests GridRequest context.
- Include the list of Interest Name(s) you wish to be pulling back data from.
- Make sure the name list matches exactly for Case, etc.
- Use the deleted_from_interest_date field to supply a data that includes everyone since the last time you pulled. (If you run this once a day, then you just need the data from the previous day).