Overview
With the Poplar integration you can leverage all of your customer data in Cordial to build highly relevant and personalized one-to-one direct mail to customers. From passing in unique codes tied to individual customers to pulling in relevant categories, you can utilize the most impactful data for your mail piece.
In addition, you can easily add direct mail to any new or existing email or SMS automation. Start sending automated direct mail from Cordial with an easy integration that you can launch in minutes—and with no development.
Create Poplar Mail Campaign
1. In order to integrate Poplar with Cordial, you first need to create a mail campaign in Poplar.
2. Upload your creative content into Poplar and create the campaign.
3. Once your Poplar mail campaign is created, you'll receive a unique Campaign ID.

Set up the Poplar Integration

Parameter | Value |
HTTP endpoint | https://api.heypoplar.com/v1/mailing/ |
HTTP request method | POST |
HTTP request header | Authorization : Bearer <Test or Production API Token> |
Content type | application/json |
5. The Script section at the top is where you'll enter logic for the recipient data being passed to Poplar. If your campaign has address enrichment enabled, only email and any other custom merge tag data needs to be passed. If mailing to existing customer addresses, you'll pass in the full address. Examples of each can be copy, pasted, and adjusted as needed:
Mailing Address
{
"recipient": {
"full_name": "{$contact.first} {$contact.last}",
"address_1": "{$contact.geo_mailing.street_address}",
"address_2": "{$contact.geo_mailing.street_address2}",
"city": "{$contact.geo_mailing.city}",
"state": "{$contact.geo_mailing.state}",
"postal_code": "{$contact.geo_mailing.postal_code}"
},
"campaign_id": "XXXXX-insert unique campaign ID-XXXXX",
"creative_id": "XXXXX-insert unique creative ID (optional)-XXXXX"
}
Address Enrichment
{ "recipient": { "email": "{$contact.channels.email.address}" }, "campaign_id": "XXXXX-insert unique campaign ID-XXXXX", "creative_id": "XXXXX-insert unique creative ID (optional)-XXXXX" }
6. Click the Preview button in the top right to see a preview of the request. Make sure all of the data maps properly. If everything looks correct, select Back in the top right and then Save the settings.
7. Once your settings have been saved, click the Send Test button in the top right to test the integration. If the connection is successful, you'll see a mailer appear under the campaign's History tab.
8. If the connection is successful, select Publish.
9. Select Event Triggered under Sending Methods to set the desired trigger conditions. Audience filters can also be added to refine your target audience (if needed).

10. Be sure to Save and then Enable the trigger to set it live. Recurring sending methods can also be enabled for use cases such as buyer anniversary, monthly customer birthday discounts, and other time-specific events.
Merge Tags and Variable Data
Coupon codes, loyalty status, and even browsed items are among many examples of variable data stored in Cordial that can be passed to Poplar—and utilized in Creative design via custom merge tags.
1. When setting up your Rest Automation, you'll need to include the merge tags and their dynamic values as an object in the Script section of your REST Parameters. Here's one example:
{$coupon.key='coupon-codes'}
{$coupon=$supplements->reserveOne($coupon.key)}
{$browseditems=$supplements->getEventRecords("productView",null,[],1,['column'=>'ats','direction'=>'DESC])}
{foreach$browseditems as $item}
{
"recipient":{
"full_name":"{contact.first}{$contact.last}",
"address_1":{contact.geo_mailing.street_address}",
"address_2":{contact.geo_mailing.street_address}",
"city":{contact.geo_mailing.city}",
"state":{contact.geo_mailing.state}",
"postal_code":{contact.geo_mailing.postal_code}",
},
"merge_tags:{
"loyalty_status":"{$contact.loyalty_status}",
"category":{$item.properties.category}",
"product_image":"{$item.properties.image}",
"coupon_code":"{$coupon.code}
},
"campaign_id":"776ee223-8899-7123-8765-8e987w96234b6",
"creative_id":"776ee223-8899-7123-8765-8e987w96234b6"
}
{/foreach}
2. You'll know the request is successful and the merge tags are mapping accordingly if a test mailer appears in the campaign's History tab. Click into the mailer and scroll down to see the request details.
Reach out to Cordial Support for additional assistance.
Comments
0 comments
Please sign in to leave a comment.