ePrivacy and GPDR Cookie Consent by Cookie Consent Skip to main content

Channel configurations

The Administration/Configurations/Channels tab in Meiro Business Explorer enables businesses to configure channels for running campaigns. This guide provides a step-by-step tutorial on configuring the Email and Mobile Push channel in Meiro Business Explorer.

Learn from this article:

Email channel configurations

Mobile Push channel configurations

Configuring Email channel

Знімок екрана 2023-05-22 о 15.31.21.png

SMTP account settings

SMTP is the standard protocol used for sending email messages over the Internet. To enable email delivery, you need to specify the SMTP account settings. The SMTP account information, including the server name, port, and credentials, can typically be obtained from the email service provider.

Server name

the address of the SMTP server that will be used to send email messages. 

Port number

he specific port on which the SMTP server listens for incoming connections. The most commonly used port for SMTP is port 587, but other options are available, such as port 465 or port 25.

Username and password

the login credentials required to authenticate with the SMTP server. These are typically the same as the credentials used to access the email account that you're using to send email.

Remember: different email service providers may have slightly different processes for obtaining this information, so it's best to consult the documentation for the specific email service provider being used, e.g., on Gmail, Microsoft Outlook, Zoho Mail.

By default, the connection type is STARTTLS, which means that the CDP uses this protocol to encrypt the connection. STARTTLS is a security protocol used to encrypt the connection between the CDP and the SMTP server. This helps to ensure the privacy and security of the email messages being sent.

Configuration of email attribute

At the next stage, you need to select the attribute, which is customized with the help of the Meiro team. Only compound attributes (single or multiple), holding both email and consent of emails, can be selected.

Warning: changing the attribute may result in a delay in the update of segment counts under the Activation tab. It may take some time for the changes to be reflected in the system.

Verified Senders

In the "Verified Senders" section, you need to configure the email addresses that will be available for use as sender and reply addresses in your email campaigns. When creating an email, you can select from a list of email addresses you have previously verified in the configuration section. If you have marked a default email address, it will automatically fill in the email creation form.

To add a new email address to your list of verified senders, fill in the email address in the designated field and click the 'add address' button. Every email address you add must be verified by following a link sent to that email address.

Remember: you can remove an email address from the list of verified senders if it is not currently being used in any email campaign. Additionally, at least one email address must be configured in the "Verified Senders" section.

Setting Stitching Rule

To enable the inclusion of email events in the profile identity graph, the analyst must establish a stitching rule for the Meiro Email Message ID attribute and associate all pertinent email events with it.

Enabling emails bounce rate

Email bounces are typically obtained by email service providers and can be accessed via their REST API. In order to collect email bounce rates, it is necessary to establish a MI workspace that can extract the bounce information from the email service provider. Once the workspace is set up, the customer events can be constructed based on the extracted email bounces data.

The payload should include the unique message ID and email address as mandatory fields, while other optional fields like campaign ID, bounce type, reason, and subject can also be included. The message ID serves as a unique identifier for each email message and is generated on our end before sending out the email. The example of payload:

  "id": "7ac8ba56-9d43-4a9e-8057-1b3e73890e80",
  "email": "example@meiro.io",
  "campaign": {
    "id": "7dac66f2-0300-495b-bb4e-72d7fa883f81",
    "name": "Abandoned Basket"
  "bounce_type": "soft_bounce",
  "reason": "spam",
  "subject": "You forgot to park your shopping cart",
  "utm_parameters": {
    "campaign": "abandoned_basket",
    "content": "",
    "medium": "email",
    "source": "",
    "term": ""

After constructing the customer events, they should be sent to CDP via the events loader. This ensures that the email bounce data is properly captured and available for analysis.

Configuring Mobile Push channel

Generate Firebase JSON file

Before configuring the Mobile Push channel, it is required to set up a Firebase account and generate a Firebase JSON file. Below is the sequence of steps to follow for setting this up:

  1. Once you have created a Firebase project, you can set up an app in Firebase for iOS or Android.
  2. In the Firebase console, open Settings -> Service Accounts -> click ‘Generate new private key’.

3. Click on the ‘Generate key’ to download the ServiceAccount.json file. This file is required to allow Meiro Business Explorer to access your Firebase project.

Configure Firebase account on MBE

To set the Mobile Push channel, the user must first configure the Firebase account under the Administration/Configurations/Channels tab. To configure the Firebase account, please upload the ServiceAccount.json file from the previous step.

Знімок екрана 2023-03-01 о 10.04.20.png

Set Registration token attribute

Once the Firebase account is configured on the CDP instance, you need to select the attribute that will be used as the registration token of the Mobile Push channel.

Configure the registration token attribute with the source attribute, which is customized with the help of the Meiro team. When the Mobile Push Channel is configured, but the attribute in the Registration Token is not set, the execution of the campaign will fail with an error message.

Warning: changing the registration token attribute may result in a delay in the update of segment counts under the Activation tab. The changes may take some time to be reflected in the system.

Attributes for Mobile Push channel

After you set up the Firebase account, the list of attributes for Mobile Pushes is generated automatically. They are visible under the Data Library/Attributes tab and may be used in the segment builder to limit the frequency of sending push notifications.

Знімок екрана 2022-12-20 о 13.56.42.png