Distribution Links Embedded data | XM Community
Skip to main content

Hello, 

What I am trying to do is the following. 

Step 1 - I am creating a mailing list 
Step 2 - I am pulling data from a json file and adding this data to the mailing list as contacts including Embedded data such as Tenant etc. etc. 
Step 3 - I am creating distribution 
Step 4 - I am listing the distribution links 

All of the above is managed through the API connectors and everything works as intended, but what I am struggling to find is the following. 

Since the email marketing campaign will be managed externally by another tool, I need to generate the unique URLs for the unique contacts and then I need to send them back to the external tool including the “Embedded data” which is already present in Qualtrics from “Step 2”. 

Any ideas would be highly appreciated. 

Thanks! 

@ElianManev We have a very similar scenario in place where we have an external tool for all marketing initiatives which has custom logic to generate the personalized links and include them in the emails sent to the customers. However we do not need the embedded data from the distribution for setting up the emails as all customer information to personalize the emails is available in the marketing tool. 

To personalize the survey with the embedded data, everything is already stored in the survey links. 

As I understood your requirement, you need to pass the personal links together with the embedded data - probably because your system does not know which link belong to which customer? 

When you fetch the links from the distribution, you will only have the standard contact fields (such as first and last name), but not the custom embedded data fields. 

{
"contactId": "CID_6SvNjhDzWKKWdCt",
"contactLookupId": "CGC_2SvBjhAzwZK4dEx",
"distributionId": "EMD_m3ox030by7ydblg",
"status": "Pending",
"surveyLink": "https://yourdatacenterid.qualtrics.com/WRQualtricsSurveyEngine?Q_DL=bQNtCGvkeC1rJs1_efmR5rlb76FBjy5_CGC_aabb1122cc3344d",
"contactFrequencyRuleId": "CFR_gNV8vMdKZtWbT34",
"responseId": "R_YXIPQimT0z0A3i9",
"responseCompletedAt": "2017-07-21T17:32:28Z",
"sentAt": "2017-07-21T17:32:28Z",
"openedAt": "2017-07-21T17:32:28Z",
"responseStartedAt": "2017-07-21T17:32:28Z",
"surveySessionId": "FS_1CwF4quYDr7AzoD"
}

However, it contains the contactId property which will help you to retrieve the embedded data using one of the APIs below: 

  • Either read all mailing list contacts and check for the contact with the same contactId - set includeEmbedded to true which will then provide you all embedded data for each mailing list contact in property embeddedData or
  • Read the contacts and their embedded data one by one

Best
Christian


Leave a Reply