Smart alerts about problems with campaign display

Published September 30, 2022
Modules
Difficulty

Synerise workflows allow you to create customized mechanisms, thanks to which you can monitor any campaign you create and see if it is properly displayed, what results it generates, whether it is clickable, etc. One of such types of campaigns are recommendation campaigns displayed on the website or in the application, which let you prepare fully personalized content for your audience. The key element during creating recommendation campaigns is controlling if they are displayed correctly for your customers.

Problems with campaign display might occur in case of:

  • changes on the website (for example in HTML structure or CSS selectors),
  • problems in settings of campaign filters (too narrow),
  • errors in product feed.

Alerts are very efficient in cases that require immediate actions. When an incident occurs, you can use a workflow which generates an alert message and sends it to your Slack channel with information that your campaign does not work. In this situation, you can react immediately and check the campaign settings.

In our use case, we will create a workflow that starts hourly and checks if the recommendation campaign on the website was generated any and displayed during the last 60 minutes. If not, the workflow sends an alert message to the Slack channel. When counting how many times the recommendation was displayed, we will use events generated in the customer’s profile every time it happens.

Prerequisites


Process


In this use case, you will go through the following steps:

  1. Create a metric which counts how many times a campaign was displayed during the last 60 minutes.
  2. Create a workflow that sends an alert message.

Create a metric


In this part of the process, you create a metric which counts how many times a recommendation was displayed during the last 60 minutes.

  1. Go to Analytics icon Analytics > Metrics > New metric.
  2. Enter the name of the metric.
  3. As the metric type, select Simple metric.
  4. As the aggregator, set Sum.
  5. As the occurrence type, set All.
  6. From the Choose event dropdown list, select dynamicContent.show.
  7. Click where icon button.
  8. Click the Choose parameter button.
  9. From the dropdown list, select id.
  10. Click the Choose operator button.
  11. From the dropdown list, select Equal.
  12. As the value of the operator add the ID of your dynamic content campaign. To find it, go to Communication > Dynamic content, find your campaign on the list and click the three-dot button. Hover over the ID of the campaign and click Copy ID.
  13. Click Save.
Metric configuration
Metric configuration
Note: In our case, we use a dynamic content campaign with product recommendations, which automatically generates the dynamicContent.show event when the campaign is displayed on the website. This event has an id parameter which specifies the ID of the dynamic content campaign. However, this metric can be based on any other event, depending on how the campaign is implemented.

Create a workflow


In this step, you will create a workflow which triggers every hour and checks if the campaign was displayed in the last 60 minutes. If not - it sends an automatic alert to your Slack channel.

  1. Go to Automation icon Automation > Workflows > New workflow.
  2. Enter the name of the workflow.

Define the Scheduled Run trigger node


At this stage, you configure the conditions that trigger the workflow.

  1. As the trigger node, add Scheduled Run.
  2. In the configuration of the node:
    1. Leave the Run trigger option at default (all time).
    2. From the Timezone dropdown list, select the time zone consistent with the timezone selected for your workspace.
    3. Define the frequency of the workflow. In this use case, it’s every day, every hour from 8:00 to 22:00.
    4. Confirm by clicking Apply.
The configuration of the Scheduled Run node
The configuration of the Scheduled Run node

Define the Metric Filter node


In the Metric Filter node, you will select the metric prepared in the previous part of the process. The continuation of the workflow will depend on the result of the metric. If the metric result is equal to or less than 0, an alert will be sent to a Slack channel.

  1. After the trigger node, add Metric Filter.
  2. In Define condition, choose the metric created in the previous step.
  3. As the condition, by using the mathematical operators, set the metric result as equal to 0.
  4. Click Apply.
The configuration of the Metric Filter node
The configuration of the Metric Filter node

Define the Send Channel Message node


In this step, you will configure the settings of the outgoing integration that sends the alert message to a Slack channel.

Create a connection

  1. As the matched path after the Metric Filter node, add the Slack > Send Channel Message node.
  2. In the configuration of the node:
    • If you already have created a connection, select the connection from the list.
    • If you haven’t created any connection yet:
      1. At the bottom of the dropdown list, click Add connection.
      2. In the Incoming Webhook URL field, enter the incoming webhook URL you created as a part of prerequisites.
      3. Click Next.
      4. In the Connection name field, enter the name for the connection you created.
      5. Click Apply.
        Result: A connection is created and selected.

Define the integration parameters

  1. In the Type of message field, choose Simple text message.
  2. Below, in Add text message, add the content of the message which should be sent to the Slack channel.
  3. Confirm by clicking Apply.
Configuration of the workflow that sends alert messages based on the metric results to the Slack channel
Configuration of the workflow that sends alert messages based on the metric results to the Slack channel

Prepare the final settings


  1. Add End nodes where the workflow should finish for users.
  2. Optionally, define capping.
  3. Optionally, add titles to each node so the workflow will be more understandable to your colleagues.
  4. Name the workflow.
  5. To save it as a draft, click Save, or activate the workflow by clicking Save & Run.
Workflow configuration
Workflow configuration

Check the use case set up on the Synerise Demo workspace


You can check the metric and workflow configuration directly in Synerise Demo workspace.

If you don’t have access to the Synerise Demo workspace, please leave your contact details in this form, and our representative will contact you shortly.

Read more


😕

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