Search

Relewise

Relewise is a SaaS platform used for personalization and recommendations.

Here are the steps to include Relewise content in sendouts from Design Studio.

Add a custom data source

A custom data source is required. This is done in the Configure Engage area of your Engage UI.

Custom data source configuration form showing the Name and ID fields

Name: Enter "Relewise" here. This is the name shown in Design Studio, allowing this data source to be selected and its data to be used.

ID: Enter "relewiserecs" as this value. It's important to use this exact ID for the setup to work.

Activate Parameters to reveal the Input JSON schema field. Insert the code block below:

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "title": "Parameters",
    "properties": {
        "relewiseId": {
            "title": "Campaign ID",
            "type": "string"
        },
        "relewiseModel": {
            "title": "Recommendation type",
            "enum": [
                "PopularProductsMostViewed",
                "PersonalProductRecommendations",
                "PopularProductsMostPurchased",
                "NewArrivalsProductRecommendations"
            ],
            "type": [
                "string"
            ]
        },
        "relewiseLanguage": {
            "title": "Language code",
            "type": "string"
        },
        "relewiseEndpoint": {
            "title": "URL endpoint",
            "type": "string"
        }
    },
    "required": [
        "relewiseEndpoint",
        "relewiseLanguage",
        "relewiseModel",
        "relewiseId"
    ]
}

Select Save.

The Design Studio module

In the Design Studio editor, do the following:

  1. Open an email template.
  2. Go to the Starter library module.
  3. Under the Partner category, the Relewise module should be visible.
  4. Drag the module onto your email canvas.

Find the module's data source settings.

Design Studio data source settings panel for the Relewise module, showing fields for Campaign ID, Recommendation type, Language code, and URL endpoint

You'll need to fill in some additional parameters for the data source. Go to the Email area in the Relewise portal and either use an existing product recommendation or create a new one.

Campaign ID can be copied from the settings page:

Relewise settings page showing the Campaign ID field

In the Raw HTML code block, locate a long URL that starts with the following pattern:

https://cdn.relewise.com/brandname-b2c-55f8e1cf-d77a-4823-aceb-531cd9d7a488/production/.....

URL endpoint: This is the first part of the URL, as shown in the example above. It should end with "production".

Language code: This will normally appear at the end of the long URL as ...language=en-GB, in standard ISO format such as "en-GB".

After adding these parameters in Design Studio, images should appear when Preview with data is activated. The Language code and Recommendation type parameters can be changed at any time.

If you're creating content for several markets, change the Language code value in Localization mode in Design Studio and it will be saved for that market.

In some Relewise setups, only Campaign ID can control the product language.

The module can now be styled like any other module and saved in the Team library for future use.

Sendout from Design Studio

When creating a sendout, use your Relewise module from the Team library. If needed, change the Campaign ID parameter, which can be copied from the Relewise portal.

Relewise settings page showing the Campaign ID field

Relewise is a SaaS platform used for personalization and recommendations. 

Here are the steps to include Relewise content in sendouts from Design Studio.

Add a custom data source

A custom data source is required. This is done in the Configure Engage area of your Engage UI.

The add data source dialog in the Engage UI

Name: Enter "Relewise" here. This is the name shown in the Email Design Studio, allowing this data source to be selected there and the data from it to be used.

ID: Enter "relewiserecs" as this value. It's important to use this ID to make the setup work.

Now activate Parameters to reveal the Input JSON schema field. Insert the code block below:

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "title": "Parameters",
    "properties": {
        "relewiseId": {
        "title": "Campaign ID",
            "type": "string"
        },
        "relewiseModel": {
            "title": "Recommendation type",
            "enum": [
                "PopularProductsMostViewed",
                "PersonalProductRecommendations",
                "PopularProductsMostPurchased",
                "NewArrivalsProductRecommendations"
            ],
            "type": [
                "string"
            ]
        },
        "relewiseLanguage": {
        "title": "Language code",
            "type": "string"
        },
        "relewiseEndpoint": {
        "title": "URL endpoint",
            "type": "string"
        }
    },
    "required": [
        "relewiseEndpoint", 
        "relewiseLanguage",
        "relewiseModel",
        "relewiseId"
    ]
}

Now press Save.

The Design Studio module

In the Design Studio editor, do the following:

  1. Open an email template
  2. Go to the module Starter library
  3. Under the "Partner" category, the Relewise module should be visible
  4. Drag this module onto your email canvas

Now find the module's data source settings.

The data source settings dialog for a module

To make this work you'll need to fill in some more parameters for the data source. Go to the Email area in Relewise portal and either use an existing product recommendation or create a new one.

Campaign ID can be copied from the settings page:

Dialog showing the campaign ID field

Now look at the Raw HTML code block and locate a long URL that starts with the following pattern:

https://cdn.relewise.com/brandname-b2c-55f8e1cf-d77a-4823-aceb-531cd9d7a488/production/.....

URL endpoint: This will be the first part of the URL as in the example above. It should end with "production"

Language code: This will normally be last in the long URL ...language=en-GB and have the standar ISO format such as "en-GB"

After adding these parameters in Design Studio, the images should appear when Preview with data is activated in Design Studio. The "Language code" parameter can be changed as can "Recommendation type".

If you are creating content for several markets, change the "Language code" value in Localization mode in Design Studio and it will then be saved for that market.

In some Relewise setups, only "Campaign ID" can control the product language.

Now the module can be styled as any other module and saved in the Team library for future use.

Sendout from Design Studio

When creating a sendout, use your Relewise module from the team library. If needed, change the Campaign ID parameter, which can be copied from the Relewise portal.

Dialog showing the campaign ID field

Was this article helpful?

/