Using basic drag & drop builder

The basic drag & drop builder is an external solution provided by BeeFree implemented in Synerise that lets you create an in-app message template by dragging and dropping elements.

It is a great choice for creating in-app templates because it’s user-friendly and efficient, provides visual control, offers customization options, supports collaboration, simplifies updates, and makes campaign management accessible to non-technical users.

You can personalize the content of the message by using inserts. Inserts let you refer to customer attributes (such as name, city, size), product recommendations (for example, last seen items or added to a cart), and the results of aggregates, expressions, and metrics.

Good practices

When creating or editing in-app message content:

  • Place the the SRInApp.close() (or SRInApp.hide()) method at the beginning of the JS script.
  • Use try/catch to handle possible fatal errors in the JS script.
  • Handle situations where Jinjava inserts return empty data.
  • When adding external links to your message:
    • Only link to sites you trust.
    • Don’t link to large images that may negatively affect performance.
    • Don’t link to resources whose CSS/HTML may be blocked. If you have resources loaded from your own URLs, set Synerise.settings.inAppMessaging.contentBaseUrl and use relative paths in HTML/CSS.

Building templates


  1. Go to Communication > In-App Messages.
  2. On the left pane, click Templates > New template.
  3. On the pop-up, select Drag & drop builder.
  4. Proceed according to the instructions on building templates is available at the BeeFree help center.

Universal links and deep links are used to navigate to specific content within an app, while web links can display web content within the app itself. In the template builder, the Link type option lets you incorporate links into your in-app template. The builder automatically recognizes the link type you enter, triggering the corresponding action without requiring further configuration.

WARNING:

The following SDK versions automatically recognize the link type and adjust the action accordingly:

  • Android: 5.19.0 and higher
  • iOS: 4.18.0 and higher
  1. Drag the Button widget to the canvas.
    Result:
    A button widget added to the canvas
    A button widget added to the canvas
  2. Go to the widget editing mode by clicking the widget on the canvas.
    Result: The editing options appear on the right pane.
    The configuration of the Button widget
    The configuration of the Button widget
  3. In the ACTION section, set the Link type option to Open web link:
    • To add a web or universal link, in the Url field, enter a URL address including the HTTP or HTTPS protocol, for example: https://example-link.com/
    • To add a deep link, in the Url field, enter a URL in the format of mobile deep linking, for example: myapp://product?id=123
      Tip: You can use Jinjava inserts in links for personalization.

Creating HTML blocks


Apart from the standard building elements such as Title, Paragraph, List, Image, Button, Divider, Social, HTML, Icons, and Menu, the basic builder includes the custom, Synerise-native HTML blocks element. The configuration of this element takes place in the Synerise-native code editor, that lets you derive the benefits provided by the code creator such as:

  • creating re-usable HTML block templates,
  • creating a block to be edited in an easy-to-use configuration form that doesnโ€™t require programming skills
  • previewing the block in the context of a specific customer in isolation from the in-app message template
    Note: You can also preview the whole template in the context of a specific customer.
  1. On the right side of the screen, select and drag the HTML blocks element to the template.
    Result:
    The HTML block added to the template
    The HTML block added to the template
  2. On the HTML blocks you added to the template, click Configure.
    Result: A pop-up appears.
  3. On the upper right side, click New block.
  4. Create the structure of an HTML block by following the instructions in the “Creating template” section.
    • You can build a simple HTML structure in the HTML section.
    • On the HTML tab, you can build an easy-to-use configuration form which can be filled out by users with no programming skills. To do so, add variables to the block template such as color pickers, dropdown lists (with aggregates, expressions, metrics, voucher pools, and recommendations created in Synerise), and fields, so the users who will use this template in a builder will need only to fill out the fields in this form. For example:
      Example field in a configuration form
      Example field in a configuration form
  5. To save this block as a template, click an arrow on the left to the Next button, and select Save as. On the pop-up, enter the name of the template and select the folder in which the template will be saved.
  6. To use this block in a dynamic content template, click Next.
Important: We recommend placing the HTML block as the sole element in the row. Additionally, ensure that the styling of the block is compatible with the styling of the template.

Previewing templates

  1. To check the preview of the template for a particular customer or a product, click the Preview button on the upper left side.
  2. Enter the ID of a customer or a product.
  3. Click Apply.
๐Ÿ˜•

We are sorry to hear that

Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.

๐Ÿ˜‰

Awesome!

Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.

Close modal icon Placeholder alt for modal to satisfy link checker