# MBurger User Guide 🍔

## Welcome to the MBurger official knowledge documentation

{% hint style="success" %}
Here you will learn everything you need to know about MBurger Knowledge and the best part is that each article is just a 1 min read :sunglasses:&#x20;
{% endhint %}

{% content-ref url="/pages/-MDPEJGWomFkGtFmFIXv" %}
[  Getting Started](/getting-started/definition)
{% endcontent-ref %}

{% content-ref url="/pages/-MDPbY4sdfnxZjM4TyvL" %}
[  Block - Model your content](/block/model-your-content)
{% endcontent-ref %}

{% content-ref url="/pages/-MDPgpqNXLr5yFagB-m8" %}
[ Element](/section-1/element-type)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTn809mULg1n4kwbC4" %}
[✍️  Manage Content](/section/section-content-management)
{% endcontent-ref %}

{% content-ref url="/pages/-MDxTsAiEnUID-fgU9lZ" %}
[Engagement](/engagement/engagement-platform)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTuIb10nl\_pAcsJLV5" %}
[ Control Panel](/control-panel/control-panel)
{% endcontent-ref %}

{% content-ref url="/pages/-MDUaYXEDMAvZ4-dNytA" %}
[  Plug-in](/plug-in/plug-in)
{% endcontent-ref %}


# Definition

![User uploaded image](https://mumblemo.teamwork.com/spaces/api/v1/spaces/880/pages/4611/attachments/inline/3168/view)

## **Block**

{% hint style="info" %}
A ***block*** is an abstract model with which you define the structure of a piece of content.&#x20;

Each *block* is made up of one or more *elements*.&#x20;
{% endhint %}

For example, if you are creating a *block* for a blog article, you would create a model presumably composed of:

* &#x20;A **textarea** *element* for the title
* &#x20;A **markdown** *element* for the actual content
* &#x20;An **image** image *element* for the featured image
* &#x20;A **dropdown** *element* to create and pick categories for your articles

## **Section**

{% hint style="info" %}
A ***Section*** represents the *block* when it has been filled with its content
{% endhint %}

{% hint style="success" %}
When you create the *block*  for a blogpost and add content to it, you get a *section*
{% endhint %}

## **Element**

{% hint style="info" %}
&#x20;With the term ***Element***, we identify the fields that make up a certain block.&#x20;
{% endhint %}

For instance, if the *block* is the model for a blog post, its *elements* could be a **text area**, **media**, **images**, **link** etc.

&#x20;


# Create a Project

{% hint style="info" %}
During the on-boarding phase, we will prompt you to create a new **project** directly
{% endhint %}

You can enter the name of your project (e.g. "MBurger web site" or "Silicon Valley Mobile App") and click the **Create** button to create your first MBurger project.

![](/files/-MDnXURNswAYcF5ZsguE)

{% hint style="success" %}
Well done!
{% endhint %}

Now let's move on to:

* [ ] Invite your team to collaborate on the project and set permissions for each user 🏀
* [ ] Generate your API key 🔗
* [ ] Create some blocks and get started with MBurger! :rocket:&#x20;


# Create a Block

{% hint style="info" %}
Once you've created your first project, you can create your first ***block***
{% endhint %}

In the left side menu, under "Block" click on **+ add Block**

![](/files/-MD_KRIObCmq3-SCIFzE)

It appears a central pop-up, in which you can add your Block's name (e.g. News, Blog, Products) and choose an icon.&#x20;

Click on **Create** and your first block will be ready to be customized.💥

![](/files/-MD_J41SWasEnywzr-xM)

{% hint style="success" %}
In the main menu on the left 👈, you will see your newly created block.&#x20;
{% endhint %}

Your dashboard will redirect you to the page where you can actually define the structure of the Block by adding Elements and defining their properties.

![](/files/-MDobs9J8UKEKRPJtgvC)


# How to modify the model of an existing block?

{% hint style="success" %}
You can modify the block model, or the model / structure of your content, at any time.&#x20;
{% endhint %}

To do it is very simple.

1. First of all, click on the **name of the Block** you want to modify that you find in the left sidebar
2. Then click **Content Structure**, the second item on the tab
3. You will be redirected to the page that allows you to edit the content model. In the left part of the page you can modify the model by going to remove, add or modify each Element. In the right column, however, you can change the configuration of your Block, such as the Name, Description, Icon, Features, etc ...
4. Once the modification is complete, click on the **Save** button.


# Model your content

{% hint style="info" %}
Once you've created a new block, define the **Content Structure** and click on **+ add element**
{% endhint %}

![](/files/-MD_4CXiOlq0ChfJpAsN)

At this point, you can define:

* 🗂 **Type**: choose the Element type you prefer;

![](/files/-MD_66b64vLo52JWGbfY)

* **⚙️ Settings**: write the "Element title" and the "Element placeholder"

![](/files/-MD_6SHaJ4ickcWGck3-)

* **⚠️ Validations**: rules to enter content. Tick the "Required" box if you want a specific Element to be compulsory. In "Pattern", choose the Validation category for each Element.

![](/files/-MD_6UrfAmo_T7gwpVOJ)


# General

In this tab, you can see:

* **🔢 ID**: the unique Block ID
* **🗒 Order**: the Block order in the left side menu
* **🔁 Block type**: divided into “Single” or “Repeatable”
* ℹ️ **Block info**: write the Block's title and subtitle

![](/files/-MD_4aQMtzzqf2tbPSYW)


# Features

You can choose one or more of the following Block's features:

* **📌 In evidence**: if selected, it will bring greater visibility to your content in the front-end;
* **🔎 SEO**: if selected, it will allow you to correctly index your content;
* **📲 Push notifications**: if selected, it will activate push notifications.

![](/files/-MD_4dk4_7ZsC3DEFjjE)


# Settings

Fill out the following forms:

* **Pagination**: you can define the number of sections you want to retrieve with each API call;

{% hint style="info" %}
👾 Tips: if you select a too high number the upload may be slow
{% endhint %}

* **Validate all locales**: if selected, you will apply the "required" setting to all locales (i.e. languages). Instead, if the box is unchecked, elements will be checked only in the default language.&#x20;

{% hint style="success" %}
Finally, you can view the content in JSON format 👨🏻‍💻 and export it ⬇️
{% endhint %}

![](/files/-MD_4iPyH7IHZ-503mtA)


# Element Type

Each block is composed of different elements.&#x20;

{% hint style="info" %}
MBurger offers you many elements to choose from and each of them has different properties you can customize
{% endhint %}

{% embed url="<https://youtu.be/3G2Keciy0Pc>" %}

{% content-ref url="/pages/-MDOtRKaQ6wVuSwqwexs" %}
[Text](/section-1/element-type/text)
{% endcontent-ref %}

{% content-ref url="/pages/-MDOqR7A9nZfscI8Pwzn" %}
[Text Area](/section-1/element-type/text-area)
{% endcontent-ref %}

{% content-ref url="/pages/-MDOtSOkoCNOphohsiHe" %}
[Address](/section-1/element-type/address)
{% endcontent-ref %}

{% content-ref url="/pages/-MDOtSLO7zvMY1RxZYSm" %}
[Markdown](/section-1/element-type/markdown)
{% endcontent-ref %}

{% content-ref url="/pages/-MDOtSIwQGVE47Cz4VLW" %}
[Image](/section-1/element-type/image)
{% endcontent-ref %}

{% content-ref url="/pages/-MDOtSGEezC\_FfNnEcB9" %}
[Audio](/section-1/element-type/audio)
{% endcontent-ref %}

{% content-ref url="/pages/-MDOtSDXurJAWtS-SD2s" %}
[Video](/section-1/element-type/video)
{% endcontent-ref %}

{% content-ref url="/pages/-MDOyW-gUcYPiNdggoYs" %}
[Document](/section-1/element-type/document)
{% endcontent-ref %}

{% content-ref url="/pages/-MDOyVwKviS4nnC2wor7" %}
[File](/section-1/element-type/file)
{% endcontent-ref %}

{% content-ref url="/pages/-MDOyVqqFXMVQsXxMO1-" %}
[Checkbox](/section-1/element-type/checkbox)
{% endcontent-ref %}

{% content-ref url="/pages/-MDOyVlYVo0pWVXi\_cnF" %}
[Datetime](/section-1/element-type/datetime)
{% endcontent-ref %}

{% content-ref url="/pages/-MDOyVfqe67J0QjeX65x" %}
[Dropdown](/section-1/element-type/dropdown)
{% endcontent-ref %}

{% content-ref url="/pages/-MDOyV\_wz4\_bjBGYxKRD" %}
[Poll](/section-1/element-type/poll)
{% endcontent-ref %}

{% content-ref url="/pages/-MDOyVVE0n9fWfTxX07s" %}
[Relation](/section-1/element-type/relation)
{% endcontent-ref %}

{% content-ref url="/pages/-MDOyVPwx1B0OGwXR-4S" %}
[Multiple - Tag](/section-1/element-type/multiple-tag)
{% endcontent-ref %}

{% content-ref url="/pages/-MDOtSA\_aAsLjMDZeo84" %}
[Color](/section-1/element-type/color)
{% endcontent-ref %}


# Text

The ***text*** element represents a text box which you could use, for instance, for a title or a short description.&#x20;

{% hint style="warning" %}
It is limited to 191 characters
{% endhint %}

{% hint style="info" %}
&#x20;Can be used for links or phone numbers.
{% endhint %}

Text element **properties**:

* **Required**: if selected, this element becomes required and cannot be left empty
* **E-mail**: if selected, identifies the text element as an email field, activating email format validation
* **URL**: if selected, identifies the text element as a link/url
* **Numeric**: if selected, identifies the text element as a number, activating number validation
* **JSON**: if selected, identifies the text element as a JSON
* **Min**: it defines the minimum number of characters allowed and activates a validation in the dashboard to verify the parameter has been respected
* **Max**: it defines the maximum number of characters allowed and activates a validation in the dashboard to verify the parameter has been respected


# Text Area

The ***textarea*** element is used for longer pieces of content

{% hint style="info" %}
It's ideal for descriptions, articles and blog posts, and for longer pieces of text
{% endhint %}

This element behaves as a WYSIWYG (What You See Is What You Get) field

{% hint style="warning" %}
If you need to format the text in a more advanced way, pick the ***markdown*** element&#x20;
{% endhint %}

Textarea element **properties**:

* **Required**: if selected, this element becomes required and cannot be left empty
* **JSON**: if selected, identifies the text element as a JSON
* **Min**: it defines the minimum number of characters allowed and activates a validation in the dashboard to verify the parameter has been respected
* **Max**: it defines the maximum number of characters allowed and activates a validation in the dashboard to verify the parameter has been respected


# Address

The ***address*** element requires you to input an address and it gives you back the coordinates (longitude and latitude) of that location

While you type the address, MBurger will get Google Maps API and autocomplete the field

{% hint style="info" %}
you could use it to get the X/Y coordinates for your stores, offices, point of interests - such as museums, restaurants, parks, etc. - and show them on a map
{% endhint %}

Address element **properties**:

* **Required**: if selected, this element becomes required and cannot be left empty.


# Markdown

The ***markdown*** element is a text field for long pieces of content (similar to the textarea element)&#x20;

{% hint style="info" %}
It is formatted using [markdown syntax](https://www.markdownguide.org/basic-syntax/), making it flexible and easy-to-use for content of any type.
{% endhint %}

Markdown element **properties**:

* **Required**: if selected, this element becomes required and cannot be left empty
* **Min**: it defines the minimum number of characters allowed and activates a validation in the dashboard to verify the parameter has been respected
* **Max**: it defines the maximum number of characters allowed and activates a validation in the dashboard to verify the parameter has been respected


# Image

The ***image*** element is used to insert one or more images in a block

{% hint style="info" %}
It can be used for traditional images, as well as 360 deg pictures (see a [live example here](https://pfb.it/en/product/4056/overspeed-governors/lx150))
{% endhint %}

Image element **properties**:

* **Required**: if selected, this element becomes required and cannot be left empty
* **Size**: exact dimension of file in bites (if needed)
* **Min**: minimum dimension of file in bites
* **Max**: maximum dimension of file in bites
* **In**: define the file format, e.g. JPG, JPEG, TIF, etc.


# Audio

The ***audio*** element is used when you need to insert an audio file in your block.

{% hint style="info" %}
It could be a song, a podcast or a playlist.
{% endhint %}

Audio element **properties**:

* **Required**: if selected, this element becomes required and cannot be left empty
* **Size**: exact dimension of file in bites (if needed)
* **Min**: minimum dimension of file in bites
* **Max**: maximum dimension of file in bites
* **In**: define the file format, e.g. mp3, mp4, etc.


# Video

The ***video*** element is used to add a video file to your block.

{% hint style="info" %}
It could be a promotional video, a webinar, a knowledge video, a recording of a remote assistance, etc.
{% endhint %}

Video element properties:

* **Required**: if selected, this element becomes required and cannot be left empty
* **Size**: exact dimension of file in bites (if needed)
* **Min**: minimum dimension of file in bites
* **Max**: maximum dimension of file in bites
* **In**: define the file format, e.g. .mov, .avi, .divx, .mpeg, etc..


# Document

The ***document*** element is used to add a document file to your block.

{% hint style="info" %}
It could be a downloadable PDF, text document, spreadsheet file, powerpoint, etc.
{% endhint %}

&#x20;The document element is intended for individual documents

{% hint style="warning" %}
if you need to use a packaged file (such as .zip, .ipa, .apk) use the File element&#x20;
{% endhint %}

Document element **properties**:

* **Required**: if selected, this element becomes required and cannot be left empty
* **Size**: exact dimension of file in bites (if needed)
* **Min**: minimum dimension of file in bites
* **Max**: maximum dimension of file in bites
* **In**: define the file format, e.g. .doc, .docx, .csv, .pdf, etc..


# File

The ***file*** element is used to insert a packaged file in your block.

{% hint style="info" %}
&#x20;It can be used to upload folders which your users can visualize and download
{% endhint %}

File element **properties**:

* **Required**: if selected, this element becomes required and cannot be left empty
* **Size**: exact dimension of file in bites (if needed)
* **Min**: minimum dimension of file in bites
* **Max**: maximum dimension of file in bites
* **In**: define the file format, e.g. .zip, .ipa, .apk, etc.


# Checkbox

{% hint style="info" %}
The ***checkbox*** element is used to insert a checkbox in your block
{% endhint %}

Checkbox element **properties**:

* **Required**: if selected, this element becomes required and cannot be left empty


# Datetime

The ***date*** element is used to insert a date in your block.&#x20;

{% hint style="info" %}
It could be opening and closing hours, event dates, etc.
{% endhint %}

Datetime element **properties**:

* **Required**: if selected, this element becomes required and cannot be left empty;

#### &#x20; <a href="#content-10" id="content-10"></a>


# Dropdown

The ***dropdown*** element is used to display a dropdown (i.e. multiple selector) in your block.

{% hint style="info" %}
It could be a tag for a category, a point on interest on an interactive map, etc.
{% endhint %}

{% hint style="warning" %}
The dropdown element has no properties
{% endhint %}


# Poll

The ***poll*** element is used to add a poll to your block.

{% hint style="info" %}
It allows you to create polls from MBurger and see the results of your users' responses from the dashboard
{% endhint %}

When you add a poll element, you can pick the maximum number of responses you can add to your poll.&#x20;

{% hint style="info" %}
Each user can vote once

Multiple choices are not allowed.
{% endhint %}

{% hint style="warning" %}
The poll element has no properties
{% endhint %}


# Relation

The ***relation*** element is used to create a relation between two sections of your MBurger project

&#x20;For example, you can use it to link an article to an author, a picture to a point of interest, a video to an event, etc

{% hint style="success" %}
&#x20;If you pick a relation for your block, you can then associate the element while you create your section in a few clicks&#x20;
{% endhint %}

{% hint style="warning" %}
The relation element has no properties
{% endhint %}


# Multiple - Tag

The ***multiple*** element is used to insert a multiple selector in your block

{% hint style="info" %}
It could be user to assign multiple categories to an article
{% endhint %}

{% hint style="warning" %}
The multiple element has no properties
{% endhint %}


# Color

The ***color*** element is used to insert a color in your block&#x20;

For example, you can connect your UI with the color element and change the main color of your UI elements directly from MBurger

{% hint style="info" %}
You can insert your color in HEX code or use our internal color picker to choose a color right from your dashboard
{% endhint %}

{% hint style="warning" %}
The color element has no properties
{% endhint %}


# Section/Content Management

{% hint style="success" %}
In this section you'll learn how to manage content of your project!
{% endhint %}

{% content-ref url="/pages/-MDTn80A58lKPdcKHv9Y" %}
[Add content](/section/section-content-management/add-content)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTnHtiTve3aCM2rRwE" %}
[Edit content](/section/section-content-management/edit-content)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTnHpf-4WyeOukuX6R" %}
[Duplicate content](/section/section-content-management/duplicate-content)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTnHmLrhXaOB9l9gzC" %}
[Delete content](/section/section-content-management/delete-content)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTnHhzxqtWrPnDoXds" %}
[Order section](/section/section-content-management/order-section)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTnHd\_v3C2AEIYjn96" %}
[Language](/section/section-content-management/language)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTnHZzzA8Dzu6UtMMQ" %}
[Visibility](/section/section-content-management/visibility)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTnHW-Fw9SMw40FC5T" %}
[Engagement](/section/section-content-management/engagement)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTnHR0xslSWWeTDlei" %}
[In Evidence](/section/section-content-management/in-evidence)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTnHMHFlK43nRNu6Fw" %}
[Relation](/section/section-content-management/relation)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTnHCm2BA1TNt61VkT" %}
[SEO](/section/section-content-management/seo)
{% endcontent-ref %}


# Add content

To create a new content in MBurger, look at the left side menu and click on the Block in which you’d like to add your content.

Once you’ve clicked on a Block, you enter the **Section list** where all contents included in that specific Block are listed.&#x20;

To add a new content, click on the top right blue button with the inscription **+ Add new #YourNameBlock**&#x20;

![](/files/-MDnJvtOxEvdv8H4XfUw)

In this page, you can find all the Elements you’ve chosen to add to your Block.&#x20;

{% hint style="success" %}
🧠: When you add an Element, make sure to respect all the validations you’ve applied and, then, click on the **Publish** button
{% endhint %}

#### &#x20;<a href="#edit-content" id="edit-content"></a>

#### &#x20;<a href="#duplicate-content" id="duplicate-content"></a>

#### &#x20;<a href="#delete-content" id="delete-content"></a>

#### &#x20;<a href="#order-section" id="order-section"></a>

#### &#x20;<a href="#language" id="language"></a>

#### &#x20;<a href="#visibility-visibledraftscheduled" id="visibility-visibledraftscheduled"></a>

#### &#x20;<a href="#engagement" id="engagement"></a>

#### &#x20;<a href="#in-evidence" id="in-evidence"></a>

#### &#x20;<a href="#relation" id="relation"></a>

#### &#x20;<a href="#seo" id="seo"></a>


# Edit content

To modify a Section, click on the first icon <img src="/files/-MDTofVJ916uU03y2Q23" alt="" data-size="line"> in the **Action** column.

![](/files/-MDnKY5atCD3YclbnUuA)


# Duplicate content

To duplicate a Section, click on the second icon <img src="/files/-MDTor5Yp917_zKkYWBs" alt="" data-size="line"> in the **Action** column.

![](/files/-MDnKmUt-uM108DD67hO)

{% hint style="info" %}
👾: in this way, you can create a new Section identical to the one you’ve copied, saving a lot of time!
{% endhint %}


# Delete content

To delete a Section, click on the third icon <img src="/files/-MDTp8QiM91DcmJyoVe4" alt="" data-size="line"> in the **Action** column.

{% hint style="info" %}
When a section is deleted is automatically moved in the trash. From the trash you can either restore the section or permanently delete it.
{% endhint %}

![](/files/-MDnKr8JxksoE2w14Jdg)


# Order section

{% hint style="info" %}
To change Section's order in the Content List, you can click on a section, **drag and drop** it down where you want.
{% endhint %}

![](/files/-MDnR_l5SoqpziQnMVDx)

{% hint style="success" %}
Once you’ve entered a specific Section, in the right column you’ll find general information on the content you’re adding:  Locale, Section ID, Relation, Visibility, In Evidence, Engagement
{% endhint %}


# Language

In this tile, you can choose the **language** for the content you’re adding.&#x20;

In this way, you’ll publish content in your digital product’s right version.

![](/files/-MDnL55o9AKKyi1qu0RE)


# Visibility

In this tile, you can set up your content publishing status:

* **Draft**: your content has been saved as a draft in MBurger, but it hasn’t been published in your digital products yet
* **Visible/Public/Published/other**: your content has been added to MBurger and published in your digital products too.
* **Scheduled**: your content has been added to MBurger and will be published in your digital products in the future, based on the date and time you've chosen.   &#x20;

![](/files/-MDnV_Odz8i4xqD7ytwl)


# Engagement

If selected, you can write the text you want to send through a **Push Notification**

![](/files/-MDnLN2gFyinZRJ3vTol)

#### &#x20; <a href="#content" id="content"></a>


# In Evidence

If selected, it will bring greater visibility to your content in the front-end.&#x20;

![](/files/-MDnLS07u8Pu93znjehx)


# Relation

In this tile, you can link various Sections you’ve added to different Blocks in MBurger.

![](/files/-MDnLWfLoOVmPSZNSq_A)

{% hint style="info" %}
👾: for example, you can link a Content Block with its Author Block
{% endhint %}


# SEO

Below Elements’ fields, you can find the SEO tile for your content.&#x20;

It includes the following fields: **Title**, **Description**, **Preview Image** and **Keywords**, that can be used to correctly index your content.


# Engagement Platform

{% hint style="success" %}
In the left side menu, you can find the **Engagement** dashboard including **Messages**, **Audience**, and **Settings**
{% endhint %}

{% content-ref url="/pages/-MDxU4nqLKIEugWkPKcP" %}
[Message Type](/engagement/engagement-platform/message-type)
{% endcontent-ref %}

{% content-ref url="/pages/-MDxU4z\_YzZhsWovf7Qt" %}
[Audience](/engagement/engagement-platform/audience)
{% endcontent-ref %}

{% content-ref url="/pages/-MDxU2LA8EIDWB3oivXE" %}
[Settings](/engagement/engagement-platform/settings)
{% endcontent-ref %}


# Message Type

In **Messages**, you can see all messages (also scheduled and sent messages).&#x20;

{% hint style="info" %}
Here, you can also choose whether to create a **push notification** or an **in-app message** by clicking on the top right blue button **+create new**
{% endhint %}

![](/files/-MDy9foYNNMcvlQMg5PI)


# Push Notification

In this tile, you have to fill in the following fields:

### **Content**

{% hint style="info" %}
write your message content by filling in the fields included in **Content**, **Action**, and **Extra**
{% endhint %}

* **Content**: write your message title and content, and select an image.&#x20;
* **Action**: choose among Home Page App, MBurger Section, In-app view, and Link. This determines which of your app sections users see when they open your push notification.&#x20;
* **Extra**: if Custom Sound & Splash Screen is enabled, you can choose the name of the audio file and/or of the custom image of your message.&#x20;

![](/files/-MDxuHrIPRywBSWQPNAz)

### **Audience**

{% hint style="info" %}
select the target audience for your message among **All users**, **Topic**, and **Specific Target**
{% endhint %}

Select “**All Users**” to send a message to all your App users.&#x20;

Select a specific “**Topic**” to send a push notification only to those users registered to a specific Topic.

Select “**Specific target**” to send a message to a specific target of your App.&#x20;

{% hint style="info" %}
If you don’t have one yet, you can create a new one right away clicking on the bottom right button **+add new audience**.
{% endhint %}

![](/files/-MDxuOCUmpDodqkFDSEY)

### **Delivery**

{% hint style="info" %}
decide when you want your message to be sen&#x74;**, y**ou can choose among **Send now!**, **Schedule**, and **Behaviour**.
{% endhint %}

Select “**Send now!**” to immediately send the message.&#x20;

Select “**Schedule**” to choose the future date and time when your message will be sent.&#x20;

Select “**Behaviour**” to choose a specific behaviour of your customer after which a notification will be sent.&#x20;

Then, click on **+ Add trigger** and select one of the triggers appearing in the right tile:

* **Screen View**: show the message when users have visited a specific page/section of your app.&#x20;
* **App Openings**: show the message whenever users open your app a specific number of times.&#x20;
* **Location**: show the message when users enter or leave a specific section of your app.&#x20;
* **Custom Event**: show the message when a specific event occurs.&#x20;
* **Inactive User**: show the message to those users who haven’t been opening your app for a specific period of time.&#x20;
* **Tag Change**: show the message when a tag is added or removed.&#x20;

![](/files/-MDxuX11l9Ydedu1EK68)

### **Message settings**

{% hint style="info" %}
Decide the start and end dates for your push notification, your message name, and description.
{% endhint %}

![](/files/-MDxudCG09Icy9yjIwP0)

{% hint style="success" %}
Well done, you've just create your push notification! Now, click on the top right blue Botton **Finish** and send your push notification.
{% endhint %}

![](/files/-MDxvW-IY9I0BmcSZtAQ)


# InApp Message

In this tile, you have to fill in the following fields:

### **Content**

{% hint style="info" %}
write and **customize** your pop-up **message** look and feel to be consistent with your brand, also choosing where and how your message will be displayed (Full Page, Bottom Up, Bottom Down, Image)
{% endhint %}

Then, fill in the following fields:

* **Content**: write your message title and content, select an image, set up the background and text colour.
* **Action**: write your message text, choose among No Action, MBurger Section, In-app view, and Link. This determines which of your app sections users see when they open your push notification. Finally, set up the background and text colour.

![](/files/-MDyA1yDJPDeJx8MIyzl)

### **Audience**

{% hint style="info" %}
select the target audience for your message between **All users**, and **Specific Target**
{% endhint %}

![](/files/-MDy3K3iFRab2Lm8evq8)

### **Delivery**

{% hint style="info" %}
decide when you want your message to be sent. You can choose among **Send now!**, **Schedule** and **Behaviour**
{% endhint %}

![](/files/-MDy3PKcZKuEJD6djDYn)

### **Message settings**

{% hint style="info" %}
name and send your message. Decide the start and end dates for your push notification, your message name, and description
{% endhint %}

![](/files/-MDy3TKQMfIdzZbxHOlu)

{% hint style="success" %}
Well done, you've just create your in-app message! Now, click on the top right blue Botton "Finish" and send the message
{% endhint %}

![](/files/-MDy3aTmd2vsfbhTqUWQ)


# Audience

In this dashboard, you can create and modify the following fields:

### Audience

there can be 3 kinds of target audience for your message:&#x20;

* **All users**: all your App users.
* **Topic**: refers to a specific Topic chosen by some users based on their interests and preferences.&#x20;
* **Specific Target**: a specific target audience of your App.&#x20;

{% hint style="success" %}
Create a new Audience for your Mobile App by clicking on the top right blue button **+Add Audience**
{% endhint %}

In this way, you create a **Specific target** audience that can be hit by filling in the fields: Audience Name, Condition, Device Properties in the right tile.&#x20;

**Device Properties** include:

* **Push**: can be enabled or disabled (or there can be none).
* **Location**: can be enabled or disabled (or there can be none).
* **Platform**: can be iOS, Android or both.
* **App Version**: can be equal or not equal to a given iOS or Android version. &#x20;
* **Locale**: choose your audience language.

![](/files/-MDymKxVJMamILj-a5Q-)

{% hint style="success" %}
Once you've created your Audience you can modify it <img src="/files/-MDyAOX8ireNEIR9UQqV" alt="" data-size="line"> or delete it <img src="/files/-MDyARa7w-LaQ99yEf_n" alt="" data-size="line"> anytime
{% endhint %}

![](/files/-MDyAUfXLtixMMBxZZRC)

### List

Upload your Lists in MBurger to hit a specific target audience of your App.&#x20;

{% hint style="info" %}
You can export your CRM data, newsletter, or social campaigns to create your Lists.
{% endhint %}

{% hint style="success" %}
To create a new List click on the top right blue button **+Add List** and fill in the fields in the right tile.
{% endhint %}

![](/files/-MDyEbEAUbE-QVSXkWnj)

### Tag

{% hint style="info" %}
Tags are preferences users can enable on your App
{% endhint %}

Tags can be categories users have selected as favorite in your App (e.g. to get news in Food, Technology, and Music fields).&#x20;

Tags could also be fields added during users’ registration, e.g. sex and hometown.&#x20;

{% hint style="success" %}
To create a new Tag click on the top right blue button **+Add Tag** and fill in the fields in the right tile
{% endhint %}

![](/files/-MDyEhAfeKWNRotxO51G)

### **Views**

{% hint style="info" %}
Name your App Views to make the Engagement Platform usage easier for your marketing team
{% endhint %}

{% hint style="success" %}
To create a new View click on the top right blue button “+Add View” and fill in the fields in the right tile
{% endhint %}

![](/files/-MDyExFKvcPEWqiI_wZX)

### **Events**

Refer to any kind of **action** users can perform through your app (e.g. adding a product to their cart, interacting with a post, completing their purchase, signing in).&#x20;

{% hint style="success" %}
To create a new Event click on the top right blue button “+Add Event” and fill in the fields in the right tile
{% endhint %}

![](/files/-MDyF4g37zS1pDQqrFAy)


# Settings

{% hint style="success" %}
Here you can find your **MPush Token**
{% endhint %}

{% hint style="info" %}
In order to work, you'll need to insert an Authentication Key
{% endhint %}

{% tabs %}
{% tab title="iOS" %}
For iOS you'll find **APNS - Apple Push Notifications Service**

![](/files/-MDxs6j4FF05v-w0W_nl)
{% endtab %}

{% tab title="Android" %}
For Android you'll find **FCM - Firebase Cloud Messaging**

![](/files/-MDxsC6MvgABGWPm9sPd)
{% endtab %}
{% endtabs %}


# Control Panel

{% hint style="success" %}
Here you can manage your project settings! Let's learn how!
{% endhint %}

{% content-ref url="/pages/-MDTxSr9JZ7tzQWBtG4t" %}
[API keys](/control-panel/control-panel/api-keys)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTxTuU5OYEDunOYeYr" %}
[Users](/control-panel/control-panel/users)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTxTp2j7vcnbW7nEUl" %}
[Consent Solutions](/control-panel/control-panel/legal)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTxT\_aVrTYSRrU4bHe" %}
[Resource](/control-panel/control-panel/resource)
{% endcontent-ref %}

{% content-ref url="/pages/-MDTxWQ7kf\_UwbFRnCTI" %}
[Settings](/control-panel/control-panel/settings)
{% endcontent-ref %}


# API keys

{% hint style="success" %}
Here you can create keys and obtain tokens
{% endhint %}

You need to specify the name of the API key and the permission, choosing between&#x20;

* **read**
* &#x20;**read & write**
* &#x20;**read, write & delete**

![](/files/-MDnLd_ryomEyHxXPcKK)


# Users

{% hint style="success" %}
In this section, you can invite users to participate in a project and manage user's role and invitations
{% endhint %}

You need to add a correct email and a role, choosing between **admin**, **developer** and **content manager**&#x20;

Depending on their role, users will have different **permissions**:

* admin can read and modify everything
* Developers and Content Managers can only see some Sections of the platform (the ones they've been invited to)
* Content Managers cannot make certain changes, like deleting a Block

You can send invitations by email and, once they've been accepted,you will see users on this page. Eventually, you can perform two different actions:

* **edit** : to change user's role
* **unlink** : to remove users from a specific project

While the invitation is still pending (it hasn't been accepted yet), you can perform other two actions :

* **resend** : in case you want to resend th invitation email to the user
* **cancel** : to cancel the invitation (e.g. in case you made a mistake)

![](/files/-MDomu4pe14MGvJ9Pu8v)


# Consent Solutions

{% hint style="success" %}
Here you can add **contracts** like Privacy Policy, Terms & Conditions etc
{% endhint %}

{% hint style="info" %}
Once a contract has been created, you can link it to a user
{% endhint %}

&#x20;

![](/files/-MDnMG1OTF0iVT1wx-XD)


# Resource

{% hint style="success" %}
In this section you can monitor the **resources usage** of your project
{% endhint %}

{% hint style="info" %}
Thanks to this detailed info, you can choose which plan is suitable for you!
{% endhint %}

![](/files/-MDon2N0OcXQr8w8g1gV)


# Settings

{% hint style="success" %}
Here you can check your project **settings** and enable Plug-ins.
{% endhint %}


# Plug-in

{% hint style="success" %}
In the left side menu, you can find the **Plug-in** dashboard that you can enable in the **Control Panel**
{% endhint %}

{% content-ref url="/pages/-MDUctDtb\_FD9nV19Xgv" %}
[Users](/plug-in/plug-in/users)
{% endcontent-ref %}

{% content-ref url="/pages/-MDUdVJ-IrbbHP2W3H8A" %}
[iBeacons](/plug-in/plug-in/ibeacons)
{% endcontent-ref %}

{% content-ref url="/pages/-MDUdUwSywP9G31dQkfI" %}
[Multilanguage](/plug-in/plug-in/multilanguage)
{% endcontent-ref %}

{% content-ref url="/pages/-MDUdt-Pa8-ozvyEL0J6" %}
[Live message](/plug-in/plug-in/live-message)
{% endcontent-ref %}

{% content-ref url="/pages/-MDUdtu2UPDn3eGSijeQ" %}
[Push Notification](/plug-in/plug-in/push-notification)
{% endcontent-ref %}


# Users

{% hint style="success" %}
Click on **Users** to find registered users
{% endhint %}

Here you can see all registered user's data, and their agreements (e.g. Privacy Policy, Marketing Condition, etc...).

{% hint style="info" %}
🧠: MBurger also allows Automatic social login through the most popular social platforms
{% endhint %}

![](/files/-MDoSQPC0vqzA4yWfFhT)


# iBeacons

{% hint style="success" %}
To add a new Beacon, click on the top right blue button **+ Add Beacon**
{% endhint %}

Then, you will be able to see and manage the Beacons you have associated to your digital products/projects.

![](/files/-MDnMld-YrrDeMDTPN3K)

In the **Action** column, you can:

* modify your Beacons
* Associate your Beacons to a Section
* Delete your Beacons


# Multilanguage

{% hint style="info" %}
In this dashboard, you can see your project languages and modify them any time (**+ add locale** or **delete**)
{% endhint %}

If you set a language as fallback, but the content hasn’t been added in all languages, it will be automatically written only in the selected language.

![](/files/-MDnMq6Wvv2frsLkcekz)


# Live message

{% hint style="info" %}
Here you can see all live messages you have received from your customers
{% endhint %}

![](/files/-MDoS8Mtk6bFsKXidehU)


# Push Notification

{% hint style="success" %}
Once you’ve enabled push notifications in the **Control Panel** Settings, the **Engagement** dashboard will appear in the left side menu.
{% endhint %}

You can send push notifications to the clients connected to your project. You can even schedule notifications comfortably from your dashboard.


