Products recommendation for emails and pages
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Api
Assets
Command
Config
Controller
Entity
Event
EventListener
Form/Type
Helper
Integration
Model
Security/Permissions
Service
Tests
Translations/en_US
Views
MauticRecombeeBundle.php
README.md
RecombeeEvents.php
composer.json

README.md

MauticRecombeeBundle

Increase your customer satisfaction and spending with Amazon and Netflix-like AI powered recommendations. Applicable to your home page, product detail, emailing campaigns and much more. Quick and Easy Integration into Your Environment.

Sign in for news: mtcrecombee.com

What plugin do?

  • Recommendations items based on contact interactions
  • Abandoned cart
  • Frequently bought together
  • Customers who viewed this item also viewed
  • Special offers and product promotions
  • Related to this item
  • Customers who bought items in your cart also bought
  • Recently viewed items and featured recommendations
  • Category best sellers
  • Most wished products

Which channels do you support?

  • Emails
  • Focus (popups)
  • Dynamic content
  • Web Push notification

Create Recombee account for free

  1. Go to www.recombee.com and create account.
  2. Free plan up to 100 000 recommendation requests is good choice.
  3. Then go to Accounts > Organizations > your organization > edit database and copy API credits

Import data (items, users)

Recombee combine data about items and user and related data between both.
Then before start working with Recombee we need import items (required) and contacts (optional).
Items import

Import items

Items are parsed from your external JSON file. This command should run initial, but also you can update your items one time per 24/48 hours.

php app/console mautic:recombee:import --type=items
--file="path/to/items.json"

Results from command

Import contacts

Contacts are imported from Mautic contacts.
If you are working on new Mautic installation, then you can skip this step. Contacts import is initial and you should run it first time. Then Mautic will send data about contacts realtime.

Command:

php app/console mautic:recombee:import --type=contacts

Results from command

Send data realtime by API

Plugin for Woocommerce https://github.com/kuzmany/woo-mautic-recombee

You can send based interactions between items/user by API.
You have to setup Mautic API.
Based init code looks like:

$api = new MauticApi();
$apiRequest = $api->newApi('api', $auth, $apiUrl);

Interactions

AddCartAddition

Adds a cart addition of a given item made by a given user.

$component = 'AddCartAddition';
$options = ['userId' => 1, 'itemdId' => 1, 'amount'=>1, 'price'=>99];
$apiRequest->makeRequest('recombee/'.$component, $options, 'POST');

DeleteCartAddition

Adds a cart addition of a given item made by a given user.

$component = 'DeleteCartAddition';
$options = ['userId' => 1, 'itemdId' => 1];
$apiRequest->makeRequest('recombee/'.$component, $options, 'POST');

AddPurchase

Adds a purchase of a given item made by a given user.

$component = 'AddPurchase';
$options = ['userId' => 1, 'itemdId' => 1,
'amount' => 1, 'price' => 99, 'profit' => 9];
$apiRequest->makeRequest('recombee/'.$component, $options, 'POST');

DeletePurchase

Deletes an existing purchase

$component = 'DeletePurchase';
$options = ['userId' => 1, 'itemdId' => 1];
$apiRequest->makeRequest('recombee/'.$component, $options, 'POST');

AddDetailView

Adds a detail view of a given item made by a given user.

$component = 'AddDetailView';
$options = ['userId' => 1, 'itemdId' => 1];
$apiRequest->makeRequest('recombee/'.$component, $options, 'POST');

Send data realtime by JS API

Add Mautic tracking code to website

First you have to add Mautic tracking code to your website

Then edit your tracking pixel on each product page with Recombee code to pageview event. Data send by pixel improve personalization products for your contacts. Example how to add custom parametrs to Mautic pageview event:

AddDetailView

Adds a detail view of a given item made by a given user.

mt('send', 'pageview', { Recombee: '{"AddDetailView":{"itemId":1}}' });

Delivery recommended items to users

1. Create Recombee template

Go to Components > Recombee and create TWIG supported templates. Recombee template use in supported channels.

Then use in content of support channels tag {recombee=1} (replace number with your Recombee template ID)

At the moment Recombee integration support

  • Email
  • Focus
  • Dynamic Content
  • Push notifications

2. Create campaign actions

Recombee Email

Recombee Email

Recombee Focus

Recombee Focus

Recombee Dynamic Content

Recombee Dynamic Content

Both campaign action support 3 types of recommendations:

  • Recommendations based on interactions
  • Abandoned cart
  • Advanced (with filter and booster support)

How to work recommendations types?

  1. Recommendations

Based on user-item interactions.

  1. Abandoned cart

Based on Add cart addition and Add purchase interactions. Plugin display items based on date added contact to campaign and date added cart addition. If contact date added cart addition is greather as contact date added to campaign the items will displayed until purchase.

  1. Advanced

You can use filter and booster for display recommendations. Read docs