📢 Use this project, contribute to it or open issues to help evolve it using Store Discussion.

Enable Mapp Intelligence tracking without touching a single line of code.
The Mapp Cloud app for Vtex creates the data layer used to feed the Mapp Cloud tracking products. It helps you to easily fuel the Mapp Intelligence customer insights dashboards with data, without requiring you to touch any code. Just get the extension, configure your Tag Integration ID, and enable the plugin.
Mapp Intelligence gives you access to more than 20 pre-configured dashboards to start analyzing user behavior right away and adjust your marketing accordingly.
Features:

• Adds the Mapp Cloud Tag Integration code to the Header of your website
• Adds the Mapp Acquire code to the Header of your website
• Creates the standard data layer to start analyzing insights immediately
• Initializes tracking

1. Access the Apps section in your account's admin page and look for the Mapp Cloud Integration box;
2. Then, click on the Install button;
3. Under Apps you'll find the entry Mapp Cloud Integration - there you can enter your credentials (Tag Integration ID, Custom Responder Domain if available, Mapp Acquire Script);
4. Click on Save.

1. Install the [email protected] app. You can confirm that the app has now been installed by running vtex ls again.
2. Access the Apps section in your account's admin page and look for the NAME OF THE APP box. Once you find it, click on the box.
3. Fill in the tiId field with your Tag Integration ID.
4. Click on Save.

1. Access the My Apps section in your account's admin page and look for the Mapp Cloud Integration box;
2. Find Mapp Cloud Integration app under installed apps and click on Settings page
3. Navigate to Engage tab and fill form for your Mapp integration
4. After pressing Save button you should get confirmation that everything is configured correctly
5. In order to provide realtime client/user changes to MappEngage its necessary to configure triggers in Master Data (Check next section).

1. Go to {vtex-account}.ds.vtexcrm.com.br
2. Navigate to Triggers page
3. Click on Add new button in top left corner and create new triggers

Client insert trigger

• Name: client_insert_trigger
• Data Entity: Cliente
• Trigger Rule: Um registro for inserido (When record is entered)
• Navigate to If positive tab and set Action to Send a HTTP request
• Set URL to: {vtex-account}.myvtex.com/_v/app/vtex-mapp-cloud/userCreate?userId={!userId}

Client update trigger

• Name: client_update_trigger
• Data Entity: Cliente
• Trigger Rule: Um registro for alterado (When record is changed)
• Navigate to If positive tab and set Action to Send a HTTP request
• Set URL to: {vtex-account}.myvtex.com/_v/app/vtex-mapp-cloud/userUpdate?userId={!userId}

Client remove trigger

• Name: client_remove_trigger
• Data Entity: Cliente
• Trigger Rule: Um registro for removido (When record is changed)
• Navigate to If positive tab and set Action to Send a HTTP request
• Set URL to: {vtex-account}.myvtex.com/_v/app/vtex-mapp-cloud/userUpdate?userId={!userId}&remove=true&email={!email}

Once Mapp Cloud Integration is active on your Vtex store, you can map data from the global _ti datalayer variable as parameters to your Mapp Intelligence plugin in Tag Integration. The following data is available:

Right before pageUpdate runs, a custom event called MappPageUpdate is dispatched, which includes the current _ti object as detail data.
To set it up in Tag Integration, create a new Rule with the following settings:

• Event type: CUSTOM_EVENT
• Eventname: MappPageUpdate
• Element: window

Now you can use the tracking data in your custom plugins. To try it out, create a new plugin with the following code:

console.log(
  'TI Plugin - Event log',
  ti_event,
  ti_element,
  ti_eventType,
  ti_eventCounter
)

Add head as position and assign the MappPageUpdateRule. You can find the event data in ti_event.detail, and under ti_event.detail.vtex you can find all the data Vtex provides. Use this in conjunction with your TI custom plugin(s) to set up your individual tracking requirements.

Thanks goes to these wonderful people (emoji key):

This project follows the all-contributors specification. Contributions of any kind are welcome!