Create a New Target Group from SFTP

📘

Before creating a Target Group, we recommend you to read the Target Group Requirements and Constraints.

  1. Navigate to Campaign management > Target data > Target Group List screen and click + Add new.

  1. The Select target group source screen appears. Select SFTP from the drop-down and click Confirm.

  1. Enter details for the following fields on the screen that appears:

    • Target group name: Enter a name for the Target Group.

    • Supported channels: Select the channels the target group should be supported for.

    • Description: Enter a description for the target group.

    • SFTP server: Select the SFTP server from the drop-down.

    • Select file (txt, .csv only): Select the path of the input file.

    • Configure header encryption: To enable encryption for headers, click Configure option available for Headers Encryption. When the source is selected, the headers from the target group are displayed. You can enable or disable the encryption of the headers as required. The PII data headers like EMAIL, MSISDN, and CUSTOMERID are encrypted by default.

      📘

      If a header is decrypted in a Target Group, it will remain decrypted for all future Target Groups that you will upload. If you wish to encrypt a specific header, kindly reach out to the support team at [email protected]. Once your request has been processed by the support team, that header will be encrypted for all subsequent Target Group creations. Once a header has been configured for encryption/decryption, it will remain permanently in that state, and this decision cannot be reversed.

    • Configure header validation: To mark headers of the data as mandatory, click the Configure option available for Headers validation. This feature is applicable for outbound promotion deployments whose TGs source is either File upload or SFTP. In the example screenshot below, the channels applicable for this TG are Email. Therefore, the EMAIL header is automatically marked as mandatory. In addition to the default-mandatory header, you can specify any other headers within the file as mandatory.

1157
  1. Configure Additional Information.

    • Target group type. The options are:
      • Static: A .txt file with complete records will be picked up for creating the Target Group.
      • Dynamic: Click Browse and select a sample file. You can enter the format of the file as below:
        • Add a * wildcard to capture any file that meets the convention. For example, samplefile_*.txt picks up samplefile_01152022.txt as well as samplefile_02162022.txt if both are present in the SFTP folder.
        • Add a date format expression such as $(yyyyMMdd).txt to only pick up a file that has year-month-and-date format. For example, samplefile_$(yyyyMMdd).txt will pick up samplefile_20220815.txt.
1150

We support the following file formats:

FilenameFormat
samplefile_20220815.txtsamplefile_$(yyyyMMdd).txt
samplefile_15082022.txtsamplefile_$(ddMMyyyy).txt
samplefile_081522.txtsamplefile_$(MMddyy).txt
samplefile_15-08-22.txtsamplefile_$(dd-MM-yy).txt
samplefile_22-15-08.txtsamplefile_$(yy-dd-MM).txt
samplefile_20220815 123946.txtsamplefile_$(yyyyMMdd HHmmss).txt
samplefile_20220815123946.txtsamplefile_$(yyyyMMddHHmmss).txt

📘

To upload a data file, it should be a .csv (the .csv format is available starting V6.4) or pipe delimited .txt file format. MSISDN should always be present as the first column for mobile communications and EMAIL should always be present for email communications.

  • Configure In case of an issue with a record. The options are:

    • Skip particular record: Select this option to skip the record that has an issue.
    • Skip the file once the threshold is reached: Select this option and enter a threshold to skip the file if the threshold is reached. You can enter the threshold value in absolute records or in the percentage of the records in the file.
  • Configure Skip the remaining file once the threshold is reached. The options are:

    • Threshold: Select the Absolute or Percentage.
    • Value: Enter the value.
  • Configure Remote updates. The options are:

    • Do not Allow
    • Allow
  • Configure File processing. The options are:

    • Rename once processed: Select this option to rename the file once processed. Once the file is renamed, it will be named as {input file}_done.
    • Move to processed folder once processed: Select this option to move to Processed folder once the file is processed. A folder with the name processed will be created if not created already.
1142
  1. Click Save & proceed.