Update Target audiences and profile scripts for Decisioning mobile extension compatibility

After you complete the technical updates to migrate Target to the Offer Decisioning and Target extension, you may need to update some of your audiences, profile scripts, and activities to ensure a smooth transition.

If you migrate mbox paramters to the xdm object, before publishing your changes to production, you should:

Adjust audiences

If you migrate mbox paramters to the xdm object, audiences that use custom mbox parameters should be updated to use the new XDM parameter names. For example, a custom parameter for page_name would likely be mapped to web.webpagedetails.pageName.

One approach to ensure compatibility with both the Target extension and the Offer Decisioning and Target extension is to update any relevant audiences so that OR conditions are used, as shown below:

{modal="regular"}

Edit profile scripts

If you migrate mbox paramters to the xdm object, profile scripts should be updated to reference the new XDM parameter names, similar to audiences. Aside from the change of mbox parameter names, there is no difference in the way profile scripts work between a Target and Decisioning implementation.

One approach to ensure that compatibility is to use OR conditions in your profile script code.

Example profile script:

if(mbox.param('pageName') == 'Product Details'){
  return true
}

Updated profile script for Platform Web SDK compatibility:

if((mbox.param('pageName') == 'Product Details') || (mbox.param('web.webPageDetails.pageName') =='Product Details')){
  return true
}

For more information and best practices, refer to the dedicated documentation about profile scripts.

Update parameter tokens for dynamic content

If you migrate mbox paramters to the xdm object, and if you have any offers, recommendations designs, or activities that use dynamic content replacement, they may need to be updated accordingly to account for the new XDM parameter names.

Depending on how you are using token replacement for mbox parameters, you may be able to enhance your existing setup to account for both old and new parameter names. However, in situations where custom JavaScript code is not possible, such as in JSON offers, you should create copies and make updates after the migration is complete and live on your production site.

Example JSON offer:

{
  "pageName" : "${mbox.page_name}",
  "layoutVariation" : "grid"
}

Example JSON offer using XDM object parameter names:

{
  "pageName" : "${mbox.web.webPagedDetails.pageName}",
  "layoutVariation" : "grid"
}

If you choose to make adjustments after the migration to account for the new XDM mbox parameter names, be sure to pause any impacted activities during the migration event to prevent activity display errors to visitors.

Next, learn how to validate the Target implementation.