۶Ƶ

DocumentationCampaignCampaign Classic v7 Documentation

[Also applies to v8]{class="badge positive" title="Also applies to Campaign v8"}

Target mapping target-mapping

Last update: Tue Nov 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Developer

Target mapping creation is necessary in two cases:

  • if you use a recipient table other than the one provided by ۶Ƶ Campaign,
  • if you configure a filtering dimension which is different from the standard targeting dimension on the target mapping screen.

The target mapping creation assistant will help you create all schemas required to use your custom table.

Creating and configuring schemas linked to the custom table creating-and-configuring-schemas-linked-to-the-custom-table

Before you create a target mapping, several configurations are necessary in order for ۶Ƶ Campaign to operate with a new recipient data schema.

To do this, apply the following steps:

  1. Create a new data schema which integrates the fields of the custom table that you want to use.

    For further information, refer to Schema reference (xtk:srcSchema).

    In our example, we will create a customer schema, a very simple table containing the following fields: ID, first name, last name, email address, mobile phone number. The aim is to be able to send email or SMS alerts to the individuals stored in this table.

    Example schema (cus:individual)

    code language-none 
    
<srcSchema name="individual" namespace="cus" label="Individuals">
  <element name="individual">
    <key name="id" internal="true">
      <keyfield xpath="@id"/>
    </key>
    <attribute name="id" type="long" length="32"/>
    <attribute name="lastName" type="string" length="100"/>
    <attribute name="firstName" type="string" length="100"/>
    <attribute name="email" type="string" length="100"/>
    <attribute name="mobile" type="string" length="100"/>
  </element>
</srcSchema>

  2. Declare your schema as an external view using the =“true” attribute. Refer to The view attribute.

    code language-none 
    
 <srcSchema desc="External recipient table" namespace="cus" view="true"....>
   ...
 </srcSchema>

  3. If you need to add a direct mail address, please use the following type of structure:

    code language-none 
    
<element advanced="true" name="postalAddress" template="nms:common:postalAddress">
     <attribute expr="SubString(JuxtWords(Smart([../infos/@firstname]), Upper([../infos/@name])), 1, 80)"
                name="line1"/>
     <attribute expr="Upper([../address/@line2])" name="line2"/>
     <attribute expr="Upper([../address/@line])" name="line3"/>
     <attribute expr="Upper([../address/@line])" name="line4"/>
     <attribute expr="Upper([../address/@line])" name="line5"/>
     <attribute expr="Upper([../address/@line])" name="line6"/>
     <attribute _operation="delete" name="line7"/>
     <attribute _operation="delete" name="addrErrorCount"/>
     <attribute _operation="delete" name="addrQuality"/>
     <attribute _operation="delete" name="addrLastCheck"/>
     <element expr="@line1+'n'+@line2+'n'+@line3+'n'+@line4+'n'+@line5+'n'+@line6"
              name="serialized"/>
     <attribute expr="AllNonNull2([../address/@line], [../infos/@name])" name="addrDefined"/>
   </element>

  4. Click the Administration > Campaign management > Target mappings node.

  5. Click the New button to open the target mapping creation assistant.

  6. Enter the Label field and select the schema which you have just created in the Targeting dimension field.

  7. In the Edit address forms window, select the fields of the schema which match the various delivery addresses. Here, we are able to map the @email and @mobile fields.

  8. In the following Storage window, enter the Suffix of the extension schemas field to differentiate the new schemas from the out-of-the-box schemas provided by ۶Ƶ Campaign.

    Click Define new additional fields to select the dimension you want to target in your delivery.

    By default, exclusion management is stored in the same table as messages.

    Check the Generate a storage schema for tracking box if you want to configure storage for the tracking linked to your target mapping.

    note important
    IMPORTANT
    ۶Ƶ Campaign does not support multiple recipient schemas, know as targeting schemas, linked to the same broadlog and/or trackinglog schemas. This can otherwise lead to anomalies in data reconciliation afterwards. For more information on this, refer to the Recommendation and limitations page.

  9. In the Extensions window, select the optional schemas that you want to generate (the list of available schemas depends on the modules installed on the ۶Ƶ Campaign platform).

  10. Click the Save button to close the assistant.

    The assistant uses the start schema to create all the other schemas required to make the new target mapping work.

Using target mapping using-target-mapping

There are two ways of using the new schema as the target of a delivery:

  • Create one or more delivery templates based on mapping
  • Select mapping directly during target selection when creating a delivery, as shown below:

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1