This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
en:dataexchange:import_which_properties_has_batchprocess [2019/06/04 16:44] – [Specifications personal data for import] fw | en:dataexchange:import_which_properties_has_batchprocess [2025/04/02 16:39] (current) – fw | ||
---|---|---|---|
Line 5: | Line 5: | ||
Please upload csv-files with addresses or target group definitions (with customer IDs or eMail addresses) to / | Please upload csv-files with addresses or target group definitions (with customer IDs or eMail addresses) to / | ||
- | Click on //Adresses > Lists//, choose action //Import addresses// and follow the given instructions. | + | Click on //Adresses > Lists//, choose action //Import addresses// and follow the given instructions. You can find a manual in article //" |
Line 42: | Line 42: | ||
|**Time of import**|Process is checking whether a file has been uploaded: daily at x o' | |**Time of import**|Process is checking whether a file has been uploaded: daily at x o' | ||
|**Creating a new target group**|Per import OR adding to a auto target group.| | |**Creating a new target group**|Per import OR adding to a auto target group.| | ||
- | |**If auto target group**|1) Adding OR replacing of the auto target group - possible methods: \\ - replace \\ - replaceNoResubscribes \\ - add \\ - addNoResubscribes \\ \\ 2) if auto target group is replaced: \\ Unsubscribing of all users that are not included in the current file?* \\ \\ <wrap lo>*critical feature; | + | |**If auto target group**|1) Adding OR replacing of the auto target group - possible methods: \\ - replace \\ - replaceNoResubscribes \\ - add \\ - addNoResubscribes \\ \\ 2) if auto target group is replaced: \\ Unsubscribing of all users that are not included in the current file?* \\ * Please note: this is not recommended and only possible if user data are synchronized completely and every night because users will be added to the blacklist.| |
Line 137: | Line 137: | ||
|special_2|varchar(255)| |Free variable for future use| | |special_2|varchar(255)| |Free variable for future use| | ||
- | ===== Automatic | + | ===== Automatic |
- | After the automatic import of a target group, you can carry out additional tasks by invoking an API call. A common application is the automatic set-up of an email with subsequent | + | After the automatic import of a target group, you can trigger |
This requires configuring an automatic import process through promio.net support. | This requires configuring an automatic import process through promio.net support. | ||
- | To do so, you must provide two files in a ZIP archive: | + | To do so, you must provide |
+ | This ZIP file must be named according to the agreed upon naming scheme and provided in the SFTP folder / | ||
==== user.csv ==== | ==== user.csv ==== | ||
Line 156: | Line 156: | ||
- | ==== action.xml ==== | + | ==== action.json ==== |
- | Contains | + | Contains |
+ | These are used after the automatic import | ||
- | The other values must be filled out correctly. Be certain to ensure that all text uses HTML entities throughout. | ||
- | < | + | === Maximum specification with all necessary and optional properties === |
- | < | + | < |
- | > => > | + | { |
- | etc. | + | " |
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | | ||
+ | ], | ||
+ | " | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | ] | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | ] | ||
+ | } | ||
+ | } | ||
+ | } | ||
</ | </ | ||
- | <code xml> | + | === Required fields and instructions |
- | <?xml version=" | + | |
- | < | + | |
- | | + | |
- | | + | |
- | | + | |
- | < | + | |
- | < | + | |
- | < | + | |
- | < | + | |
- | < | + | |
- | < | + | |
- | </ | + | |
- | < | + | |
- | <format xsi: | + | |
- | < | + | |
- | < | + | |
- | < | + | |
- | < | + | |
- | < | + | |
- | </ | + | |
- | </ | + | |
- | < | + | |
- | < | + | |
- | </ | + | |
- | < | + | |
- | < | + | |
- | <subject xsi: | + | |
- | < | + | |
- | < | + | |
- | < | + | |
- | & | + | |
- | </ | + | |
- | < | + | |
- | </ | + | |
- | </ | + | |
- | </ | + | |
- | </ | + | |
- | </code> | + | * // |
- | + | * necessary. Enter ID of the client. | |
- | This ZIP file must be named according to the agreed upon naming scheme and saved in the SFTP folder | + | * // |
+ | * required. Required field within: //name// | ||
+ | * Docs: [[https:// | ||
+ | * // | ||
+ | * required | ||
+ | * if // | ||
+ | * message is built from a template | ||
+ | * required: //name// | ||
+ | * if // | ||
+ | * required: //name// | ||
+ | * Docs: [[https:// | ||
+ | * // | ||
+ | * required for messages that are not created by a template | ||
+ | * required fields: // | ||
+ | * //text//: | ||
+ | * optional. Only necessary for a different text part. If //text// is not specified, | ||
+ | * //targetGroup// | ||
+ | * optional. Only necessary | ||
+ | * Target group ID is assigned automatically. | ||
+ | * Docs: [[https:// | ||
+ | * // | ||
+ | * optional. | ||
+ | * settings for delivery | ||
+ | * // | ||
+ | * for scheduling the campaign | ||
+ | * required: // | ||
+ | * Docs: [[https:// | ||
+ | * //start// | ||
+ | * delivery is only started if //start// is set. | ||
+ | * no required fields | ||
+ | * Docs: [[https:// | ||
+ | * // | ||
+ | * optional. Send a test mail. | ||
+ | * Docs: [[https:// | ||
+ | **Important: | ||
+ | The source code in // | ||
+ | The following (external) website provides information on how to escape, as well as an option to have source text escaped automatically: | ||
+ | === Examples === | ||
+ | Example of creating a message via HTML source code (incl. start delivery): | ||
+ | <code JavaScript> | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | }, | ||
+ | " | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | </ | ||
+ | Example of creating a message via template (without start delivery): | ||
+ | <code JavaScript> | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | } | ||
+ | </ | ||
- | {{tag>Import | + | {{tag>imports |