• Trust
  • 提交请求

    • Need assistance with your Emarsys product?
    We'll get you the help you need!

     

    Emarsys client

     

    Emarsys client
    SAP for Me Login

    You can contact our support team via the SAP for Me.

    The Emarsys component: CEC-EMA

    		Login to the Help Portal and Submit your request. 
    1. Emarsys
    2. 电子邮件
    3. Email templates

    Creating and managing templates:: Updating the contents of a VCE template
    更新

    This page provides you with information on how to identify and update the existing blocks and variables of a VCE template, also called block-based email template.

    Important:

    • Changing a template initially created by Emarsys is at your own risk.
    • Before editing a VCE template it is highly recommended to create a backup copy of the modified content at a secure location.

    Determining the base template of an email campaign

    To open your existing email campaign and identify which VCE template is used as the basis of the campaign:

    1. Go to Channels > Email Campaigns, select the email campaign and click the Edit (pencil) icon.
    2. In the Content Creation page, click the three dots (...) icon in the upper right corner.
    3. Check the name of the VCE template that is used as the basis of your campaign.

    Use the Account switcher if the template for the email campaign is on a different account.

    How to identify which block to modify

    To find out which block of your template to change, just hover over the content blocks. The name of the block is visible in the appearing feature bar.

    Modifying the contents of a template

    1. You can open the template for editing in either of the following options:

    • Option 1: Go to Channels > Email Campaigns, open your email campaign and in the Content Creation page click the three dots (...) icon and select Open template.
    • Option 2: Go to Content > Block-Based Templates select the template and click the Edit (pencil) icon.

    2. In the Blocks tab select the template block you would like to edit and click the Edit (pencil) icon to see its code.

    Template contents to update

    Text: Modifying text in a block

    In the block code select the position where you want to change or delete an existing text. You can also add a new text here.
    For example: You can change the text from "Any Street 1" to "Any Place 1".

    To insert a manual line break, use the <br> tag. You can join <br> tags to generate a paragraph or a larger spacing between text rows.
    For example:

    The result, as it is visible in the email campaign:

    It is strongly not recommended to use the <br> tags at the very beginning or at the end of a continuous text to generate additional spacing at the top or at the bottom, as these <br> will not be displayed.

    Images

    Images: Modifying an image

    Search for the image you would like to change in the code. Images are usually embedded via an <img> tag that has a src attribute. The value of the src attribute is the image path.

    Example
    <img src="https://www.yoursite.com/img/image.png">

    In templates created by Emarsys, the embedding of an image normally is as follows:
    <img src="{variables.imgpath}image.png">

    In the code examples any additional HTML attributes, CSS styles, classes, e-editable, etc. are removed, except the src attribute.

    Media Database: Modifying an image

    In templates created by Emarsys, the value of the variable imgpath leads to a specific folder in the Media Database of your account, containing all the assets of your template. The variable imgpath may also be available in a custom template which was created as a copy of an Emarsys-built VCE template.

    By opening the Variables tab of your template you can see the value (=the folder path) of the variable imgpath .

    Example: The images used in the template are found in the folder "vce" in the Media Database.

    It is not recommended the variable imgpath to be changed. Note that the image path may lead to a Media Database folder in another account, which is not accessible.

    Keeping the original image filename

    Usually, when uploading an image into the Media Database, the file gets an internal file name.
    For example:
    md_[Internal file ID].[File suffix],
    e.g. md_123456.png.
    To avoid this to happen, you can disable this feature by ticking the following checkbox.

    Click Options button, the three dots (...) in the Media Database and select Copy URL to see the full image path.

    You can easily replace the existing value of the src attribute in the <img> tag to change the image.

    In case of using an Emarsys-built template and you uploaded the new image to the template's asset folder ({variables.imgpath}), you can replace the image by changing the file name in the image's src attribute.

    Check if you want to add additional attributes, styles to the <img> tag.

    Additional attributes, styles for embedded images

    Width, height attributes

    You can set a specific width or height in pixel unit to an image via the HTML attributes width and height.

    Note that the unit (px, etc.) must not be added to the value. If only one value (either the width or the height) is provided, the other value will be calculated automatically.

    Examples

    <img src="https://www.yoursite.com/img/image.png" width="200">
<img src="https://www.yoursite.com/img/image.png" height="150">
<img src="https://www.yoursite.com/img/image.png" width="200" height="150">
    Click to copy

    If you are using a template created by Emarsys, then you can also add the CSS class image which will cause the image to be scaled to 100% of the available space in the mobile version:

    <img src="https://www.yoursite.com/img/image.png" width="200" class="image">

    The screen width of mobile devices is usually between 320 and 430px, so we recommend images that are of a width of 300px and up to get the class image to scale properly in the mobile version.

    Alt attribute

    The alternative text of an image is usually displayed in these cases:

    • The image content or external content has not been downloaded. 
    • The image path is broken or the image is not available. 

    Example
    <img src="https://www.yoursite.com/img/image.png" alt="Lorem ipsum">

    The alternative text is not displayed in all email environments.

    Border attribute

    Normally, if an image is linked (an opened <a> and closed </a> tag is surrounding the <img> tag), it is recommended to add the attribute border="0" to the <img> tag to prevent a border to appear around the image.

    Example
    <img src="https://www.yoursite.com/img/image.png" border="0">

    Display:block style

    As long as an image is not embedded as an inline item, it is advised to apply the style display:block by default. This style prevents padding to appear at the top and at the bottom of an image in some email environments.

    Example
    <img src="https://www.yoursite.com/img/image.png" style="display:block;">

    Variables

    Variables: Modifying variables of a template

    A variable can be used more than once in a template. For example, you can use variables in the Frame, Style or in blocks. So, editing a variable may not affect only a specific part, but other contents, too.

    In some cases, it is necessary to create a copy of the variable in order to be changeable independently. For more information, see Setting-up-template-variables.

    Variables can be used in the template's Frame, Style or in blocks and are embedded like this:
    {variables.variableName}

    Check the embedding of the variables you would like to change to see which values can be used: string, color code, integer, etc.

    1. Select the Variables tab and search for the variable you would like to edit.
    1. Click Edit to change the type or the values.

    Saving the template changes and updating existing campaigns

    1. Save the email template changes when you finished editing it.
    1. Update existing email campaigns for the changes to take effect.

    For more information regarding updating your existing campaigns, see:

    Modifying email templates - FAQ

    An existing email campaign has been updated with template changes and saved. Why are the changes not visible?

    • Make sure your email campaign is based on the template you edited. 
    • The email campaign may not have been updated properly. After applying an update, the campaign needs to be saved. 
    • Once you edit a content item (text, image, link) or a variable in your campaign, so it differs from the default content or value, this item keeps the changes made, even if you apply a campaign update. 
    • To see the changes, it is necessary to reset the block or the variables.

    Resetting a block will change all the content back to the default values of text, links, images.

    Instead of resetting the block, you can drag&drop a new block into your campaign to replace the existing one.

    Template variables are not automatically reset via the Reset block button. They can be reset to their default value either via Block Style Settings on block level, or globally via Campaign Style Settings. For example, if a variable is used in the template's Frame only.

    Reset via Block Style Settings.

    Reset via Campaign Style Settings.

    Settings applied via Campaign Style Settings can be overridden by the same settings done on block level, so it might be necessary to reset the variables with both options shown.

    这篇文章有帮助吗？
    0 人中有 0 人觉得有帮助
    返回页首