You can integrate your Retention.com account directly with Bloomreach.
An integration between Retention.com and Bloomreach does three things:
1. Your Bloomreach API Base URL, Project Token, API Key ID, and API Secret. To find these, go to Settings > Project settings. Then, click API > Add key.
2. Give the key a name, and click Create.
3. Copy the API Secret to your clipboard (and save this since you won't be able to copy it again). Click Close.
4. Then, copy your Project token, API Base URL and API Key ID.
5. You will also need to setup a segment for the contacts we send you. Ask your account executive to enable send integration identifier for your account. Then, go to Analyses > Segmentation.
6. Then, click New Segmentation. Set up a segment for the contacts using this logic, and click Save Segmentation:
data_source > equals > GE
7. Use this segment to trigger events in the email flow for our contacts.
1. Click on Integrations from the left navigation panel in Retention.com. Then, click Available Integrations at the top and choose the Bloomreach icon.
2. Enter your Bloomreach API Base URL, Project Token, API Key ID, and API Secret. Then, click Connect.
3. Set up your Contact Suppression. Once you enable automatic suppression, Retention.com will sync your regular, opt-in list from your ESP and add it to your Retention.com suppression list. This prevents you from paying for contacts you already have. Once you’ve enabled this option, the sync will run daily at 6 p.m. EST.
Choose YES to suppress contacts, and pick either daily contact suppression (recommended) or one time suppression.
Daily contact suppression: This action will load all of your contacts from Sendlane V2 into your Retention.com suppression list and will automatically import new contacts every day into your suppression list.
One time suppression: This action will only run once and load your current Sendlane V2 contacts into your Retention.com suppression list.
To setup the Recent contacts Segment ID for suppression, go to Analyses > Segmentations > New Segmentation in Bloomreach. Name the segment Recent Contacts, and set the below criteria.
consent > timestamp > less than > 2 days > ago
AND category > equals > email
Click to Save segmentation. The Recent contacts Segment ID you'll need for our suppression is the full number in the URL (example is partially blurred).
4. When you're finished with the suppression setup, click Next in Retention.com.
5. Click Yes to upload your contacts to Bloomreach. Then, choose whether you want to enable custom sync options.
If you check the box to enable custom sync options, that will display five options: filter by email domain, full or portion of a landing page URL, landing page domain, state, and referrer URL.
This feature allows you to filter your Retention.com contacts before you send them to your ESP. For example, you can send all contacts who hit different landing pages to separate lists. Or, send all of your California leads to one ESP and Texas leads to another.
Email domain: This field auto-fills/populates with email domains (ex. Gmail, Yahoo Mail, AOL, etc.) from your collected contacts.
Full or portion of a landing page URL: If you’ve put the script on several pages or the entire site, this field allows you to pull out contacts who have only hit Landing Page A or Landing Page B. This option does not auto-populate, so you will have to add in the exact URL.
Landing page domain: If you added script to both Retention.com and Robly.com, for example, the landing page domain would be either Retention.com or Robly.com. This field will auto-populate.
State: This filter allows you to pull out only contacts from one or more states.
Referrer URL: This is the URL the contact comes to your site from.
When you're finished, click Next.
6. Enable the Bloomreach integration, and click Finish. Once you enable the integration, your collection sync settings will apply and begin if your script is turned on.
7. Once the integration is complete, you will see the integration date, API details, and the option to set/change the list it's synced to. You can also Remove the integration from this page at the top.
1. To change your contact suppression preferences, click Integrations in the left-hand navigation. Then, click the three dots next to the integrated program and select Settings.
2. Click the pencil/edit icon next to Contact Suppression.
3. Click Yes to automatically suppress your contacts. Then, choose whether you want to suppress daily (recommended) or just this (single) time—and change the segments as needed. You can also adjust the Recent contacts Segment ID here. When you’re done, click Save.
1. To remove the integration, click Integrations > Dots > Remove.
You can view your daily sync history under Sync Summary on your integration page. It will show you the date, number of completions, if there are any failures, and the number that are in the queue.
To access all of your sync history, click View Full History under Sync Summary. If there's a failure, it will show the email address, what type of failure has occurred under ESP Feedback, and the date and time of the failure.
If you have questions about the error message, you can contact support at support[at]retention[dot]com.
